Partner API uç nokta
Anahtarlar, gruplar, istekler ve işlemler için Partner API istek ve yanıt örneğini tamamlayın.
Partner API uç nokta
Temel URL:
https://p-api.model-gate.comTüm istekler şunları gerektirir:
Authorization: Bearer mg_partner_...
Accept: application/jsonTüm parasal ve sınır değerler JSON ondalık dizeleridir. Bunları ikili kayan noktalı sayılar olarak ayrıştırmayın.
Ortak Banka entegrasyon kuralları
Tüm harici zaman damgaları UTC RFC3339'dur. Koleksiyon uç noktalarının kullanımı limit (1–100) artı bir opak cursor; imleç içeriklerini asla ayrıştırmayın veya üretmeyin. POST, PATCH, Ve DELETE istekler gerektirir Idempotency-Key; Zaman aşımlarından sonra aynı işlemi aynı tuşla yeniden deneyin. Idempotency kayıtları 7 gün boyunca saklanır. Yanıtlar şunları içerir: X-Request-ID, öyle Cache-Control: no-storeve tüm hatalar JSON'dur. Hız sınırı yanıtları HTTP'dir 429 ile Retry-After Ve X-RateLimit-* başlıklar. Bilinmeyen gövde/sorgu alanları reddedilir.
Makine tarafından okunabilen OpenAPI 3.1 sözleşmesi şu şekilde dağıtılır: resources/contracts/partner-api.openapi.yaml.
API anahtarı oluşturun
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/keys \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \
-H "Content-Type: application/json" \
-d '{
"name": "Telegram user 123",
"group_id": "GROUP_PUBLIC_ID",
"rpm_limit": 30,
"concurrency_limit": 2,
"spend_limit": "20.0000000000",
"usage_price_basis": "official_price",
"usage_price_multiplier": "0.900000"
}'Yanıt — 201
{
"data": {
"public_id": "KEY_PUBLIC_ID",
"group_id": "GROUP_PUBLIC_ID",
"name": "Telegram user 123",
"key_prefix": "mg_live_ab12",
"key": "mg_live_ab12...",
"status": "active",
"rpm_limit": 30,
"concurrency_limit": 2,
"spend_limit": "20.0000000000",
"usage": "0.0000000000",
"total_spent": "0.0000000000",
"usage_price_basis": "official_price",
"usage_price_multiplier": "0.900000",
"effective_usage_price_basis": "official_price",
"effective_usage_price_multiplier": "0.900000"
}
}Tam key değer yalnızca oluşturma veya döndürme sonrasında döndürülür.
API anahtarlarını listeleyin
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/keys \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": [
{
"public_id": "KEY_PUBLIC_ID",
"group_id": "GROUP_PUBLIC_ID",
"name": "Telegram user 123",
"status": "active",
"spend_limit": "20.0000000000",
"usage": "3.2500000000",
"total_spent": "1.1400000000"
}
]
}Liste en yenisi önce sıralanır ve opak imleç sayfalandırması kullanılır. Geçmek limit=1..100; Ne zaman meta.has_more doğrudur gönder meta.next_cursor bir sonraki olarak cursor.
Bir API anahtarı edinin
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": {
"public_id": "KEY_PUBLIC_ID",
"group_id": "GROUP_PUBLIC_ID",
"name": "Telegram user 123",
"status": "active",
"rpm_limit": 30,
"concurrency_limit": 2,
"spend_limit": "20.0000000000",
"usage": "3.2500000000",
"total_spent": "1.1400000000",
"effective_usage_price_basis": "official_price",
"effective_usage_price_multiplier": "0.900000"
}
}API anahtarını güncelleme
PATCH yalnızca desteklenen değiştirilebilir değerlerin yerini alır. Anahtarı bir gruptan kaldırmak için boş bir e-posta gönderin. group_id. Değerleme ayarlarını devralmak için şunu gönderin: null anahtar düzeyi temeli ve çarpanı için.
Rica etmek
curl -X PATCH https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated user name",
"group_id": "GROUP_PUBLIC_ID",
"rpm_limit": 60,
"concurrency_limit": 4,
"spend_limit": "40.0000000000",
"usage_price_basis": null,
"usage_price_multiplier": null
}'Yanıt — 200
{
"data": {
"public_id": "KEY_PUBLIC_ID",
"spend_limit": "40.0000000000",
"usage": "3.2500000000",
"effective_usage_price_basis": "user_price",
"effective_usage_price_multiplier": "1.000000"
}
}API anahtarını silme
Rica etmek
curl -X DELETE https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Yanıt — 200
{"data":{"deleted":true}}Bir anahtarı dondurma ve çözme
İsteği dondur
curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/freeze \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Yanıtı dondur
{"data":{"public_id":"KEY_PUBLIC_ID","status":"frozen"}}İsteği çöz
curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/unfreeze \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Yanıtı çöz
{"data":{"public_id":"KEY_PUBLIC_ID","status":"active"}}Dondurmanın çözülmesi, doğrulanmış bir sahip e-postası gerektirir.
Bir anahtarı döndür
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/rotate \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Yanıt — 200
{
"data": {
"public_id": "KEY_PUBLIC_ID",
"status": "active",
"key_prefix": "mg_live_cd34",
"key": "mg_live_cd34..."
}
}Anahtar kullanımını sıfırla
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/reset-usage \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Yanıt — 200
{
"data": {
"public_id": "KEY_PUBLIC_ID",
"usage": "0.0000000000",
"total_spent": "1.1400000000"
}
}Kullanımın sıfırlanması, ömür boyu harcamayı veya hesap bakiyesini değiştirmez.
Anahtar kullanımını alın
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/usage \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": {
"key_id": "KEY_PUBLIC_ID",
"usage": "3.2500000000",
"total_spent": "1.1400000000"
}
}Harcama limitini ve kalan kullanımı öğrenin
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/spent-limit \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": {
"key_id": "KEY_PUBLIC_ID",
"spend_limit": "20.0000000000",
"usage": "3.2500000000",
"remaining": "16.7500000000"
}
}Ne zaman spend_limit sıfırdır, sınırsızdır ve remaining öyle null.
Bir anahtara ilişkin en son istekleri alın
Ayrıntılı istek geçmişi, tarafından kontrol edilen bir etkin tutma veri kümesidir. API_REQUESTS_HOT_RETENTION_DAYS (varsayılan 7 gün). Yanıt meta verileri etkin saklama penceresini bildirir. Daha uzun vadeli mali mutabakat için bakiye işlemlerini kullanın.
limit isteğe bağlıdır, varsayılan olarak 10'dur ve 1'den 100'e kadar bir tam sayı olmalıdır. Kesinleşmiş istekler şu şekilde sıralanır: finished_at önce en yenisi. Ne zaman meta.has_more öyle true, geçmek meta.next_cursor opak olarak before Bir sonraki eski sayfayı almak için sorgu parametresi. İmleçleri kendiniz ayrıştırmayın veya oluşturmayın.
Yanıt, geçişten sonra tamamlanan istekler için değişmez kullanıcı ve resmi milyon başına jeton oranlarını içerir 059_request_pricing_audit_snapshot.sql. Ayrıca hesaplar pricing_snapshot.usage_price başka bir oran seti kaydetmeden kayıtlı esastan, çarpandan ve geçmiş oranlardan yararlanabilirsiniz. Bu, katalog fiyatları değiştikten sonra bağımsız kullanım sınırı değerlemesinin denetlenebilir olmasını sağlar. Geçiş 059 dönüşünden önce oluşturulan geçmiş istekler pricing_snapshot.available: false Mevcut fiyatları değiştirmek yerine. Claude/OpenAI uyumlu toplu API'ler aracılığıyla yürütülen istekler açıkça şu şekilde işaretlenir: request_mode: "batch" ve protokollerini, toplu iş kimliklerini ekleyin, custom_idve anlık görüntülenmiş Model Geçidi toplu fiyat çarpanı.
Gecikme, sabit İşletme/İş Ortağı adlarını kullanır: gateway_overhead_ms, upstream_first_token_ms, Ve e2e_first_token_ms. E2E ilk belirteç değeri, Model Geçidi isteği başlangıcından ilk gerçek içerik belirtecine kadar ölçülür ve istemci tarafı ağ/TLS süresini hariç tutar. Partner API yalnızca açık olanı gösterir e2e_first_token_ms isim; dahili depolama sütunu kalır api_requests.first_token_ms.
Rica etmek
curl "https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/requests?limit=10" \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": [
{
"request_id": "01KZ...",
"key_id": "KEY_PUBLIC_ID",
"group_id": "GROUP_PUBLIC_ID",
"model": "claude-opus-4.7",
"endpoint": "messages",
"method": "POST",
"status": "succeeded",
"status_code": 200,
"is_stream": false,
"request_mode": "batch",
"batch": {
"protocol": "claude",
"job_id": "msgbatch_01K...",
"custom_id": "request-1",
"price_multiplier": "0.5"
},
"tokens": {
"input": 120,
"output": 45,
"cached": 0,
"cache_write": 0,
"reasoning": 0,
"total": 165
},
"cost": "0.0000345",
"usage_cost": "0.00345",
"official_base_cost": "0.000345",
"currency": "USD",
"usage_pricing": {
"basis": "official_price",
"base_field": "official_base_cost",
"base_amount": "0.000345",
"multiplier": "10",
"usage_cost": "0.00345",
"formula": "round(base_amount * multiplier, 10)"
},
"pricing_snapshot": {
"available": true,
"unit": "per_1m_tokens",
"user_price": {
"input": "0.2",
"output": "1",
"cache_read": "0.02",
"cache_write": "0.25",
"reasoning": "1"
},
"official_price": {
"input": "1",
"output": "5",
"cache_read": "0.1",
"cache_write": "1.25",
"reasoning": "5"
},
"usage_price": {
"input": "10",
"output": "50",
"cache_read": "1",
"cache_write": "12.5",
"reasoning": "50"
}
},
"duration_ms": 842,
"gateway_overhead_ms": 34,
"upstream_first_token_ms": 156,
"e2e_first_token_ms": 190,
"settlement_status": "settled",
"started_at": "2026-08-05T10:00:00Z",
"finished_at": "2026-08-05T10:00:00.842Z"
}
],
"meta": {
"key_id": "KEY_PUBLIC_ID",
"limit": 10,
"returned": 1,
"order": "finished_at_desc",
"next_cursor": "eyJ0IjoiMjAyNi0wOC0wNSAxMDowMDowMCIsInAiOiIwMUt...",
"has_more": true
}
}Bir sonraki eski sayfaya devam etmek için:
curl "https://p-api.model-gate.com/api/v1/partner/keys/KEY_PUBLIC_ID/requests?limit=10&before=NEXT_CURSOR" \
-H "Authorization: Bearer mg_partner_..."Geçersiz before imleç HTTP'yi döndürür 422. İmleç yalnızca bitiş zamanı konumunu ve harici istek genel kimliğini içerir; dahili sayısal istek kimlikleri hiçbir zaman açığa çıkmaz.
Senkron ve yerel asenkron istekler için, request_mode öyle sync veya async ve batch nesne atlanır. Kaydedilen jeton oranı anlık görüntüsü, geçmiş temel hesaplamanın şu şekilde yeniden üretilmesine olanak tanır: sum(tokens × snapshotted_rate / 1,000,000). Ödeme, seçilen taban tutarı 10 ondalık basamağa yuvarlar ve ardından hesaplar round(base_amount × multiplier, 10). Saklanan cost, official_base_cost, Ve usage_cost alanlar yetkili kalır.
Ham istek ve yanıt gövdeleri bu uç nokta tarafından hiçbir zaman döndürülmez.
Bakiye işlemlerini listeleme
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/transactions \
-H "Authorization: Bearer mg_partner_..."Yanıt — 200
{
"data": [
{
"transaction_id": "TRANSACTION_PUBLIC_ID",
"type": "debit",
"source": "api_usage_minute",
"billing_minute_num": 29769120,
"amount": "-0.0232000000",
"request_count": 100,
"balance_before": null,
"balance_after": null,
"api_key_id": null,
"created_at": "2026-08-05T10:00:00Z"
}
]
}Faturalandırılabilir çıkarım, fatura sahibi başına bir cüzdan defteri satırı ve bitiş zamanı dakikası olarak temsil edilir. transaction_id dayanıklı kamu defteri tanımlayıcısıdır. request_count o dakika borcuna dahil edilen taleplerin sayısıdır; billing_minute_num öyle floor(unix(finished_at)/60). Ham iç defter id / source_id değerler döndürülmez. API kullanım satırlarını toplayın, kasıtlı olarak geri dönün null için balance_before, balance_after, Ve api_key_id; tam anahtar/grup/istek ayrıntılarına istek geçmişinden ve panel dakika detayına bakıldığında ulaşılabilir durumda kalır.
Mevcut bakiyeyi alın
curl https://p-api.model-gate.com/api/v1/partner/balance \
-H "Authorization: Bearer mg_partner_..."{"data":{"balance":"1234.5678900000","currency":"USD","as_of":"2026-08-28T07:00:00Z"}}Bu uç noktayı şu işlemlerden sonra kullan: account.balance_low Model API kimlik bilgisi gerektirmeden mevcut hesap cüzdanını mutabakata varmak için geri aramalar.
İş Ortağı denetim etkinliklerini listeleme
curl "https://p-api.model-gate.com/api/v1/partner/audit-events?limit=100" \
-H "Authorization: Bearer mg_partner_..."Denetim etkinlikleri, başarılı İş Ortağı yönetimi değişimlerini istek kimliği, eylem, hedef, kaynak IP'si, durum, güvenli meta veriler ve UTC zaman damgasıyla kaydeder. Gizli diziler, taşıyıcı belirteçleri, API anahtarı düz metni, önemsizlik anahtarları, istek parmak izleri ve yeniden yürütme gövdeleri denetim meta verilerinde depolanmaz. Kullanmak cursor sonraki sayfalar için ve isteğe bağlı action filtreleme.
Grup oluştur
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/groups \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \
-H "Content-Type: application/json" \
-d '{
"name": "Telegram bot A",
"description": "Keys created by bot A",
"rpm_limit": 100,
"concurrency_limit": 20,
"spend_limit": "1000.0000000000",
"usage_price_basis": "official_price",
"usage_price_multiplier": "0.900000"
}'Yanıt — 201
{
"data": {
"public_id": "GROUP_PUBLIC_ID",
"name": "Telegram bot A",
"status": "active",
"spend_limit": "1000.0000000000",
"usage": "0.0000000000",
"total_spent": "0.0000000000",
"usage_price_basis": "official_price",
"usage_price_multiplier": "0.900000"
}
}Grupları listele
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/groups \
-H "Authorization: Bearer mg_partner_..."Cevap
{"data":[{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A","status":"active","usage":"0.0000000000"}]}Grup alma veya güncelleme
İstek al
curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..."Yanıt alın
{"data":{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A","spend_limit":"1000.0000000000","usage":"12.0000000000"}}İsteği güncelle
curl -X PATCH https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \
-H "Content-Type: application/json" \
-d '{"name":"Telegram bot A production","status":"active","spend_limit":"2000.0000000000","usage_price_basis":"user_price","usage_price_multiplier":"1.200000"}'Yanıtı güncelle
{"data":{"public_id":"GROUP_PUBLIC_ID","name":"Telegram bot A production","spend_limit":"2000.0000000000","usage_price_basis":"user_price","usage_price_multiplier":"1.200000"}}Grubu silme
Boş olmayan bir grup silinmez. Önce tüm üye API anahtarlarını taşıyın veya silin; aksi takdirde API HTTP'yi döndürür 409 ile group_not_empty.
Rica etmek
curl -X DELETE https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Cevap
{"data":{"deleted":true}}Anahtarlar, veritabanının yabancı anahtar davranışına göre ayrılır. Silmeden önce üyeliği doğrulayın.
Grup kullanımını sıfırla
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/reset-usage \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Cevap
{"data":{"public_id":"GROUP_PUBLIC_ID","usage":"0.0000000000","total_spent":"8.5000000000"}}Grup üyelerini listeleyin
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members \
-H "Authorization: Bearer mg_partner_..."Cevap
{"data":[{"public_id":"KEY_PUBLIC_ID","name":"Telegram user 123","status":"active","usage":"3.2500000000","total_spent":"1.1400000000"}]}Bir gruba anahtar ekleme
Rica etmek
curl -X POST https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \
-H "Content-Type: application/json" \
-d '{"key_id":"KEY_PUBLIC_ID"}'Cevap
Yanıt, güncellenen grup üyesi listesidir:
{"data":[{"public_id":"KEY_PUBLIC_ID","name":"Telegram user 123","status":"active"}]}Bir gruptan anahtarı kaldırma
Rica etmek
curl -X DELETE https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/members/KEY_PUBLIC_ID \
-H "Authorization: Bearer mg_partner_..." \
-H "Idempotency-Key: operation-unique-001" \Cevap
{"data":{"removed":true}}Grup kullanımını alın
Rica etmek
curl https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/usage \
-H "Authorization: Bearer mg_partner_..."Cevap
{"data":{"group_id":"GROUP_PUBLIC_ID","usage":"12.0000000000","total_spent":"8.5000000000","usage_reset_at":"2026-08-01T00:00:00Z"}}Grup istatistiklerini alın
from Ve to yalnızca ile biten UTC RFC3339 zaman damgalarını kabul et Z (6 basamağa kadar kesirli saniyelere izin verilir). İstatistikler yalnızca şu şekilde anahtarlanan tamamlanmış istek toplamlarından hesaplanır: finished_at; şu anda açık olan dakika kasıtlı olarak hariç tutulmuştur, bu nedenle sonuçlar dakika toplama temposuna kadar gecikebilir.
average_duration_ms ortalama tam Model Geçidi istek süresidir (duration_ms) seçilen dönemde tamamlanan istekler genelinde. Bu, E2E ilk belirteç gecikmesi, yukarı akış ilk belirteç gecikmesi veya ağ geçidi ek yükü değildir. Partner API yalnızca bu açık metrik adını gösterir.
Rica etmek
curl "https://p-api.model-gate.com/api/v1/partner/groups/GROUP_PUBLIC_ID/stats?from=2026-08-01T00:00:00Z&to=2026-08-05T23:59:59Z" \
-H "Authorization: Bearer mg_partner_..."Cevap
{
"data": {
"group_id": "GROUP_PUBLIC_ID",
"requests": 120,
"errors": 3,
"input_tokens": 50000,
"output_tokens": 12000,
"cached_tokens": 8000,
"cache_write_tokens": 1200,
"reasoning_tokens": 2000,
"cost": "8.5000000000",
"average_duration_ms": "842.50",
"from": "2026-08-01T00:00:00Z",
"to": "2026-08-05T23:59:59Z"
}
}Eşzamansız bir sonuç alın
Rica etmek
curl https://p-api.model-gate.com/api/v1/requests/01KZ... \
-H "Authorization: Bearer mg_partner_..."Yanıt işleniyor
{
"data": {
"request_id": "01KZ...",
"status": "processing",
"created_at": "2026-08-05T10:00:00Z",
"started_at": "2026-08-05T10:00:00Z",
"completed_at": null,
"expires_at": "2026-08-06T10:00:00Z"
}
}Tamamlanan yanıt
{
"data": {
"request_id": "01KZ...",
"status": "completed",
"response_status": 200,
"response_headers": {"Content-Type":"application/json"},
"response": {"id":"resp_example","status":"completed"},
"completed_at": "2026-08-05T10:00:05Z",
"expires_at": "2026-08-06T10:00:00Z"
}
}Yaygın hatalar
Geçersiz Partner API tuşu — 401
{"error":{"type":"invalid_token","message":"Invalid Partner API key"}}Kaynak bulunamadı — 404
{"error":{"type":"not_found","message":"API key not found"}}Geçersiz istek — 422
{"error":{"type":"invalid_request","message":"limit must be an integer from 1 to 100"}}Mutasyona uğrayan Partner API JSON gövdesi 1 MiB ile sınırlıdır.
Yeterlilik çatışması — 409
Aynısı Idempotency-Key farklı bir istek için yeniden kullanıldı. Yeni bir mantıksal işlem için yeni bir anahtar oluşturun.
Oran sınırı — 429
Yanıt şunları içerir: error.code = partner_rate_limit_exceeded Ve Retry-After. Yalnızca belirtilen gecikmeden sonra yeniden deneyin.
Yönteme izin verilmiyor — 405
İş Ortağı ana bilgisayarı bir JSON hatası artı HTTP döndürüyor Allow başlık; asla bir HTML hata sayfasına geri dönmez.
İş kimlik bilgisi ana kuralları
İşletme Partner API jetonu için yalnızca doğrulanmış kuruluş sahibi kabul edilir. Partner API aracılığıyla oluşturulan anahtarlar, söz konusu sahibi hem fatura sahibi hem de kimlik bilgisi sorumlusu olarak kullanır. Çalışan-müdür ataması web panelinden yapılmaktadır. group_idsağlandığında Ticari hesabın sahip olduğu etkin bir grubu tanımlamalıdır; geçersiz değerler HTTP'yi döndürür 422 ve asla gruplanmamış bir anahtara geri dönmeyin. İstek geçmişi yanıtları şunları içerebilir: principal_user_id Kimlik bilgisi sorumlusunun fatura sahipliğinden bağımsız olarak tanımlanması.