Limite - Housera API

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:

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/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."
}

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

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