API v1 · Business

Documentació API

L'API REST iziqrcode permet crear, gestionar i rastrejar els teus codis QR per programació.

Base URL

Tots els endpoints estan disponibles a:

https://iziqrcode.com/api/v1

Autenticació

L'API fa servir tokens Bearer. Genereu la vostra clau des de /app/api-keys i incloeu-la a la capçalera Authorization:

curl https://iziqrcode.com/api/v1/qr \
  -H "Authorization: Bearer izi_live_xxxxx..."

Format de les respostes

L'API retorna JSON a cada resposta. Codis d'estat HTTP estàndard:

2xxÈxit — la sol·licitud ha passat
4xxError de client — reviseu la sol·licitud
5xxError de servidor — torneu-ho a provar més tard

Rate limiting

3 finestres lliscants per clau / compte:

  • 60 sol·licituds / minut per clau API
  • 5.000 sol·licituds / hora per clau API
  • 5.000 sol·licituds / dia per compte

Cada resposta inclou X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Es retorna un 429 Too Many Requests amb una capçalera Retry-After quan s'assoleix el límit.

Especificació OpenAPI

Especificació llegible per màquina a /api/v1/openapi — importable a Postman / Insomnia / openapi-typescript. El visor Swagger interactiu es troba a /api-docs.

Documentació API · iziqrcode