Partner API

Partner API este destinat băncilor, roboților, panourilor de distribuitori, sistemelor interne de furnizare și altor integrări de încredere de la server la server. Versiunea 10.5.0 este primul contract de mașină pregătit pentru bancă.

Adresa URL de bază

https://p-api.model-gate.com

Autentificare

Authorization: Bearer mg_partner_...

Fiecare răspuns este JSON, inclusiv 404, 405, 429, și 500, și include X-Request-ID. Utilizarea răspunsurilor Cache-Control: no-store; gazda partener nu folosește sesiuni PHP de browser. Toate marcajele orare externe sunt UTC RFC3339 (YYYY-MM-DDTHH:MM:SSZ).

Toate POST, PATCH, și DELETE operațiunile necesită o unică Idempotency-Key antet. Model Gate păstrează rezultatul criptat timp de 7 zile, astfel încât o reîncercare a aceleiași solicitări returnează rezultatul original fără a efectua din nou mutația. Reutilizarea aceleiași chei pentru o metodă/cale/corp diferită returnează HTTP 409.

Solicitările partenerilor sunt protejate de o limită a ratei pe minut la nivel de cont, configurată de PARTNER_API_RATE_LIMIT_PER_MINUTE (implicit 600). Răspunsurile includ X-RateLimit-Limit, X-RateLimit-Remaining, și X-RateLimit-Reset; HTTP 429 include de asemenea Retry-After.

Creați sau regenerați cheia Partner API în profilul Model Gate. Jetonul purtător complet este afișat o singură dată la generare/rotire, iar Model Gate stochează doar hash-ul SHA-256 plus un prefix de afișare. Salvați imediat jetonul în managerul dvs. secret pe partea de server; dacă este pierdut, rotiți-l.

Profilul are un separat Lista permisă IP API. Când nu este goală, cererile Partner API trebuie să provină de la o adresă IPv4/IPv6 exactă sau un prefix CIDR permis. Regulile API ale organizației comerciale se aplică în plus față de regula personală. O sursă respinsă de oricare dintre listele de permise efective primește HTTP 403 cu error.type = ip_not_allowed.

Pentru conturile de afaceri, autentificarea Partner API este disponibilă numai pentru proprietarul organizației verificate. Principalii angajați și atribuirea de acreditări delegate de afaceri sunt gestionate în panoul web, unde permisiunile de execuție de grup pot fi validate. Prin urmare, cheile de afaceri create de partener îl folosesc pe proprietar atât ca proprietar de facturare, cât și ca principal de acreditări. A furnizat group_id trebuie să numească un grup activ deținut de cont; un grup necunoscut/înghețat este respins cu HTTP 422 în loc să creeze în tăcere o cheie negrupată.

Valori zecimale

Câmpurile financiare și de utilizare sunt întotdeauna șiruri JSON:

{
  "spend_limit": "100.0000000000",
  "usage": "12.3456789000",
  "remaining": "87.6543211000",
  "usage_price_multiplier": "0.900000"
}

Utilizați aritmetică zecimală cu precizie arbitrară. Nu convertiți niciodată aceste valori în float.

Capabilități

• Creați, enumerați, actualizați, rotiți, înghețați, dezghețați și ștergeți cheile API.
• Configurați evaluarea utilizării pe cheie.
• Creați și gestionați grupuri.
• Mutați tastele între grupuri.
• Citiți cheia și utilizarea grupului.
• Citiți istoricul cererilor finalizate pentru o cheie în ordinea timpului de încheiere, cu 1-100 de pagini de rând și defalcare simbol/preț. Istoricul detaliat al cererilor este reținut la cald pentru API_REQUESTS_HOT_RETENTION_DAYS (implicit 7 zile); reconcilierea financiară pe termen lung utilizează jurnalul de tranzacții de sold.
• Citiți soldul contului curent și tranzacțiile soldului contului cu paginarea cursorului.
• Citiți evenimentele de audit ale managementului partenerilor cu paginarea cursorului.
• Sondați rezultatele inferenței asincrone.

Vedea toate Partner API puncte finale pentru exemple complete de solicitare și răspuns.

Înregistrările recente ale istoricului cererilor includ principal_user_id atunci când principalul de acreditare mai există, separat de proprietarul de facturare al companiei.

Contract care poate fi citit de mașină

Contractul OpenAPI 3.1 este livrat cu fiecare lansare ca resources/contracts/partner-api.openapi.yaml. Tratează-l împreună cu aceste Partner API pagini ca pe un contract de integrare a băncii. Câmpurile JSON necunoscute și parametrii de interogare necunoscuți sunt respinse în loc să fie ignorate în tăcere.