Hibák és korlátok
A hiba formája
Szekció neve “A hiba formája”A hiba application/problem+json (RFC 9457), stabil code mezővel:
{ "type": "https://api.uptools.io/trustorder/problems/invalid-request", "title": "Bad Request", "status": 400, "detail": "email_hash must be 64 lowercase hex characters", "code": "INVALID_REQUEST"}A detail soha nem tartalmazza az elküldött adatot.
| Státusz | code |
Jelentés |
|---|---|---|
| 400 | INVALID_REQUEST |
hibás JSON, ismeretlen mező, rossz típus, vagy nem 64 kisbetűs hex karakteres hash |
| 401 | UNAUTHORIZED |
hiányzó, hibás, ismeretlen vagy visszavont kulcs |
| 403 | FORBIDDEN |
a fiók fel van függesztve, vagy a webshop le van tiltva |
| 404 | NOT_FOUND |
nincs ilyen visszajelzés vagy kivétel |
| 409 | INVALID_REQUEST |
érvénytelenített visszajelzés nem vonható vissza |
| 413 | PAYLOAD_TOO_LARGE |
túl nagy kérés |
| 429 | RATE_LIMITED |
túl sok kérés; várj annyit, amennyit a Retry-After mond |
| 429 | QUOTA_EXCEEDED |
elfogyott a napi ellenőrzési keret |
| 503 | INTERNAL |
átmeneti hiba nálunk |
A pénztárnál bármilyen hibánál engedd át a rendelést (hiba esetén átenged).
Korlátok
Szekció neve “Korlátok”- Kérésszám: kulcsonként másodpercenként 20 kérés, 40-es löketekkel. Fölötte a válasz
429 RATE_LIMITED,Retry-After: 1-gyel. A visszajelzés-batch 50 soronként egy egységet használ. - Napi ellenőrzés: a
POST /check-nek webshoponként és környezetenként napi kerete van, UTC-nap szerint számolva; alapból 50 000. AGET /memutatja a keretet és a mai számot. Fölötte a válasz429 QUOTA_EXCEEDED. - Kérésméret: 64 KiB, a
POST /signals/batch-nél 1 MiB. - Kulcsváltozás: a kulcs visszavonása vagy a fiók felfüggesztése 60 másodpercen belül hat.