İş Ortağı API uç noktaları

Partner API aracılığıyla API anahtarlarını, anahtar gruplarını, limitleri, kullanımı ve istatistikleri yönetin.

İş Ortağı API uç noktaları

Temel URL: https://panel.model-gate.com/api/v1/partner

Her isteği şununla doğrulayın: Authorization: Bearer mg_partner_....

API anahtarları

  • POST /keys
  • GET /keys
  • GET /keys/{id}
  • PATCH /keys/{id}
  • DELETE /keys/{id}
  • POST /keys/{id}/freeze
  • POST /keys/{id}/unfreeze
  • POST /keys/{id}/rotate
  • POST /keys/{id}/reset-usage
  • GET /keys/{id}/usage
  • GET /keys/{id}/spent-limit

Anahtar oluşturma ve güncelleme alanları: name, group_id, rpm_limit, concurrency_limit, spend_limit. Sayısal bir sınır 0 sınırsız demektir. group_id genel grup kimliği veya hiçbir grup için boş bir değerdir.

Anahtar gruplar

  • GET /groups
  • POST /groups
  • GET /groups/{id}
  • PATCH /groups/{id}
  • DELETE /groups/{id}
  • POST /groups/{id}/reset-usage
  • GET /groups/{id}/usage
  • GET /groups/{id}/stats
  • GET /groups/{id}/members
  • POST /groups/{id}/members
  • DELETE /groups/{id}/members/{keyId}

Alanları gruplandırın ve güncelleyin: name, description, status, rpm_limit, concurrency_limit, spend_limit. Durum: active veya frozen.

Anahtar ve grup RPM'si, eşzamanlılık ve harcama sınırları bağımsız olarak uygulanır. Seviyelerden herhangi biri sınırını aştığında istek reddedilir. Bir anahtarın gruplar arasında taşınması, geçmiş istatistikleri yeniden yazmaz: her istek, grubun anlık görüntüsünün istek zamanında yakalanmasını sağlar.

Kullanımın sıfırlanması sıfırlanabilir olanları temizler usage pencere ve güncellemeler usage_reset_at; asla değişmez total_spent.

İşlemler ve eşzamansız sonuçlar

  • GET /transactions
  • GET /requests/{request_id}

Grup istatistikleri, tamamlanan dönemler ve ham dönemler için toplu tabloları kullanır api_requests yalnızca mevcut tamamlanmamış saat için.

Tanımlayıcı kuralı: her {id} bu dokümantasyonda kaynak var public_id. Dahili sayısal veritabanı kimlikleri hiçbir zaman kabul edilmez veya iade edilmez. Yuvalanmış üye rotalarında, {keyId} API anahtarıdır public_id.