Genel Bakış

Kimlik Doğrulama

posentegra API'sine erişim, hesabınıza ait bir API anahtarıyla sağlanır.

API anahtarı

Anahtarınızı Yönetim Anahtarları ekranından oluşturabilir, görüntüleyebilir ve iptal edebilirsiniz. Her anahtar hesabınıza bağlıdır ve tüm API isteklerinde kullanılır.

Bearer başlığı

Her istekte anahtarınızı Authorization başlığında Bearer öneki ile gönderin.

bash

curl https://api.v1.fastsiparis.com/web-api/v1/restaurants \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

Aşağıdaki üç başlık biçiminin tümü kabul edilir; Bearer biçimi önerilir.

Biçim	Örnek	Not
Authorization: Bearer <api-key>	Authorization: Bearer POSENTEGRA_API_KEY	Önerilen.
X-Api-Key	X-Api-Key: POSENTEGRA_API_KEY
Authorization: <api-key>	Authorization: POSENTEGRA_API_KEY

Anahtarınızı doğrulamak için aşağıdaki isteği gönderin: 200 dönerse anahtar geçerlidir, 401 dönerse geçersizdir.

cURL

bash

curl -i https://api.v1.fastsiparis.com/web-api/v1/restaurants \
  -H "Authorization: Bearer POSENTEGRA_API_KEY"

Güvenlik

Anahtarınızı istemci tarafında tutmayın

API anahtarını yalnızca sunucu tarafında saklayın. Anahtarınızın sızdığını düşünüyorsanız panelden hemen silip yenisini oluşturun.

Ayrı bir anahtar yenileme (rotasyon) ucu yoktur: anahtarı yenilemek için panelden mevcut anahtarı silin ve yenisini oluşturun.

Yetki hataları

Kod	Anlamı
401 Unauthorized	Anahtar eksik, geçersiz ya da iptal edilmiş.
403 Forbidden	Anahtar geçerli ama bu kaynağa erişim yetkisi yok.
429 Too Many Requests	İstek limitini aştınız; bir süre bekleyip tekrar deneyin.

Diğer HTTP hata kodları ve olası çözümleri için Hata Kodları sayfasına bakın.