API anahtarları ile kimlik doğrulama

İki fiyatlandırma endpoint'i dışında her endpoint, Authorization başlığında bir API anahtarı gerektirir.

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

Anahtar oluşturma

• Anahtarlar, konsolun API anahtarları sayfasında oluşturulur. Sayfa, ilk bakiye yüklemesi eklendikten sonra açılır.
• Bir hesap 10 aktif anahtar tutabilir. Her uygulama veya ortama kendi anahtarını ve adını verin, böylece biri diğerlerine dokunmadan değiştirilebilir.
• Bir anahtar, bsa_live_ ile başlar ve ardından 32 harf ve rakam gelir. Yalnızca oluşturulduğunda bir kez gösterilir; yalnızca anahtarlı bir hash tutarız, bu nedenle kaybolan bir anahtar tekrar gösterilemez. Bunun yerine yeni bir tane oluşturun.
• Liste, anahtarın ilk karakterlerini, son dört karakterini, ne zaman oluşturulduğunu ve son kullanıldığı zamanı gösterir.

Döndürme ve iptal etme

Bir anahtarı kesinti olmadan döndürmek için: ikinci bir anahtar oluşturun, dağıtın, konsolda son kullanım zamanını kontrol edin, ardından eski anahtarı iptal edin. İptal edilen bir anahtar, bir sonraki istekten itibaren 401 unauthorized yanıtı verir.

Anahtarları güvende tutma

• API'yi tarayıcıdan veya mobil uygulamadan değil, sunucunuzdan çağırın: anahtara sahip olan herkes bakiyenizden mesaj gönderebilir.
• Anahtarları kaynak kontrolünde değil, ortam değişkenlerinde veya bir gizli yöneticide tutun.
• Her anahtarın kendi hız sınırı sayacı vardır, bu nedenle meşgul bir çalışan, başka bir yerde kullanılan ikinci bir anahtarı yavaşlatmaz.

Hatalar

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}