> ## Documentation Index
> Fetch the complete documentation index at: https://api.housera.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Limite

> Limitele de rată, mărimile maxime, câte chei și webhook-uri poți avea și cât se păstrează datele.

## Limita de cereri

Fiecare cheie poate face **300 de cereri pe minut**. Limita e per cheie, nu per cont: două integrări cu chei diferite nu își consumă una alteia cota.

Fiecare răspuns îți spune unde ești:

```http theme={null}
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
```

Peste limită primești `429 Too Many Requests`, cu antetul `Retry-After`: numărul de secunde după care poți relua.

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 18

{
  "type": "https://housera.ro/problems/too_many_requests",
  "title": "Prea multe cereri. Reîncearcă după numărul de secunde din Retry-After.",
  "status": 429,
  "code": "too_many_requests",
  "detail": "Prea multe cereri. Reîncearcă după numărul de secunde din Retry-After."
}
```

<Tip>
  Nu aștepta `429`. Când `X-RateLimit-Remaining` scade spre zero, rărește cererile. Iar la `429`, respectă `Retry-After` în loc să reîncerci imediat: fiecare cerere respinsă tot contează.
</Tip>

Vocabularul (`GET /schema`) are o limită separată, de 60 de cereri pe minut per adresă IP, pentru că se cere fără cheie.

Nu există un plafon zilnic de anunțuri noi: poți publica oricât stoc ai, în ritmul limitei de mai sus. Fiecare anunț nou trece însă prin moderare.

## Mărimi

| Ce | Limită |
| - | - |
| Titlu | 10–90 de caractere |
| Descriere | 30–5.000 de caractere |
| Poze pe anunț | 100 |
| Mărimea unei poze | 20 MB |
| Rezoluția unei poze | 100 de megapixeli |
| Tipuri de poze | JPEG, PNG, WebP |
| URL de poză | 2.048 de caractere, doar HTTPS |
| Etichete de încăpere pe poză | 3 |
| Valabilitatea unui URL de upload | 15 minute |
| O cheie de upload nefolosită | se șterge după circa 24 de ore |
| `external_ref` | 1–100 de caractere: litere, cifre, `.` `_` `:` `/` `-` |
| `Idempotency-Key` | 64 de caractere, ține minte cererea 10 minute |
| `per_page` la liste | 1–100 (implicit 50) |
| `limit` la `GET /events` | 1–500 (implicit 100) |
| Tipuri de unități la un ansamblu | 50 |

## Chei și webhook-uri

| Ce | Limită |
| - | - |
| Chei API pe cont | 10 |
| Valabilitatea unei chei | 30, 90 sau 365 de zile |
| Webhook-uri pe cont | 5 |
| Timpul de răspuns al endpointului tău | 10 secunde |
| Încercări de livrare a unui eveniment | 7, pe parcursul a circa 9 ore |

## Retenție

| Ce | Cât timp |
| - | - |
| Evenimentele (`GET /events`) | 35 de zile |
| Jurnalul livrărilor de webhook | 30 de zile |
| Corpurile cererilor și răspunsurilor din jurnalul API | 30 de zile |
| Restul informațiilor din jurnalul API | 365 de zile |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.