Koncové body partnerského rozhrania API

Základná adresa URL: https://panel.model-gate.com/api/v1/partner

Každú žiadosť overte pomocou Authorization: Bearer mg_partner_....

API kľúče

• 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

Kľúčové polia na vytvorenie a aktualizáciu: name, group_id, rpm_limit, concurrency_limit, spend_limit. Číselný limit 0 znamená neobmedzené. group_id je ID verejnej skupiny alebo prázdna hodnota pre žiadnu skupinu.

Kľúčové skupiny

• 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}

Polia na vytvorenie a aktualizáciu skupiny: name, description, status, rpm_limit, concurrency_limit, spend_limit. Stav je active alebo frozen.

Kľúčové a skupinové RPM, súbežnosť a limity výdavkov sa presadzujú nezávisle. Požiadavka je odmietnutá, keď ktorákoľvek úroveň prekročí svoj limit. Presun kľúča medzi skupinami neprepíše historické štatistiky: každá požiadavka uchováva snímku skupiny zachytenú v čase požiadavky.

Obnoviť používanie vymaže resetovateľné nastavenie usage okno a aktualizácie usage_reset_at; nikdy sa to nezmení total_spent.

Transakcie a asynchrónne výsledky

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

Štatistika skupiny používa súhrnné tabuľky pre dokončené obdobia a nespracované api_requests len za aktuálnu neúplnú hodinu.

Konvencia identifikátorov: každý {id} v tejto dokumentácii je zdroj public_id. Interné číselné ID databázy sa nikdy neprijímajú ani nevracajú. Vo vnorených trasách členov {keyId} je kľúč API public_id.