Skip to content

Integraciones

Desarrolladores

Muchas interfaces, una sola red de datos. El camino con más impacto no es construir otra aplicación de ayuda: es que la que construyas hable con la que ya existe.

Pantalla principal de Ayuda Directa, uno de los clientes de la API pública
Ayuda Directa es un cliente de la misma API abierta que documentamos aquí. Los datos que se ven son datos vivos.

El problema que resuelve una API abierta

En una emergencia aparecen varios equipos construyendo al tiempo, cada uno con su propia base de datos de necesidades. El resultado es más fragmentación, no menos: cinco listas incompatibles de lo mismo, ninguna completa.

Por eso la red se publica. Una aplicación nueva no tiene que empezar de cero ni pedirle a la gente que se registre otra vez: se vuelve un cliente más de la misma red de datos.

La API en tres hechos

  • Sin autenticación

    No hay llaves ni registro. Publicar una solicitud o un ofrecimiento es un POST directo, porque en una emergencia el trámite es el enemigo.

  • Idempotente por diseño

    El par source + externalId identifica cada registro. Reintentar la misma publicación no crea un duplicado, así que una integración con red inestable es segura.

  • El contacto exige consentimiento

    El teléfono se publica, y por eso publishContact debe ser explícito. No hay forma de subir un contacto sin declarar que esa persona aceptó que se muestre.

Los tres endpoints

  • GET https://ayuda.corag.app/api/public/v1/help — descubre la API y devuelve las emergencias activas con su slug. Empieza aquí.
  • POST https://ayuda.corag.app/api/public/v1/help — publica una solicitud (type: "request") o un ofrecimiento (type: "offer").
  • POST https://ayuda.corag.app/mcp — servidor MCP remoto, con las herramientas listar_emergencias, publicar_solicitud y publicar_ofrecimiento.

La especificación completa, OpenAPI 3.1, está en https://ayuda.corag.app/api/public/openapi.json.

Qué lleva una publicación

  • Obligatorio en ambos casos: source, externalId, title, category, contactName, contactWhatsapp y publishContact.
  • category es una de: alimentos, salud, refugio, transporte, acopio, rescate, otro.
  • Una solicitud añade address, latitude y longitude obligatorios, más urgency (urgent · needed · stable) y neededPeople.
  • Un ofrecimiento solo exige type; la ubicación es opcional y puede declarar collectionCenterStatus (full · needs_volunteers · needs_resources).
  • emergencySlug se vuelve obligatorio cuando hay más de una emergencia activa. Por eso conviene hacer el GET primero.

Qué vale la pena construir encima

  • Un bot de WhatsApp o Telegram que publique y consulte solicitudes.
  • Una PWA que funcione sin conexión, para zonas con mala señal.
  • Un importador desde hojas de cálculo, para organizaciones que ya trabajan así.
  • Un tablero para una alcaldía o una ONG sobre sus propios frentes.
  • Interfaces de accesibilidad: texto grande, lectura por voz, baja conectividad.
  • Detección de duplicados y verificación de calidad de los datos.

Este sitio también es abierto

Cada página de corag.app tiene un gemelo en Markdown en la misma ruta con la extensión .md, pensado para agentes y para lectura automatizada. El catálogo completo está en /llms.txt.

¿Estás construyendo algo?

La API no necesita permiso para empezar. Escríbenos si quieres contarnos qué estás haciendo o necesitas contexto sobre el modelo.

Ver la especificaciónEscríbenos