API para integradores
Conectá YoMeSumo con tus propias herramientas: consultá el mercado, publicá a tu nombre y recibí eventos por webhook.
Autenticación y permisos
Las claves se crean desde tu panel de integraciones. La clave completa se muestra una sola vez. Enviá siempre la cabecera X-Api-Key en cada pedido. Dos endpoints no piden clave: /api/v1/categories y /api/v1/stats.
- LecturaConsultar publicaciones, misiones y métricas.
- EscrituraCrear publicaciones a tu nombre.
- WebhooksRecibir eventos firmados en tu servidor.
curl https://yomesumo.appspesic.cl/api/v1/publications?category=software \
-H "X-Api-Key: yms_tu_clave"Endpoints de la API v1
| Método | Ruta | Permiso | Qué hace |
|---|---|---|---|
| GET | /api/v1/publications | read | Buscar publicaciones con los mismos filtros de la web. |
| GET | /api/v1/publications/:id | read | Detalle de una publicación. |
| POST | /api/v1/publications | write | Crear una publicación a nombre del dueño de la clave. |
| GET | /api/v1/categories | público | Categorías y subcategorías vigentes (no requiere clave). |
| GET | /api/v1/missions | read | Misiones abiertas con recompensa. |
| GET | /api/v1/stats | público | Métricas públicas: activas por categoría, recompensas y cierres (no requiere clave). |
| GET | /api/v1/me | read | Dueño de la clave, permisos y cuota disponible. |
Especificación OpenAPI 3.1 disponible: «YoMeSumo API» v1.0.0, 42 rutas publicadas.
Webhooks firmados
Cada evento llega por POST JSON con el cuerpo {event, occurred_at, data} y la cabecera X-YoMeSumo-Signature: sha256=HMAC(secret, body). Verificá la firma en tu servidor antes de procesar el evento.
publication.createdPublicación creadamission.appliedPostulación a misióndeal.closedNegocio cerrado
Si tu servidor no responde 2xx, reintentamos 3 veces: a 1 minuto, 10 minutos y 1 hora. El último estado queda visible en tu panel de integraciones.
Límites y errores
Cada clave puede hacer hasta 120 pedidos por minuto. El cupo restante viene en la cabecera X-RateLimit-Remaining.
- 401
CLAVE_INVALIDALa clave no existe, fue revocada o falta la cabecera X-Api-Key. - 403
SCOPE_INSUFICIENTELa clave no tiene el permiso que pide el endpoint. - 429
LIMITE_EXCEDIDOSuperaste 120 pedidos por minuto. Esperá y reintentá.
¿Necesitás ayuda con una integración? Creá tu clave y probá primero en el entorno de pruebas antes de pasar a producción.