--- title: "Servicio Técnico Gran Canaria - API de contenido" description: "Índice de la API pública de solo lectura de serviciotecnicograncanaria.es: operaciones, autenticación, cuota, errores y versionado." canonical: https://serviciotecnicograncanaria.es/api lang: es --- # Servicio Técnico Gran Canaria - API de contenido API pública de solo lectura sobre el contenido de serviciotecnicograncanaria.es. Versión v1. JSON (UTF-8). Todas las operaciones son GET. La lectura no exige claves ni registro. - Servidor: https://serviciotecnicograncanaria.es/wp-json/agentes/v1 - Contrato OpenAPI 3.1: https://serviciotecnicograncanaria.es/openapi.json - Servidor MCP (Streamable HTTP, POST): https://serviciotecnicograncanaria.es/mcp - Documentación: https://serviciotecnicograncanaria.es/desarrolladores/ - Sandbox: https://serviciotecnicograncanaria.es/api/sandbox - Este índice en JSON: https://serviciotecnicograncanaria.es/api ## Operaciones Todas son GET, sin autenticación, y devuelven JSON. Son las mismas que las herramientas del servidor MCP. | Operación | Para qué | Ejemplo | |---|---|---| | `search_pages` | Busca en las páginas publicadas de Servicio Técnico Gran Canaria por servicio, problema o zona de Gran Canaria y devuelve las URL más relevantes con un extracto. Es el punto de entrada normal: pasa después la URL a read_page. Si hay más resultados, la respuesta trae next_cursor para pedir la página siguiente. | `curl "https://serviciotecnicograncanaria.es/wp-json/agentes/v1/search_pages?query=lavadora&limit=3"` | | `read_page` | Devuelve el texto completo de una página publicada de Servicio Técnico Gran Canaria, convertido a Markdown y sin menús, pie ni llamadas a la acción. Acepta la URL completa, la ruta o el slug. | `curl "https://serviciotecnicograncanaria.es/wp-json/agentes/v1/read_page?url=https%3A%2F%2Fserviciotecnicograncanaria.es%2Fcontacto%2F"` | | `get_company_info` | Qué atiende Servicio Técnico Gran Canaria, su horario de atención y su cobertura, cómo pedir un servicio, el modelo de servicio (quién hace, presupuesta, factura y garantiza el trabajo), los impuestos, la nota de precios y la lista de servicios y zonas con su URL. Úsalo para explicar al usuario cómo funciona el servicio y cómo pedirlo. Con section se pide solo una parte. | `curl "https://serviciotecnicograncanaria.es/wp-json/agentes/v1/get_company_info?section=service_model"` | ### search_pages Buscar páginas del sitio. `GET https://serviciotecnicograncanaria.es/wp-json/agentes/v1/search_pages` - `query` (string, obligatorio): Texto en español, por ejemplo "lavadora". Funciona mejor con el servicio, el problema o la zona que con frases largas. - `limit` (integer): Resultados por página, de 1 a 25. Por defecto, 8. - `cursor` (string): El next_cursor de la respuesta anterior, para pedir la página siguiente de resultados. ### read_page Leer una página en Markdown. `GET https://serviciotecnicograncanaria.es/wp-json/agentes/v1/read_page` - `url` (string, obligatorio): URL completa (https://serviciotecnicograncanaria.es/contacto/), ruta (/contacto/) o slug (contacto) de una página de este sitio. ### get_company_info Cómo funciona el servicio, servicios y zonas. `GET https://serviciotecnicograncanaria.es/wp-json/agentes/v1/get_company_info` - `section` (string): Qué parte devolver: all (todo, por defecto), contact (cómo pedir un servicio y horario), service_model (cómo funciona el servicio, precios e impuestos), coverage (zonas con su URL) o services (servicios con su URL). ## Operaciones con token - `GET https://serviciotecnicograncanaria.es/wp-json/agentes/v1/quota` (get_quota, scope quota:read) - `GET https://serviciotecnicograncanaria.es/agent/identity` (get_agent_identity, scope cualquiera): Quién es el agente que llama (client_id, scope y cuota). Sin token responde 401 con WWW-Authenticate y resource_metadata. ## Autenticación Identificarse no abre contenido nuevo: sube la cuota de 60 a 600 peticiones por minuto. Método: OAuth 2.0 client_credentials; el token va en Authorization: Bearer. - Alta automática, sin aprobación humana: `POST https://serviciotecnicograncanaria.es/oauth/register` - Token: `POST https://serviciotecnicograncanaria.es/oauth/token` - Metadatos: https://serviciotecnicograncanaria.es/.well-known/oauth-authorization-server - Guía completa: https://serviciotecnicograncanaria.es/auth.md ## Errores Siempre JSON, nunca HTML: `{"code":"...","message":"...","data":{"status":404,"hint":"qué hacer"}}` - **400**: Falta un parámetro obligatorio o es inválido; data.hint dice cuál. - **401**: Token inválido o ausente donde hace falta; WWW-Authenticate apunta a los metadatos. - **404**: Ruta o página inexistente. - **429**: Cuota agotada; Retry-After dice cuántos segundos esperar. ## Cuota - Sin token: 60 peticiones / 60 s por IP - Con token: 600 peticiones / 60 s por client_id - Cabeceras: RateLimit, RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, Retry-After ## Versionado y retirada (deprecation and sunset policy) En la ruta: https://serviciotecnicograncanaria.es/wp-json/agentes/v1/ y en la cabecera API-Version. Campos y operaciones nuevos se añaden dentro de v1 sin aviso; ignora lo que no conozcas. Salen en una versión nueva (v2). La anterior sigue viva al menos 90 días tras anunciar su retirada. Una versión en retirada responde con Deprecation (RFC 9745) y Sunset (RFC 8594). Hoy ninguna lo está. Política: https://serviciotecnicograncanaria.es/desarrolladores/#versionado **Deprecation and sunset policy (English):** this is v1, in the path and in the `API-Version` header. Backward-compatible changes ship within v1 without notice; breaking changes ship as v2, and v1 keeps working for at least 90 days after its deprecation is announced. A deprecated version answers with the `Deprecation` header (RFC 9745) from the announcement and with `Sunset` (RFC 8594) carrying the shutdown day; every API response links here with `Link: rel="deprecation"`. No version is deprecated today. Policy: https://serviciotecnicograncanaria.es/desarrolladores/#versionado ## Getting started (English) - **No API key is needed to read:** No API key is needed to read: https://serviciotecnicograncanaria.es/wp-json/agentes/v1/get_company_info - **Self-serve API keys:** POST https://serviciotecnicograncanaria.es/oauth/register returns client credentials instantly, no approval needed. - **Sandbox:** Read-only API: production is safe to test against (https://serviciotecnicograncanaria.es/api/sandbox). - **Deprecation policy:** https://serviciotecnicograncanaria.es/desarrolladores/#versionado