Saltar al contenido principal

55 documentos etiquetados con "api"

Ver Todas las Etiquetas

Dominios y remitentes

Endpoints para listar, consultar y verificar dominios y remitentes programáticamente. El panel web usa endpoints privados equivalentes en…

Errores de negocio

Códigos específicos de dominio (definidos en billing-entitlement, emitidos por saascore-api e instance-api). A diferencia de 401/403, el 402 lleva cuerpo…

Errores genéricos

Códigos a nivel de status, compartidos por las tres APIs. Los code de 404 y 409 son específicos de dominio por defecto: una regla de negocio (409) siempre…

GET /v1/webhooks

Lista los webhooks de la instancia, con el estado de su última entrega. El secreto de firma no se incluye: solo se entrega al crear el webhook y al rotar su…

GET /v1/webhooks/{id}

Devuelve un webhook con el estado de su última entrega. El secreto de firma no se incluye.

Integración con IA (servidor MCP)

Fidelizador expone su operación de email como un servidor MCP (Model Context Protocol): un canal por el cual un agente de IA (por ejemplo Claude.ai / Cowork o…

Paginación y formato de respuesta

Las tres APIs (instance-api, saascore-api, services-api) responden el éxito con un contrato único: un recurso se devuelve bare (sin envoltura) y una colección…

PATCH /v1/webhooks/{id}

Edita el nombre, la URL, los tipos de evento o el estado de un webhook. Es una actualización parcial: un campo omitido conserva su valor.

POST /v1/fields

Crea un campo del catálogo de la instancia, reutilizable por cualquier formulario.

POST /v1/webhooks

Registra un endpoint que recibe los eventos de los correos de la instancia. La respuesta incluye el secreto de firma (whsec_…) con el que se firman las…

POST /v1/webhooks/{id}/rotate-secret

Genera un secreto de firma nuevo para el webhook y lo devuelve. Es la única vez que se entrega. El secreto anterior sigue firmando junto al nuevo durante 24…

POST /v1/webhooks/{id}/test

Envía a la URL del webhook un evento de prueba firmado igual que una entrega real, y devuelve el código con que respondió el endpoint y cuánto tardó. Sirve…

Referencia de la API pública

Documentación de la API pública de Fidelizador. Audiencia: desarrolladores externos que integran la plataforma (envío, consulta de estado, gestión de…

Respuestas de error

Las tres APIs (instance-api, saascore-api, services-api) responden todos los errores con el mismo formato: RFC 9457 application/problem+json. Un cliente…