Tovább a tartalomhoz
Dokumentáció ehhez: TrustOrder
ENuptools.io
Markdown

Hibák és korlátok

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).

  • 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. A GET /me mutatja a keretet és a mai számot. Fölötte a válasz 429 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.