Giriş
API ve yeteneklerine genel bakış
Genel Bakış
API, sistemi yönetmek ve etkileşimde bulunmak için bir dizi uç nokta sağlar. Kullanıcıların kaynak oluşturma, listeleme, güncelleme ve silme gibi çeşitli işlemleri gerçekleştirmesine olanak tanır.
Kimlik Doğrulama
API, yalnızca yetkili kullanıcıların kaynaklara erişebilmesini sağlamak için kimlik doğrulama gerektirir. Kimlik doğrulama süreci, bir API anahtarı edinmeyi ve bunu istek başlıklarında kullanmayı içerir.
Kimlik Doğrulama Süreci
API ile nasıl kimlik doğrulama yapılacağı hakkında daha fazla bilgi.
Rate Limit Sınırlandırması
API, adil kullanım ve kötüye kullanımı önlemek için rate limit uygular. Tüm uç noktaların kendi oran sınırları vardır ve bu sınırlar dakika başına istek sayısı olarak tanımlanır. Sınırı aşarsanız, 429 Too Many Requests yanıtı alırsınız.
Hata Yönetimi
API, bir isteğin başarılı olup olmadığını belirtmek için standart HTTP durum kodlarını kullanır. Yaygın durum kodları şunlardır:
200 OK: İstek başarılı oldu.201 Created: Yeni bir kaynak başarıyla oluşturuldu.400 Bad Request: İstek geçersiz veya hatalıydı.401 Unauthorized: Kimlik doğrulama başarısız oldu veya API anahtarı eksik.403 Forbidden: API anahtarının istenen kaynağa erişim izni yok.404 Not Found: İstenen kaynak bulunamadı.500 Internal Server Error: Sunucuda beklenmeyen bir hata oluştu.