Desarrolladores

API central de MANGORA

Un solo origen para el catálogo de la plataforma y para los contenidos públicos de cada empresa. Su sitio web puede ser completamente independiente y aun así consumir sus propios datos.

Base https://api.mangora.pe/v1

Cómo está pensada

Principios de la API

JSON y HTTP estándar

Verbos y códigos de estado convencionales. Respuestas siempre en application/json con codificación UTF-8.

La empresa no viaja en la URL

En los extremos autenticados el tenant sale de la credencial, nunca de un parámetro que el cliente pueda cambiar.

Versionada

El prefijo /v1 no cambia de forma incompatible. Lo que cambie de contrato vivirá en una versión nueva.

Autenticación

Extremos públicos y extremos con llave

El catálogo de la plataforma es público. Los datos de una empresa exigen una llave emitida desde su panel, con alcance acotado a esa empresa.

Llamada autenticadaHTTP

GET /v1/empresas/mi-empresa/catalogo HTTP/1.1
Host: api.mangora.pe
Authorization: Bearer mgr_live_••••••••••••••••
Accept: application/json

La llave se genera en Configuración → Integraciones y puede revocarse en cualquier momento. Nunca la incruste en código de navegador: una llave visible en el frontend es una llave comprometida.

Referencia

Extremos disponibles

Método	Ruta	Acceso	Devuelve
`GET`	`/v1/salud`	Público	Estado de la plataforma y sus dependencias.
`GET`	`/v1/modulos`	Público	Catálogo de módulos disponibles en la plataforma.
`GET`	`/v1/planes`	Público	Planes publicados con su moneda y precio.
`POST`	`/v1/contacto`	Público	Registra una solicitud de contacto comercial.
`GET`	`/v1/empresas/{slug}`	Con llave	Perfil público de la empresa de la llave.
`POST`	`/v1/archivos/url-firmada`	Con llave	URL temporal para subir un archivo a Cloudflare R2.
`POST`	`/v1/comunicaciones/email/enviar`	Con llave	Envía un correo en nombre del proyecto.
`POST`	`/v1/comunicaciones/whatsapp/enviar`	Con llave	Envía un WhatsApp en nombre del proyecto.

Ejemplo

Catálogo de módulos

Extremo público, sin credenciales. Útil para verificar conectividad.

Peticióncurl

# sin llave
curl -s https://api.mangora.pe/v1/modulos

Respuesta200 OK

{
  "total": 32,
  "modulos": [
    {
      "clave": "crm",
      "nombre": "CRM Comercial",
      "grupo": "Comercial y clientes"
    }
  ]
}

Errores

Formato uniforme

Todo fallo devuelve la misma forma, para que su cliente no necesite adivinar según el extremo.

Cuerpo del errorJSON

{
  "error": {
    "codigo": "no_encontrado",
    "mensaje": "La empresa no existe"
  }
}

Estado	Código	Cuándo
400	`solicitud_invalida`	Falta un campo o el formato no es válido
401	`no_autenticado`	Llave ausente, mal formada o revocada
404	`no_encontrado`	El recurso no existe o no es visible
429	`demasiadas_solicitudes`	Se superó el límite de peticiones
500	`error_interno`	Falla del servidor; se registra y se investiga

¿Va a integrar su sitio?

Le damos una llave de prueba y acompañamos la primera integración.

Pedir acceso