{"openapi": "3.1.0", "info": {"title": "OposDocs — API de búsqueda", "version": "1.0.0", "description": "API pública de solo lectura para buscar documentos de oposiciones. Limitada a 60 peticiones por minuto por IP."}, "servers": [{"url": "https://oposdocs.org"}], "paths": {"/api/buscar/": {"get": {"summary": "Buscar documentos", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "page", "in": "query", "schema": {"type": "integer", "minimum": 1}}, {"name": "ambito", "in": "query", "schema": {"type": "string", "enum": ["estado", "autonomica", "local"]}}, {"name": "grupo", "in": "query", "schema": {"type": "string", "enum": ["A1", "A2", "B", "C1", "C2", "E"]}}, {"name": "oposicion", "in": "query", "schema": {"type": "string"}, "description": "Slug de la oposición"}, {"name": "source_type", "in": "query", "schema": {"type": "string", "enum": ["official", "editorial", "user"]}}, {"name": "anio", "in": "query", "schema": {"type": "integer"}}, {"name": "tipo", "in": "query", "schema": {"type": "string"}, "description": "Tipo MIME"}], "responses": {"200": {"description": "Resultados de búsqueda", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/SearchResponse"}}}}, "429": {"description": "Límite de peticiones superado"}}}}}, "components": {"schemas": {"SearchResponse": {"type": "object", "properties": {"query": {"type": "string"}, "total": {"type": "integer"}, "page": {"type": "integer"}, "per_page": {"type": "integer"}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/SearchResult"}}}}, "SearchResult": {"type": "object", "properties": {"title": {"type": "string"}, "url": {"type": "string", "format": "uri"}, "url_markdown": {"type": "string", "format": "uri"}, "description": {"type": "string"}, "snippet": {"type": "string"}, "source_type": {"type": "string"}, "mime_type": {"type": "string"}, "pages": {"type": ["integer", "null"]}, "oposiciones": {"type": "array", "items": {"type": "object"}}}}}}}