--- title: "API y acceso para agentes - Servicio Técnico Gran Canaria" description: "API pública de solo lectura, servidor MCP y documentos para agentes de IA de Servicio Técnico Gran Canaria." canonical: https://serviciotecnicograncanaria.es/desarrolladores/ lang: es --- # API y acceso para agentes de Servicio Técnico Gran Canaria Servicio Técnico Gran Canaria atiende las 24 horas, todos los días, solicitudes de servicio técnico de electrodomésticos y del hogar en Las Palmas de Gran Canaria y el resto de Gran Canaria. Cada reparación la hace un técnico independiente de Gran Canaria, que no es el servicio técnico oficial de ninguna marca. Antes de empezar dice su nombre y da el presupuesto por escrito; cuando termina, factura directamente y responde de la garantía. Servicio Técnico Gran Canaria atiende y orienta; el trabajo lo presupuesta, hace, factura y garantiza el profesional. Quién hace cada trabajo: en los aparatos, un técnico independiente; en mudanzas, una empresa de mudanzas; en plagas, una empresa de control de plagas; en el boletín eléctrico, una empresa instaladora en baja tensión; en reformas, una empresa de reformas, y en los demás oficios, un profesional de ese oficio. Cada uno presupuesta, factura y responde de su parte. Cada reparación la hace un técnico independiente de Gran Canaria, que no es el servicio técnico oficial de ninguna marca. Antes de empezar dice su nombre y da el presupuesto por escrito; cuando termina, factura directamente y responde de la garantía. El contenido de [serviciotecnicograncanaria.es](https://serviciotecnicograncanaria.es/) también se puede consultar en formato legible por máquina, **sin registro y en solo lectura**: una API REST con contrato OpenAPI 3.1, un servidor MCP para asistentes y la versión en Markdown de cada página. No sirve para reservar, contratar ni pagar: para pedir un servicio, la [página de contacto](https://serviciotecnicograncanaria.es/contacto/). ## Resumen - API REST: [https://serviciotecnicograncanaria.es/wp-json/agentes/v1/](https://serviciotecnicograncanaria.es/wp-json/agentes/v1/) (contrato: [openapi.json](https://serviciotecnicograncanaria.es/openapi.json), índice: [/api](https://serviciotecnicograncanaria.es/api), en Markdown: [/api.md](https://serviciotecnicograncanaria.es/api.md)) - Servidor MCP (Streamable HTTP, POST): `https://serviciotecnicograncanaria.es/mcp` · ficha: [server-card.json](https://serviciotecnicograncanaria.es/.well-known/mcp/server-card.json) - Instrucciones para agentes: [agents.md](https://serviciotecnicograncanaria.es/agents.md) · autenticación: [auth.md](https://serviciotecnicograncanaria.es/auth.md) · índice: [llms.txt](https://serviciotecnicograncanaria.es/llms.txt) - Cualquier página en Markdown: cabecera `Accept: text/markdown` o `.md` al final de la URL (la portada: [/index.md](https://serviciotecnicograncanaria.es/index.md)) - Catálogos: [api-catalog](https://serviciotecnicograncanaria.es/.well-known/api-catalog) (RFC 9727) · [ai-catalog.json](https://serviciotecnicograncanaria.es/.well-known/ai-catalog.json) ## 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"` | ## Autenticación y cuota Leer no exige credenciales: 60 peticiones por minuto por IP. El alta OAuth 2.0 (client_credentials, automática y sin aprobación humana) es opcional y solo sube la cuota a 600 por minuto; no abre ningún contenido nuevo. Detalles en [auth.md](https://serviciotecnicograncanaria.es/auth.md). ``` curl -X POST https://serviciotecnicograncanaria.es/oauth/register -H "Content-Type: application/json" -d '{"client_name":"mi-agente"}' curl -u CLIENT_ID:CLIENT_SECRET -X POST https://serviciotecnicograncanaria.es/oauth/token -d grant_type=client_credentials ``` Cada respuesta trae las cabeceras `RateLimit`, `RateLimit-Policy`, `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset`; un 429 añade `Retry-After`. ## Errores Siempre JSON, nunca HTML: `{"code":"...","message":"...","data":{"status":404,"hint":"qué hacer"}}`. ## Versionado y retirada (deprecation and sunset policy) Versión actual: **v1**, en la ruta (`/wp-json/agentes/v1/`) y en la cabecera `API-Version: 1` de cada respuesta. El contrato OpenAPI 3.1 está en [/openapi.json](https://serviciotecnicograncanaria.es/openapi.json). - **Cambios compatibles** (un campo nuevo, una operación nueva): se hacen dentro de v1, sin aviso previo. Un cliente debe ignorar los campos que no conozca. - **Cambios incompatibles**: salen en una versión nueva (`/wp-json/agentes/v2/`). La anterior sigue funcionando al menos 90 días después de anunciar su retirada. - **Cómo se avisa**: la versión en retirada responde con `Deprecation` (RFC 9745) desde el día del anuncio y con `Sunset` (RFC 8594) con el día exacto de apagado. Cada respuesta de la API lleva un enlace `rel="deprecation"` a este apartado. La política, en JSON: [/api/versionado](https://serviciotecnicograncanaria.es/api/versionado). **Hoy ninguna versión está en retirada**, por eso las respuestas actuales no llevan `Deprecation` ni `Sunset`: si aparecen esas cabeceras, hay que migrar. ## Pruebas No hay entorno de pruebas aparte porque no hace falta: todo es de solo lectura y probar contra producción no crea, reserva ni cobra nada ([/api/sandbox](https://serviciotecnicograncanaria.es/api/sandbox)). ## Getting started (English) - **No API key is needed to read** (60 requests per minute per IP). - **Self-serve API keys:** `POST https://serviciotecnicograncanaria.es/oauth/register` returns a client_id and client_secret instantly, with no human approval or sales contact; exchange them at `https://serviciotecnicograncanaria.es/oauth/token` (client_credentials) for 600 requests per minute. - **Sandbox:** the API is read-only, so production is safe to test against and doubles as the sandbox ([/api/sandbox](https://serviciotecnicograncanaria.es/api/sandbox)). - **Deprecation and sunset policy:** this is v1 (path and API-Version header). Breaking changes ship as v2; v1 keeps working for at least 90 days after a deprecation notice sent with the Deprecation (RFC 9745) and Sunset (RFC 8594) headers. No version is deprecated today. - **Errors:** always JSON with code, message and data.hint, never HTML. ## Cómo pedir un servicio Servicio Técnico Gran Canaria atiende las 24 horas, todos los días. Para pedir un servicio: [página de contacto](https://serviciotecnicograncanaria.es/contacto/). Datos del titular: [Aviso legal](https://serviciotecnicograncanaria.es/aviso-legal-y-condiciones-generales-de-uso/). [Volver a serviciotecnicograncanaria.es](https://serviciotecnicograncanaria.es/)