İçeriğe geç
TurnitPass
GeliştiricilerAPI v1API anahtarı al
Belgelere göz at

GeliştiricilerDoğrulama

API anahtarlarıyla doğrulama yapın

Geliştirici istekleri, TurnitPass panosundan oluşturulan API anahtarlarını kullanır.

REST API v1

Auth console

API anahtarlarını tarayıcıda tutmayın.

TurnitPass API çağrıları çalışma alanına ait bir Bearer anahtarı kullanır. Anahtar yalnızca sunucu kodunda durur; oluşturma, döndürme, iptal ve kullanımı inceleme panoda kalır.

Anahtar korumaları

Erişimi nasıl güvende tutarsınız

Yalnızca sunucu

Anahtarları backend rotalarından, worker’lardan, işlerden veya güvenli server action’lardan gönderin.

Bir kez gösterilir

Üretilen anahtarı hemen kopyalayıp secret yöneticinize kaydedin.

Güvenli döndürme

Eski production anahtarını iptal etmeden önce yedek anahtarı dağıtın.

Hesap kapsamı

Kullanım, çalışma alanının kelime bakiyesi ve faturalandırma kontrollerinde toplanır.

Bearer isteği

Header sözleşmesi

Varsayılan olarak özel
request
Bearer
fetch('https://turnitpass.com/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ text: draft, language: 'en' })
})
auth başarısız
failed auth
401
{
  "error": "Invalid or revoked API key.",
  "code": "invalid_api_key"
}
01Çalışma alanında üret
02Secret’larda sakla
03Sunucudan çağır
04Döndür veya iptal et

API anahtarları

Her istekle birlikte API anahtarınızı gönderin. Anahtarlar bir kez gösterilir ve çalışma alanından iptal edilebilir.

Authorization header
Bearer
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json

POST /api/v1/humanize
Anahtarlar oluşturulurken bir kez gösterilir ve Google hesabını değiştirmeden çalışma alanından iptal edilebilir.

Managing keys

01

Oluştur

Çalışma alanından adlı bir anahtar üretin ve hemen kopyalayın.

02

İptal et

Bir anahtarı anında devre dışı bırakın. İptal edilen anahtarlar yeni isteklerde kullanılamaz.

03

Hız limitleri

Her anahtar bağımsız olarak sınırlanabilir; kullanım hesaba toplanır.

04

Faturalandırma

Tüm anahtarlar hesabın kelime bakiyesini ve abonelik limitlerini paylaşır.

Çalışma alanına ait

Key lifecycle

1

Adlı bir anahtar oluşturun

Ortamı veya yüzeyi tanımlayan bir ad kullanın, örneğin Production backend, Staging worker veya Internal QA.

2

Bir kez kopyalayıp secret deposuna koyun

TurnitPass anahtarı yalnızca oluştururken gösterir. Dağıtım sağlayıcınıza, CI secret yöneticisine veya yerel .env dosyasına kaydedin.

3

Status ve faturalandırmayla kullanımı izleyin

Tüm anahtarlar kelime bakiyesini paylaşır; anahtar adları hangi entegrasyonun aktif olduğunu bulmayı kolaylaştırır.

4

İptal etmeden önce döndürün

Yedek anahtar oluşturun, dağıtın, trafiğin sağlıklı olduğunu doğrulayın, ardından eski anahtarı çalışma alanından iptal edin.

Environment setup

TurnitPass anahtarlarını yalnızca sunucuya özel secret olarak saklayın. Aşağıdaki örnekler Next.js, Workers, sunucu işleri veya herhangi bir backend çalışma zamanına uyacak genel adlar kullanır.

.env
server only
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Yerel geliştirme
.env.local veya yerel secret yöneticisiKüçük kelime bütçeli ve net adlı, production dışı bir anahtar kullanın.
Önizleme dağıtımları
Staging anahtarıTest işlerinin production kullanımını beklenmedik şekilde tüketmemesi için önizleme trafiğini ayırın.
Production
Yalnızca backend secret’ıAnahtarı yalnızca güvenilir sunucu kodundan okuyun. Tarayıcıya asla iletmeyin.

Security best practices

Yalnızca sunucu tarafı
Anahtarları tarayıcı kodunda açığa çıkarmayınAnahtarları backend hizmetlerinden, işlerden veya güvenli sunucu rotalarından kullanın.
Ortam değişkenleri
TURNITPASS_API_KEY kullanınCanlı anahtarları kaynak kontrolüne veya istemci paketlerine yazmayın.
Anahtarları döndürün
İptal etmeden önce yedek oluşturunProduction, staging ve geliştirme için ayrı anahtarlar kullanın.
Sızıntı yanıtı
Hemen iptal edinBir anahtar sızarsa çalışma alanından yeni bir anahtar oluşturun.

Authentication errors

Eksik header
Authorization header’ı sağlanmadı
Yanlış biçim
Header Bearer ile başlamıyor
Geçersiz anahtar
Anahtar bulunamadı, iptal edildi veya bozuk
Çok fazla hata
Tekrarlanan başarısız auth denemeleri hız sınırına takılabilir
401 response
JSON
{
  "error": "Invalid or revoked API key.",
  "code": "invalid_api_key"
}

Next steps

Ardından iş akışınıza bağlayın.Okumaya devam et