41 lines
1.1 KiB
Markdown
41 lines
1.1 KiB
Markdown
# API de la app principal Reformix
|
|
|
|
## Responsabilidad
|
|
Entregar los renders generados al endpoint /ingesta de la app Reformix.
|
|
|
|
## Endpoint
|
|
POST {REFORMIX_API_URL}/api/leads/{leadId}/ingesta
|
|
Authorization: Bearer {FUNNEL_API_KEY}
|
|
Content-Type: application/json
|
|
|
|
## Body
|
|
{
|
|
"items": [
|
|
{
|
|
"tipo": "foto",
|
|
"zona": "cocina", // zona que se procesó
|
|
"momento": "despues", // siempre "despues" para renders generados
|
|
"imagen": "data:image/png;base64,..."
|
|
}
|
|
// un item por cada zona procesada
|
|
],
|
|
"finalizar": true // siempre true, dispara PDF + email + WhatsApp
|
|
}
|
|
|
|
## Enums válidos (no usar otros valores)
|
|
tipo item: "foto" | "texto"
|
|
momento: "antes" | "despues"
|
|
zona: "cocina" | "bano" | "salon" | "comedor" | "integral" | "otro"
|
|
|
|
## Códigos de respuesta
|
|
200 { ok: true } → éxito
|
|
401 → FUNNEL_API_KEY incorrecta
|
|
404 → leadId no existe, no reintentar
|
|
422 → payload mal formado, revisar el body
|
|
|
|
## Reintentos
|
|
En caso de error 5xx o error de red:
|
|
→ reintentar 3 veces con 2 segundos de espera entre intentos
|
|
→ si sigue fallando, loguear como error crítico con el leadId
|
|
→ nunca reintentar en caso de 404
|