API y webhooks

Las solicitudes de fotos también se crean, se activan y se siguen desde sus herramientas, con las mismas reglas que la interfaz web.

La API

API pública versionada, descrita por una especificación OpenAPI 3.1.
Claves API propias de cada espacio, con tres niveles: solo lectura, escritura y escritura de propietario, el único nivel que puede comprometer créditos.
El secreto de una clave solo se muestra una vez; se transmite en el encabezado Authorization, nunca en una URL.
Las solicitudes de modificación son idempotentes: repetir una solicitud con la misma clave de idempotencia nunca crea nada dos veces.
Límite de 600 solicitudes por minuto y por clave (ventana fija).

Eventos enviados a las direcciones https que elija: solicitud activada, cancelada o vencida, fotos enviadas, repetición enviada o vencida.
Cada mensaje va firmado (HMAC-SHA256) y lleva un identificador de evento para descartar duplicados.
En caso de fallo, hasta 9 intentos espaciados; un endpoint con fallos desde hace 72 horas se desactiva.
El secreto de firma solo se muestra una vez y puede renovarse con 24 horas de solapamiento.

Las claves API y los webhooks los gestiona el propietario del espacio, desde la interfaz web.