La API de Qbox para softwares de trasteros

Empieza en tres pasos

1. 1

   Pide tus credenciales

   Al aceptar tu petición, las de pruebas. Con ellas, el token de tu software:

   curlCopiar

   curl -X POST https://api.findqbox.com/connect/oauth/token \
     -d grant_type=client_credentials \
     -d client_id=$CLIENT_ID \
     -d client_secret=$CLIENT_SECRET

2. 2

   Manda un centro

   Con el permiso de la gestora, su dirección completa, su punto y su horario:

   curlCopiar

   curl -X PUT https://api.findqbox.com/connect/v1/facilities/madrid-01 \
     -H "Authorization: Bearer $TOKEN" \
     -d @centro.json

3. 3

   Recibe los avisos

   Comprueba la firma de cada uno antes de usarlo:

   jsCopiar

   // Qbox-Signature: t=1782456000,v1=5f3a…
   const ok = hmacSha256(secret, `${t}.${rawBody}`) === v1
     && Date.now() / 1000 - t < 300;

Guías

• IntroducciónQué hace la API, lo común a todas sus operaciones y los primeros pasos.
• El entorno de pruebasCredenciales de pruebas, tu «Gestora de pruebas» y lo que puedes probar sin publicar nada.
• El permiso de la gestoraOAuth 2.0 con código de autorización y PKCE, desde Qbox.
• Publica tus centrosLos datos de cada centro, lo que comprobamos, la revisión y la lista de cada día.
• Tamaños, precios y trasterosLos tamaños del centro, el estado y el precio de cada trastero, y cada cambio al momento.
• El plano y las fotosEl SVG de cada planta, con el id de cada trastero, y las fotos del centro.
• Las solicitudesLas solicitudes de información y de lista de espera de los centros, en tu software.
• Los avisosQué llega, cómo se comprueba su firma y los reintentos.
• Alquiler onlineEl nivel 2: el cliente alquila en el portal y paga en la pasarela de la gestora, con lo que decide tu software.
• Errores y límitesCada error con su código, repetir sin duplicar y qué hacer con un 429.
• La certificaciónLas pruebas automáticas y la revisión de un centro de verdad, antes de producción.
• VersionesLo que cambia en cada versión y cómo avisamos.