Trata sobre:
Formularios Libro de Reclamaciones
API Reference
Lo escaneable. Endpoints, auth, errores. Para snippets paso a paso ve al Quickstart.
Base URL
https://denorly.com
Auth
El {TOKEN} (UUID) en la ruta. No hay API keys ni Bearer.
Endpoints
POST
/f/{token}
Crea un envío del formulario. Acepta JSON, form-encoded y multipart según el Content-Type. → Form endpoint
GET
/libro-de-reclamaciones/{token}
Página pública del Libro de Reclamaciones. Añade ?embed=true para incrustar en iframe. → Libro embed
POST
/libro-de-reclamaciones/{token}
Registra una queja/reclamo desde el formulario público del Libro.
POST →
tu URL de webhook
Saliente. En cada envío, Denorly hace POST a tu endpoint con firma X-Denorly-Signature. → Webhooks
Respuesta de éxito
{ "success": true, "message": "Formulario enviado exitosamente", "submission_id": "<uuid>" }
Errores
{ "success": false, "error": "<mensaje>", "code": "<CODE>" }
| code | HTTP | Significado |
|---|---|---|
| LIMIT_REACHED | 402 | Límite del plan alcanzado. |
| FORM_INACTIVE | 404 | Formulario desactivado. |
| FORM_UNAVAILABLE | 404 | Formulario no disponible. |
| FORM_NOT_FOUND | 404 | Token inexistente / inactivo. |
| RECAPTCHA_FAILED | 403 | reCAPTCHA falló. |
| ORIGIN_BLOCKED | 403 | Origin fuera de la allow-list. |
| validación / otro | 400 | Datos inválidos u otro error. |
Gotcha: ramifica por code (estable), nunca por error (texto en es-PE, sujeto a cambio).
Planeado: SDK npm oficial y hostname de API dedicado (api.denorly.com). Por ahora usa el endpoint https://denorly.com/f/{token} directo.