Integraciones públicas

Publica ayuda en Corag desde cualquier aplicación.

Una sola API para solicitudes y ofrecimientos, más un MCP remoto para asistentes y agentes. Los registros aparecen en el mapa y el listado público.

REST API

POST /api/public/v1/help

Envía JSON, sin autenticación. Usa siempre el mismo source y externalId al reintentar: Corag no duplicará el registro.

MCP remoto

https://corag-ayuda-directa.vercel.app/mcp

Agrega esta URL como servidor MCP. Incluye las herramientas listar_emergencias, publicar_solicitud y publicar_ofrecimiento.

Antes de publicar

Identificador establesource + externalId hacen cada operación idempotente.

Contacto público autorizadopublishContact debe ser true; el nombre y WhatsApp se mostrarán para coordinar.

Ubicación verificableLas solicitudes y centros de acopio requieren coordenadas dentro de Colombia.

Ejemplo 1

Publicar una solicitud

curl -X POST https://corag-ayuda-directa.vercel.app/api/public/v1/help \
  -H "Content-Type: application/json" \
  -d '{
    "type": "request",
    "source": "mi-app",
    "externalId": "caso-1842",
    "emergencySlug": "eje-cafetero",
    "title": "Se necesitan alimentos",
    "description": "Para 12 familias",
    "category": "alimentos",
    "urgency": "urgent",
    "neededPeople": 12,
    "address": "Vereda La Esperanza",
    "latitude": 4.8133,
    "longitude": -75.6961,
    "contactName": "Ana Gómez",
    "contactWhatsapp": "+573001234567",
    "publishContact": true
  }'
Ejemplo 2

Publicar un ofrecimiento

curl -X POST https://corag-ayuda-directa.vercel.app/api/public/v1/help \
  -H "Content-Type: application/json" \
  -d '{
    "type": "offer",
    "source": "mi-app",
    "externalId": "oferta-207",
    "emergencySlug": "eje-cafetero",
    "title": "Camioneta disponible",
    "description": "Disponible durante la tarde",
    "category": "transporte",
    "contactName": "Luis Pérez",
    "contactWhatsapp": "+573101234567",
    "publishContact": true
  }'