# Hibák és korlátok

> A TrustOrder hibaválaszai (RFC 9457 problem details, stabil kóddal), a kérésszám-korlát, a napi ellenőrzési keret és a kérésméret-korlátok.

## A hiba formája

A hiba `application/problem+json` (RFC 9457), stabil `code` mezővel:

```json
{
  "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](https://docs.uptools.io/hu/trustorder/api/#hiba-esetén-átenged)).

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