Documentación API

Endpoints REST, OpenAPI 3.1 y un servidor MCP Lite. Todo consumible por humanos, LLMs y agentes.

Endpoints

• GET/api/public/v1/entitiesList all entities
• GET/api/public/v1/entities/:idGet one entity with JSON-LD
• GET/api/public/v1/search?q=&type=&city=Ranked search
• GET/api/public/v1/openapi.jsonOpenAPI 3.1 spec
• POST/api/public/mcpMCP Lite JSON-RPC endpoint
• GET/llms.txtAI discovery manifest
• GET/sitemap.xmlSitemap for crawlers

Ejemplo de petición

curl -s https://valpp.io/api/public/v1/search?q=veterinario&city=Madrid \
  -H "Accept: application/json"

# Response
{
  "results": [
    {
      "entity": { "id": "…", "name": "…", "type": "veterinarian", "city": "Madrid" },
      "score": 0.87,
      "distance_km": null,
      "available": null
    }
  ],
  "total": 3
}