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 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.

Resumen

API REST: https://serviciotecnicograncanaria.es/wp-json/agentes/v1/ (contrato: openapi.json, índice: /api, en Markdown: /api.md)
Servidor MCP (Streamable HTTP, POST): https://serviciotecnicograncanaria.es/mcp · ficha: server-card.json
Instrucciones para agentes: agents.md · autenticación: auth.md · índice: llms.txt
Cualquier página en Markdown: cabecera Accept: text/markdown o .md al final de la URL (la portada: /index.md)
Catálogos: api-catalog (RFC 9727) · 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.

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.

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.

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).

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).
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. Datos del titular: Aviso legal.

Volver a serviciotecnicograncanaria.es