{
    "openapi": "3.1.0",
    "info": {
        "title": "Prime Services - API de contenido",
        "summary": "Consulta de solo lectura del contenido publicado de primeservices.es.",
        "description": "API pública y sin autenticación sobre el contenido de Prime Services, marca de Rapid Services Enterprise, S.L. Prime Services recibe avisos de reparación y mantenimiento a domicilio y los asigna a un profesional colaborador de la zona, que presupuesta antes de empezar, hace el trabajo, lo factura al cliente y responde de su garantía; la empresa no ejecuta los trabajos. Ámbito nacional, en toda España, organizado por ubicaciones. Ubicaciones con servicio publicado: Tenerife, Las Palmas, Bilbao, Mallorca, Murcia, Zaragoza, Madrid, Barcelona, Málaga, Alicante, Valencia, Sevilla, Valladolid, Córdoba, Vigo, Gijón, A Coruña, Elche, Granada, Oviedo y Pamplona. En Canarias cada ubicación es una provincia entera: Tenerife abarca Tenerife, La Palma, La Gomera y El Hierro; Las Palmas abarca Gran Canaria, Lanzarote y Fuerteventura. Impuesto: IVA en la península y en Baleares, IGIC en Canarias.\n\nSirve para: localizar la página que trata un síntoma o un oficio (buscar_contenido, con el texto en el parámetro consulta), leer su texto en Markdown, listar el catálogo por ubicación y obtener los datos fiscales, de cobertura y el modelo de servicio de la empresa.\n\nEjemplo: GET https://primeservices.es/wp-json/ps/v1/buscar_contenido?consulta=nevera+no+enfria\n\nFiltro geográfico: parámetro ubicacion, con el slug de la ubicación (el sufijo de las URLs) o todas. El parámetro provincia se acepta como alias por compatibilidad.\n\nNO sirve para reservar, contratar ni pagar: no hay ninguna operación de escritura y el sitio no vende en línea. El aviso se da por teléfono o correo.\n\nAutenticación: opcional. Todas las operaciones de contenido responden igual sin token. Registrarse (POST https://primeservices.es/oauth/register, automático y gratuito) sube la cuota de 60 a 600 peticiones por minuto y da acceso a /estado. Un token no abre contenido que no estuviera ya abierto.\n\nCuota: cada respuesta trae RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit y RateLimit-Policy; un 429 añade Retry-After.\n\nEmpezar: es gratis, la lectura funciona sin claves, las claves son de autoservicio (POST https://primeservices.es/oauth/register, sin aprobación humana ni ventas) y no hay sandbox aparte porque la API es de solo lectura: producción es inocua de probar (comprobación en vivo: https://primeservices.es/api/sandbox).\n\nVersionado y retirada (deprecation and sunset policy): esta es la v1, en la ruta y en la cabecera API-Version. Los cambios compatibles entran en v1 sin aviso; los incompatibles salen como v2 y v1 sigue viva al menos 90 días tras anunciar su retirada, con las cabeceras Deprecation (RFC 9745) y Sunset (RFC 8594). Política: https://primeservices.es/desarrolladores/#versionado\n\nLas mismas operaciones de contenido están disponibles como herramientas MCP en POST https://primeservices.es/mcp.",
        "version": "1.0.0",
        "contact": {
            "name": "Prime Services",
            "url": "https://primeservices.es/contacto/"
        },
        "x-api-lifecycle": {
            "version": "v1",
            "deprecation_policy": "https://primeservices.es/desarrolladores/#versionado",
            "minimum_notice_days": 90,
            "signals": [
                "Deprecation (RFC 9745)",
                "Sunset (RFC 8594)",
                "Link rel=deprecation"
            ],
            "deprecated_versions": []
        },
        "x-sandbox": {
            "url": "https://primeservices.es/api/sandbox",
            "required": false,
            "note": "Read-only API: production is safe to test against. No separate environment is needed."
        },
        "license": {
            "name": "Content-Signal: ai-train=yes, search=yes, ai-input=yes",
            "url": "https://primeservices.es/robots.txt"
        }
    },
    "servers": [
        {
            "url": "https://primeservices.es/wp-json/ps/v1",
            "description": "Produccion"
        }
    ],
    "externalDocs": {
        "description": "Documentación para desarrolladores y agentes",
        "url": "https://primeservices.es/desarrolladores/"
    },
    "tags": [
        {
            "name": "contenido",
            "description": "Lectura del contenido publicado: búsqueda, páginas, catálogo y datos de la empresa. No exige token."
        },
        {
            "name": "cuenta",
            "description": "Estado del cliente identificado. Exige token."
        }
    ],
    "security": [
        {},
        {
            "oauth2": [
                "contenido:leer"
            ]
        }
    ],
    "paths": {
        "/buscar_contenido": {
            "get": {
                "operationId": "buscar_contenido",
                "summary": "Buscar por síntoma o servicio",
                "description": "Busca en las páginas publicadas por síntoma, aparato, oficio o municipio y devuelve las URLs más relevantes con un extracto. Es el punto de entrada normal: pasa después la URL a leer_pagina. En la API REST, el texto va en el parámetro consulta (?consulta=...).",
                "tags": [
                    "contenido"
                ],
                "parameters": [
                    {
                        "name": "consulta",
                        "in": "query",
                        "required": true,
                        "description": "Texto en español. Funciona mejor con el síntoma que con el nombre comercial: \"nevera no enfría\", \"lavadora no centrifuga\", \"termo sin agua caliente\", \"cerrajero Arona\".",
                        "schema": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 200
                        }
                    },
                    {
                        "name": "ubicacion",
                        "in": "query",
                        "required": false,
                        "description": "Ubicación por su slug, que es el sufijo de las URLs: \"tenerife\" (provincia de Santa Cruz de Tenerife), \"las-palmas\" (provincia de Las Palmas), \"madrid\", \"a-coruna\"... \"todas\" para no filtrar. Por defecto, todas.",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "tenerife",
                                "las-palmas",
                                "bilbao",
                                "mallorca",
                                "murcia",
                                "zaragoza",
                                "madrid",
                                "barcelona",
                                "malaga",
                                "alicante",
                                "valencia",
                                "sevilla",
                                "valladolid",
                                "cordoba",
                                "vigo",
                                "gijon",
                                "a-coruna",
                                "elche",
                                "granada",
                                "oviedo",
                                "pamplona",
                                "todas"
                            ]
                        }
                    },
                    {
                        "name": "provincia",
                        "in": "query",
                        "required": false,
                        "description": "Alias antiguo de \"ubicacion\", que se mantiene por compatibilidad. Acepta los mismos slugs; \"ambas\" equivale a \"todas\". Si llegan los dos, manda \"ubicacion\".",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "tenerife",
                                "las-palmas",
                                "bilbao",
                                "mallorca",
                                "murcia",
                                "zaragoza",
                                "madrid",
                                "barcelona",
                                "malaga",
                                "alicante",
                                "valencia",
                                "sevilla",
                                "valladolid",
                                "cordoba",
                                "vigo",
                                "gijon",
                                "a-coruna",
                                "elche",
                                "granada",
                                "oviedo",
                                "pamplona",
                                "ambas",
                                "todas"
                            ]
                        }
                    },
                    {
                        "name": "limite",
                        "in": "query",
                        "required": false,
                        "description": "Número máximo de resultados, de 1 a 25. Por defecto, 8.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 25
                        }
                    }
                ],
                "security": [
                    {},
                    {
                        "oauth2": [
                            "contenido:leer"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Resultado de la operación.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "total": {
                                            "type": "integer"
                                        },
                                        "resultados": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "titulo": {
                                                        "type": "string"
                                                    },
                                                    "url": {
                                                        "type": "string"
                                                    },
                                                    "tipo": {
                                                        "type": "string"
                                                    },
                                                    "ubicacion": {
                                                        "type": "string",
                                                        "description": "Slug de la ubicación de la página. Cadena vacía si no es de ninguna (portada, páginas legales, contacto)."
                                                    },
                                                    "provincia": {
                                                        "type": "string",
                                                        "description": "El mismo valor que \"ubicacion\". Se mantiene por compatibilidad."
                                                    },
                                                    "extracto": {
                                                        "type": "string"
                                                    }
                                                },
                                                "required": [
                                                    "titulo",
                                                    "url",
                                                    "tipo",
                                                    "ubicacion",
                                                    "provincia",
                                                    "extracto"
                                                ]
                                            }
                                        }
                                    },
                                    "required": [
                                        "total",
                                        "resultados"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Parámetros inválidos.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Se ha mandado un bearer token que no vale o ha caducado. Sin token, la operación responde 200.",
                        "headers": {
                            "WWW-Authenticate": {
                                "description": "Lleva resource_metadata con la URL de los metadatos del recurso (RFC 9728).",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Operación o recurso inexistente.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Cuota agotada. Espera lo que diga Retry-After.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            },
                            "Retry-After": {
                                "description": "Segundos que hay que esperar antes de volver a intentarlo.",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leer_pagina": {
            "get": {
                "operationId": "leer_pagina",
                "summary": "Leer una página en Markdown",
                "description": "Devuelve el texto completo de una página publicada, convertido a Markdown y sin menús ni pie. Acepta la URL completa, la ruta o el slug.",
                "tags": [
                    "contenido"
                ],
                "parameters": [
                    {
                        "name": "url",
                        "in": "query",
                        "required": true,
                        "description": "URL completa (https://primeservices.es/fontaneros-tenerife/), ruta (/fontaneros-tenerife/) o slug (fontaneros-tenerife).",
                        "schema": {
                            "type": "string",
                            "maxLength": 300
                        }
                    }
                ],
                "security": [
                    {},
                    {
                        "oauth2": [
                            "contenido:leer"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Resultado de la operación.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "titulo": {
                                            "type": "string"
                                        },
                                        "url": {
                                            "type": "string"
                                        },
                                        "markdown": {
                                            "type": "string"
                                        },
                                        "truncado": {
                                            "type": "boolean"
                                        }
                                    },
                                    "required": [
                                        "titulo",
                                        "url",
                                        "markdown",
                                        "truncado"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Parámetros inválidos.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Se ha mandado un bearer token que no vale o ha caducado. Sin token, la operación responde 200.",
                        "headers": {
                            "WWW-Authenticate": {
                                "description": "Lleva resource_metadata con la URL de los metadatos del recurso (RFC 9728).",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Operación o recurso inexistente.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Cuota agotada. Espera lo que diga Retry-After.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            },
                            "Retry-After": {
                                "description": "Segundos que hay que esperar antes de volver a intentarlo.",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/listar_servicios": {
            "get": {
                "operationId": "listar_servicios",
                "summary": "Listar servicios publicados",
                "description": "Devuelve el catálogo completo de páginas publicadas: los oficios por ubicación y el servicio técnico por tipo de aparato. Útil para saber qué cubre el servicio antes de buscar.",
                "tags": [
                    "contenido"
                ],
                "parameters": [
                    {
                        "name": "ubicacion",
                        "in": "query",
                        "required": false,
                        "description": "Ubicación por su slug, que es el sufijo de las URLs: \"tenerife\" (provincia de Santa Cruz de Tenerife), \"las-palmas\" (provincia de Las Palmas), \"madrid\", \"a-coruna\"... \"todas\" para no filtrar. Por defecto, todas.",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "tenerife",
                                "las-palmas",
                                "bilbao",
                                "mallorca",
                                "murcia",
                                "zaragoza",
                                "madrid",
                                "barcelona",
                                "malaga",
                                "alicante",
                                "valencia",
                                "sevilla",
                                "valladolid",
                                "cordoba",
                                "vigo",
                                "gijon",
                                "a-coruna",
                                "elche",
                                "granada",
                                "oviedo",
                                "pamplona",
                                "todas"
                            ]
                        }
                    },
                    {
                        "name": "provincia",
                        "in": "query",
                        "required": false,
                        "description": "Alias antiguo de \"ubicacion\", que se mantiene por compatibilidad. Acepta los mismos slugs; \"ambas\" equivale a \"todas\". Si llegan los dos, manda \"ubicacion\".",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "tenerife",
                                "las-palmas",
                                "bilbao",
                                "mallorca",
                                "murcia",
                                "zaragoza",
                                "madrid",
                                "barcelona",
                                "malaga",
                                "alicante",
                                "valencia",
                                "sevilla",
                                "valladolid",
                                "cordoba",
                                "vigo",
                                "gijon",
                                "a-coruna",
                                "elche",
                                "granada",
                                "oviedo",
                                "pamplona",
                                "ambas",
                                "todas"
                            ]
                        }
                    },
                    {
                        "name": "tipo",
                        "in": "query",
                        "required": false,
                        "description": "\"oficio\" para electricistas, fontaneros, cerrajeros y demás; \"aparato\" para el servicio técnico de electrodomésticos; \"todos\" para el catálogo entero. Por defecto, todos.",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "oficio",
                                "aparato",
                                "todos"
                            ]
                        }
                    }
                ],
                "security": [
                    {},
                    {
                        "oauth2": [
                            "contenido:leer"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Resultado de la operación.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "total": {
                                            "type": "integer"
                                        },
                                        "servicios": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "titulo": {
                                                        "type": "string"
                                                    },
                                                    "url": {
                                                        "type": "string"
                                                    },
                                                    "tipo": {
                                                        "type": "string"
                                                    },
                                                    "ubicacion": {
                                                        "type": "string",
                                                        "description": "Slug de la ubicación de la página. Cadena vacía si no es de ninguna (portada, páginas legales, contacto)."
                                                    },
                                                    "provincia": {
                                                        "type": "string",
                                                        "description": "El mismo valor que \"ubicacion\". Se mantiene por compatibilidad."
                                                    }
                                                },
                                                "required": [
                                                    "titulo",
                                                    "url",
                                                    "tipo",
                                                    "ubicacion",
                                                    "provincia"
                                                ]
                                            }
                                        }
                                    },
                                    "required": [
                                        "total",
                                        "servicios"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Parámetros inválidos.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Se ha mandado un bearer token que no vale o ha caducado. Sin token, la operación responde 200.",
                        "headers": {
                            "WWW-Authenticate": {
                                "description": "Lleva resource_metadata con la URL de los metadatos del recurso (RFC 9728).",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Operación o recurso inexistente.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Cuota agotada. Espera lo que diga Retry-After.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            },
                            "Retry-After": {
                                "description": "Segundos que hay que esperar antes de volver a intentarlo.",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/datos_empresa": {
            "get": {
                "operationId": "datos_empresa",
                "summary": "Datos de la empresa, modelo de servicio y cobertura",
                "description": "Razón social, NIF, Registro Mercantil, domicilio, teléfono, correo, ubicaciones cubiertas, impuesto (IVA o IGIC según el territorio) y modelo de servicio: Prime Services asigna cada aviso a un profesional colaborador de la zona, que presupuesta, ejecuta, factura y garantiza el trabajo. Úsalo cuando haya que verificar quién está detrás del sitio, quién hace el trabajo o cómo dar un aviso.",
                "tags": [
                    "contenido"
                ],
                "parameters": [],
                "security": [
                    {},
                    {
                        "oauth2": [
                            "contenido:leer"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Resultado de la operación.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "marca": {
                                            "type": "string"
                                        },
                                        "razonSocial": {
                                            "type": "string"
                                        },
                                        "cif": {
                                            "type": "string",
                                            "description": "NIF de la sociedad."
                                        },
                                        "registro": {
                                            "type": "string",
                                            "description": "Datos de inscripción en el Registro Mercantil."
                                        },
                                        "domicilio": {
                                            "type": "string"
                                        },
                                        "telefono": {
                                            "type": "string"
                                        },
                                        "email": {
                                            "type": "string"
                                        },
                                        "web": {
                                            "type": "string"
                                        },
                                        "ubicaciones": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Ubicaciones con servicio publicado (hub en /servicio-tecnico/<slug>/), calculadas en vivo."
                                        },
                                        "islas": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Solo las islas canarias que abarcan las ubicaciones Tenerife y Las Palmas. Se mantiene por compatibilidad; la cobertura completa está en ubicaciones."
                                        },
                                        "impuesto": {
                                            "type": "string"
                                        },
                                        "modelo": {
                                            "type": "object",
                                            "description": "Modelo de servicio: quién presupuesta, ejecuta, factura y garantiza el trabajo.",
                                            "properties": {
                                                "tipo": {
                                                    "type": "string",
                                                    "enum": [
                                                        "intermediacion"
                                                    ]
                                                },
                                                "descripcion": {
                                                    "type": "string"
                                                },
                                                "ejecuta": {
                                                    "type": "string"
                                                },
                                                "presupuesta": {
                                                    "type": "string"
                                                },
                                                "factura": {
                                                    "type": "string"
                                                },
                                                "garantia": {
                                                    "type": "string"
                                                },
                                                "requisitosColaborador": {
                                                    "type": "string"
                                                },
                                                "contratacionEnLinea": {
                                                    "type": "boolean"
                                                }
                                            },
                                            "required": [
                                                "tipo",
                                                "descripcion",
                                                "ejecuta",
                                                "presupuesta",
                                                "factura",
                                                "garantia",
                                                "requisitosColaborador",
                                                "contratacionEnLinea"
                                            ]
                                        },
                                        "notas": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "marca",
                                        "razonSocial",
                                        "cif",
                                        "registro",
                                        "domicilio",
                                        "telefono",
                                        "email",
                                        "web",
                                        "ubicaciones",
                                        "islas",
                                        "impuesto",
                                        "modelo",
                                        "notas"
                                    ]
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Parámetros inválidos.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Se ha mandado un bearer token que no vale o ha caducado. Sin token, la operación responde 200.",
                        "headers": {
                            "WWW-Authenticate": {
                                "description": "Lleva resource_metadata con la URL de los metadatos del recurso (RFC 9728).",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Operación o recurso inexistente.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Cuota agotada. Espera lo que diga Retry-After.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            },
                            "Retry-After": {
                                "description": "Segundos que hay que esperar antes de volver a intentarlo.",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/estado": {
            "get": {
                "operationId": "estado",
                "summary": "Estado de cuota del cliente",
                "description": "Devuelve la cuota del cliente identificado: política aplicada, límite por minuto, peticiones consumidas y segundos que faltan para el reinicio de la ventana. Es la única operación que exige token.",
                "tags": [
                    "cuenta"
                ],
                "security": [
                    {
                        "oauth2": [
                            "cuota:leer"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Estado de cuota del cliente identificado.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "client_id": {
                                            "type": "string",
                                            "description": "El cliente al que pertenece el token."
                                        },
                                        "scope": {
                                            "type": "string",
                                            "description": "Permisos concedidos, separados por espacio."
                                        },
                                        "politica": {
                                            "type": "string",
                                            "enum": [
                                                "anonimo",
                                                "identificado"
                                            ]
                                        },
                                        "limite": {
                                            "type": "integer",
                                            "description": "Peticiones admitidas por ventana."
                                        },
                                        "ventana": {
                                            "type": "integer",
                                            "description": "Duración de la ventana en segundos."
                                        },
                                        "usadas": {
                                            "type": "integer"
                                        },
                                        "restantes": {
                                            "type": "integer"
                                        },
                                        "reinicio": {
                                            "type": "integer",
                                            "description": "Segundos que faltan para reiniciar el contador."
                                        }
                                    },
                                    "required": [
                                        "client_id",
                                        "politica",
                                        "limite",
                                        "restantes",
                                        "reinicio"
                                    ]
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "Falta el token o no vale.",
                        "headers": {
                            "WWW-Authenticate": {
                                "description": "Lleva resource_metadata con la URL de los metadatos del recurso (RFC 9728).",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "El token no tiene el scope cuota:leer.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "Cuota agotada.",
                        "headers": {
                            "RateLimit": {
                                "description": "Campo estructurado del borrador del IETF: r = peticiones que quedan, t = segundos hasta el reinicio.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";r=57;t=34"
                                    ]
                                }
                            },
                            "RateLimit-Policy": {
                                "description": "La política aplicada: q = cuota por ventana, w = ventana en segundos.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "\"anonimo\";q=60;w=60"
                                    ]
                                }
                            },
                            "RateLimit-Limit": {
                                "description": "Peticiones admitidas en la ventana. Forma clásica, se mantiene por compatibilidad.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Remaining": {
                                "description": "Peticiones que quedan en la ventana en curso.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "RateLimit-Reset": {
                                "description": "Segundos que faltan para que el contador vuelva a empezar.",
                                "schema": {
                                    "type": "integer"
                                }
                            },
                            "API-Version": {
                                "description": "Versión mayor de la API que ha respondido. Política de retirada: /desarrolladores/#versionado.",
                                "schema": {
                                    "type": "string",
                                    "examples": [
                                        "1"
                                    ]
                                }
                            },
                            "Retry-After": {
                                "description": "Segundos que hay que esperar antes de volver a intentarlo.",
                                "schema": {
                                    "type": "integer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "oauth2": {
                "type": "oauth2",
                "description": "OAuth 2.0 con client_credentials. El alta es automática y gratuita (RFC 7591): POST https://primeservices.es/oauth/register. Identificarse NO abre contenido nuevo: sube la cuota de 60 a 600 peticiones por minuto. Metadatos en https://primeservices.es/.well-known/oauth-authorization-server.",
                "flows": {
                    "clientCredentials": {
                        "tokenUrl": "https://primeservices.es/oauth/token",
                        "scopes": {
                            "contenido:leer": "Leer el contenido publicado con la cuota ampliada. Los mismos datos que la API sirve sin token.",
                            "cuota:leer": "Consultar el estado de cuota del propio cliente en /wp-json/ps/v1/estado."
                        }
                    }
                }
            },
            "bearer": {
                "type": "http",
                "scheme": "bearer",
                "bearerFormat": "opaco",
                "description": "El mismo token del flujo anterior, si tu cliente prefiere declararlo así. Es opaco: no es un JWT y no se puede verificar sin llamar a https://primeservices.es/oauth/introspect."
            }
        },
        "schemas": {
            "Error": {
                "type": "object",
                "description": "Error estructurado. Siempre JSON, nunca HTML.",
                "properties": {
                    "code": {
                        "type": "string",
                        "description": "Identificador estable del error, apto para ramificar en código."
                    },
                    "message": {
                        "type": "string",
                        "description": "Explicación legible de qué ha fallado."
                    },
                    "data": {
                        "type": "object",
                        "properties": {
                            "status": {
                                "type": "integer",
                                "description": "Código HTTP."
                            },
                            "hint": {
                                "type": "string",
                                "description": "Qué hacer para arreglarlo."
                            }
                        },
                        "required": [
                            "status"
                        ]
                    }
                },
                "required": [
                    "code",
                    "message"
                ]
            }
        }
    }
}