Kimlik doğrulama

Kendi betikleriniz için kişisel API anahtarı kullanın. MCP istemcileri dahil, başka NinjaBuy müşterileri adına işlem yapan bir uygulama için OAuth kullanın.

OAuth 2.1Bölüm bağlantısını kopyala

PKCE S256 ile yetkilendirme kodu akışını kullanın. REST ve MCP aynı NinjaBuy OAuth erişim belirtecini kabul eder. Her belirteç, oturum açıp erişimi onaylayan hesap adına işlem yapar; istek gövdesinde başka bir hesap seçemezsiniz.

Tüm OAuth uç noktaları https://www.ninjabuy.com kökenini kullanır. Keşif ve yetkilendirme yolları:

OAuth keşfi · MCP kaynak keşfi

POST /api/auth/mcp/register
GET  /api/auth/mcp/authorize
POST /api/auth/mcp/token

1. İstemcinizi POST /api/auth/mcp/register ile kaydedin. Genel istemci, client_name, redirect_uris ve token_endpoint_auth_method: "none" içeren JSON gönderir. Dönen client_id değerini saklayın.
2. Yeni rastgele state ve PKCE code_verifier değerleri oluşturun. SHA-256 ile hesaplanıp base64url ile kodlanan code_challenge değerini türetin.
3. Kullanıcının tarayıcısında /api/auth/mcp/authorize adresini response_type=code, client_id, redirect_uri, state, code_challenge, code_challenge_method=S256 ve scope=openid offline_access ile açın.
4. Kullanıcı NinjaBuy telefon numarasıyla oturum açar ve uygulamanızı onaylar. Geri çağrı adresinizde dönen code değerini kullanmadan önce state değerini doğrulayın.
5. /api/auth/mcp/token adresine grant_type=authorization_code, code, client_id, aynı redirect_uri ve code_verifier değerleriyle form kodlamalı POST gönderin.

Elde edilen erişim belirtecini REST isteklerinde gönderin:

Authorization: Bearer YOUR_ACCESS_TOKEN

Erişim belirteçleri 1 saat geçerlidir. offline_access ile yenileme belirteçleri 7 güne kadar yenilemeye izin verir. Aynı belirteç uç noktasına grant_type=refresh_token, client_id ve refresh_token içeren form kodlamalı POST göndererek yenileyin. Belirteçleri güvenli saklayın; yenileme artık geçerli olmadığında yeniden oturum açın.

Eksik, süresi dolmuş veya geçersiz bir erişim belirteci, WWW-Authenticate keşif sorgusuyla birlikte 401 döndürür. Hatalar sayfasına bakın.