API anahtarları
Kendi betiklerinizden REST API çağrıları yapmak için kişisel API anahtarı kullanın.
Anahtar oluşturma ve iptal etme
NinjaBuy hesabınızda oturum açın ve adlandırılmış anahtarları oluşturmak, listelemek ve iptal etmek için Hesap → Davetler → API anahtarları bölümünü açın. Tam anahtar nb_ ile başlar ve yalnızca bir kez gösterilir. Mesajı kapatmadan önce Anahtarı kopyala ile güvenli bir yere kaydedin.
Bir anahtarın süresi, oluştururken bir geçerlilik süresi seçmediğiniz sürece dolmaz: 30 gün, 90 gün veya 1 yıl. İptal ya da bu sürenin sonu bir sonraki istekte geçerli olur ve süresi dolan anahtar listeden kaybolur.
Anahtarın yalnızca SHA-256 özeti saklanır.
Anahtar kullanma
Anahtarınızı betiğinize NINJABUY_API_KEY olarak aktarın ve Authorization başlığında gönderin:
curl -sS https://www.ninjabuy.com/api/v1/links \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "Content-Type: application/json" \
--data '{"links":["https://weidian.com/item.html?itemID=7581746714"]}'Aynı başlık, kimlik doğrulama gerektiren tüm REST yollarında çalışır: Bağlantılar, Arama, yüklemeler ve E-tablolar ile İşler. OpenAPI belgesi kimlik doğrulama gerektirmez.
İzinler ve sınırlar
Her anahtara üç iznin tamamı verilir. Kapsam seçimi yoktur.
| İzin | Yollar |
|---|---|
links:create | POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets |
jobs:read | GET /api/v1/jobs/{id} |
search:read | GET /api/v1/search |
Anahtarlar ve OAuth REST istekleri, hesabın oluşturma ve arama pencerelerini paylaşır. MCP ile bağlantı oluşturma da oluşturma penceresini paylaşır. Hız sınırları sayfasına bakın.
Anahtar; oturum açamaz, oturum başlatamaz, MCP veya hesap API’lerini çağıramaz. Başka NinjaBuy müşterileri adına işlem yapan bir uygulama veya MCP istemcisi için OAuth kullanın.
Hatalar
Geçersiz, süresi dolmuş veya iptal edilmiş bir anahtar, geçersiz OAuth belirteciyle aynı 401 problemini döndürür. Anahtar depolamasındaki kesinti, Retry-After ile 503 döndürür. Hatalar sayfasına bakın.