--- title: "API y acceso para agentes - Placas Solares Las Palmas" description: "API pública de solo lectura, servidor MCP y documentos para agentes de IA de Placas Solares Las Palmas." canonical: https://placassolareslaspalmas.es/desarrolladores/ lang: es --- # API y acceso para agentes de Placas Solares Las Palmas Placas Solares Las Palmas atiende las 24 horas, todos los días, solicitudes de instalación de placas solares en Las Palmas de Gran Canaria y el resto de Gran Canaria. Cada trabajo lo hace una empresa instaladora de Gran Canaria. Antes de empezar dice su nombre y da el presupuesto por escrito; cuando termina, factura directamente y responde de la garantía. Placas Solares Las Palmas atiende y orienta; el trabajo lo presupuesta, hace, factura y garantiza la empresa instaladora. Cada trabajo lo hace una empresa instaladora de Gran Canaria. 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 [placassolareslaspalmas.es](https://placassolareslaspalmas.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://placassolareslaspalmas.es/contacto/). ## Resumen - API REST: [https://placassolareslaspalmas.es/wp-json/agentes/v1/](https://placassolareslaspalmas.es/wp-json/agentes/v1/) (contrato: [openapi.json](https://placassolareslaspalmas.es/openapi.json), índice: [/api](https://placassolareslaspalmas.es/api), en Markdown: [/api.md](https://placassolareslaspalmas.es/api.md)) - Servidor MCP (Streamable HTTP, POST): `https://placassolareslaspalmas.es/mcp` · ficha: [server-card.json](https://placassolareslaspalmas.es/.well-known/mcp/server-card.json) - Instrucciones para agentes: [agents.md](https://placassolareslaspalmas.es/agents.md) · autenticación: [auth.md](https://placassolareslaspalmas.es/auth.md) · índice: [llms.txt](https://placassolareslaspalmas.es/llms.txt) - Cualquier página en Markdown: cabecera `Accept: text/markdown` o `.md` al final de la URL (la portada: [/index.md](https://placassolareslaspalmas.es/index.md)) - Catálogos: [api-catalog](https://placassolareslaspalmas.es/.well-known/api-catalog) (RFC 9727) · [ai-catalog.json](https://placassolareslaspalmas.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 Placas Solares Las Palmas 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://placassolareslaspalmas.es/wp-json/agentes/v1/search_pages?query=precio%20placas%20solares&limit=3"` | | `read_page` | Devuelve el texto completo de una página publicada de Placas Solares Las Palmas, 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://placassolareslaspalmas.es/wp-json/agentes/v1/read_page?url=https%3A%2F%2Fplacassolareslaspalmas.es%2Fcontacto%2F"` | | `get_company_info` | Qué atiende Placas Solares Las Palmas, 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://placassolareslaspalmas.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://placassolareslaspalmas.es/auth.md). ``` curl -X POST https://placassolareslaspalmas.es/oauth/register -H "Content-Type: application/json" -d '{"client_name":"mi-agente"}' curl -u CLIENT_ID:CLIENT_SECRET -X POST https://placassolareslaspalmas.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://placassolareslaspalmas.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://placassolareslaspalmas.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://placassolareslaspalmas.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://placassolareslaspalmas.es/oauth/register` returns a client_id and client_secret instantly, with no human approval or sales contact; exchange them at `https://placassolareslaspalmas.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://placassolareslaspalmas.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 Placas Solares Las Palmas atiende las 24 horas, todos los días. Para pedir un servicio: [página de contacto](https://placassolareslaspalmas.es/contacto/). Datos del titular: [Aviso legal](https://placassolareslaspalmas.es/aviso-legal/). [Volver a placassolareslaspalmas.es](https://placassolareslaspalmas.es/)