Partneru API galapunkti

Pārvaldiet API atslēgas, atslēgu grupas, ierobežojumus, lietojumu un statistiku, izmantojot partneru API.

Partneru API galapunkti

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

Autentificējiet katru pieprasījumu ar Authorization: Bearer mg_partner_....

API atslēgas

  • 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

Atslēgu izveides un atjaunināšanas lauki: name, group_id, rpm_limit, concurrency_limit, spend_limit. Skaitliskais ierobežojums 0 nozīmē neierobežots. group_id ir publisks grupas ID vai tukša vērtība nevienai grupai.

Galvenās grupas

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

Grupas izveides un atjaunināšanas lauki: name, description, status, rpm_limit, concurrency_limit, spend_limit. Statuss ir active vai frozen.

Atslēgas un grupas IPT, vienlaicīguma un tēriņu ierobežojumi tiek piemēroti neatkarīgi. Pieprasījums tiek noraidīts, ja kāds līmenis pārsniedz tā ierobežojumu. Pārvietojot taustiņu starp grupām, vēsturiskā statistika netiek pārrakstīta: katrs pieprasījums saglabā grupas momentuzņēmumu, kas tiek tverts pieprasījuma brīdī.

Atiestatīt lietojumu notīra atiestatāmo usage logs un atjauninājumi usage_reset_at; tas nekad nemainās total_spent.

Darījumi un asinhronie rezultāti

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

Grupas statistikā tiek izmantotas apkopotās tabulas par pabeigtiem un neapstrādātiem periodiem api_requests tikai par pašreizējo nepilno stundu.

Identifikatora konvencija: katrs {id} šajā dokumentācijā ir resurss public_id. Iekšējie ciparu datu bāzes ID nekad netiek pieņemti vai atgriezti. Ligzdotos dalībnieku maršrutos {keyId} ir API atslēga public_id.