Documentación para desarrolladores
Consulta licitaciones y recomendaciones desde tu servidor con una API v1 estable, documentada y lista para probar.
Para hacer llamadas necesitas una clave, permisos y un plan Pro, Team o AAPP.
01 · Primera llamada
Guarda la clave en una variable de entorno y envíala en x-api-key. Este ejemplo solo consulta datos. El identificador y la respuesta son ilustrativos.
# Nunca pongas la clave en el navegador
curl https://api.licitaia.org/api/v1/licitaciones \
-H "x-api-key: $LICITAIA_API_KEY"const response = await fetch(
'https://api.licitaia.org/api/v1/licitaciones',
{ headers: { 'x-api-key': process.env.LICITAIA_API_KEY } },
);
if (!response.ok) throw new Error(`API ${response.status}`);
const data = await response.json();Ejecuta esta llamada en backend para que la clave no llegue al navegador.
{
"data": [{
"id": "00000000-0000-4000-8000-000000000001",
"title": "Servicio de mantenimiento",
"presupuestoBase": 12000
}]
}Extracto ilustrativo: los ejemplos oficiales usan datos sintéticos y siguen el contrato OpenAPI.
02 · Fuente única
Swagger UI permite explorar grupos, esquemas, autenticación y Try it out. El JSON y el Markdown se generan del mismo documento que la interfaz, para que una integración humana y un agente de programación vean el mismo contrato.
03 · Acceso
Crea y gestiona claves desde Equipo · API. El secreto se muestra una sola vez. Crear, rotar y revocar requiere ser owner o admin de la organización; consultar consumo está disponible para sus miembros.
La documentación no requiere login. El uso de la API sí requiere clave válida, permisos y un plan compatible; el plan Free no tiene acceso.
04 · Antes de automatizar
Las rutas GET de licitaciones, recomendaciones, análisis y veredictos son de lectura. POST /api/v1/licitaciones/{id}/veredicto recalcula de forma determinista y no consume créditos. POST /api/v1/analisis puede iniciar un análisis y cobrar 2 créditos; si la API puede reutilizar un análisis existente, no lanza otro trabajo. Revisa la respuesta antes de automatizar costes.