Kimlik Doğrulama

Anahtarı, form-kodlu istek gövdesindeki key alanı olarak geçirin. Header tabanlı kimlik doğrulama desteklenmez — v2 spesifikasyonu, mevcut bayi SDK'larıyla uyumluluk için gövde parametreleri kullanır.

Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=services

Form alanlarıyla (application/x-www-form-urlencoded) veya aynı düz adlara sahip bir JSON nesnesiyle POST gönderin. Gövde en fazla 32 KB olabilir. Bilinmeyen parametreler yok sayılır ve boş değer yok kabul edilir. Diğer tüm yöntemler METHOD_NOT_ALLOWED ile reddedilir.

Anahtar, hesap ve API anahtarı her çağrıda yeniden denetlenir; bu yüzden askıya alınmış bir hesap veya iptal edilmiş bir anahtar anında çalışmayı bırakır. Hesap etkin olmalı ve e-posta adresi doğrulanmış olmalıdır.

• 401

  INVALID_KEY

  Invalid API key

  Anahtar eksik, yanlış veya iptal edilmiş. Önce isteği düzeltin.

• 403

  INACTIVE_ACCOUNT

  Account suspended

  Hesap askıya alınmış. Önce isteği düzeltin.

• 403

  EMAIL_UNVERIFIED

  Email verification required

  Hesabın e-posta adresi henüz doğrulanmadı. Önce isteği düzeltin.

• 503

  API_DISABLED

  The API is temporarily disabled

  API kısa süreliğine kapalı. Retry-After ne zaman yeniden deneyeceğinizi söyler. Yeniden denemek işe yarayabilir.

• 405

  METHOD_NOT_ALLOWED

  Use POST

  İstek bir POST değildi. Önce isteği düzeltin.

• 413

  BODY_TOO_LARGE

  Request body too large

  İstek gövdesi çok büyük. Önce isteği düzeltin.

key=YOUR_API_KEY&action=balance

{
  "error": "Invalid API key",
  "error_code": "INVALID_KEY",
  "retryable": false
}

Anahtarlar /dashboard/api üzerinden oluşturulur ve iptal edilir. Ham anahtar tam bir kez gösterilir. Sunucu tek yönlü doğrulayıcı ve gizli olmayan kısa bir tanımlayıcı tutar; ham değer sonradan kurtarılamaz.

1. 1

   Hesap başına en fazla 5 etkin anahtar. Eski anahtarlar tek tek iptal edilebilir.

2. 2

   Kesinti olmadan değiştirin.

   Yedek anahtar oluşturun, entegrasyonunuzu güncelleyin, sonra eski anahtarı iptal edin. İptal edilen anahtarlar yeni isteklerde reddedilir.
3. 3

   Etkin pano oturumu gerekir.

   Oluşturma, kimliği doğrulanmış ve kimliğe bürünülmemiş pano oturumu gerektirir. Ek e-posta kodu veya parola istemi eklemez.

v3 API anahtarı yalnızca belgelenmiş işlemlerle sınırlıdır; oturum açılmış panel oturumuna veya başka hesapların verilerine erişemez.

• Bakiye çekme veya transfer etme.
• Hesap e-postasını, parolasını veya 2FA ayarlarını değiştirme.
• API üzerinden başka API anahtarları oluşturma veya iptal etme.
• Yönetici veya moderasyon uç noktalarına erişme.