list_directory_by_category
Las paginas amarillas, por categoria: cada negocio dado de alta y cada API de pago por uso admitida, con como llamarla; primero los negocios dados de alta
GET https://emporium.ultravioletadao.xyz/api/directory/categories
Por dónde se llega
| API REST | Solo lectura | GET https://emporium.ultravioletadao.xyz/api/directory/categories |
|---|---|---|
| MCP | Muy pronto | |
| CLI | Muy pronto | |
| SDK de Python | Muy pronto | |
| SDK de TypeScript | Muy pronto | |
| SDK de Rust | Muy pronto |
Vivo: se usa hoy, para leer y para escribir. Solo lectura: hoy se lee y no se escribe. Muy pronto: todavía no está.
Parámetros
| Nombre | Dónde | Requerido | Esquema | Qué es |
|---|---|---|---|---|
idioma | consulta | no | string |
El cuerpo de la petición
No lleva cuerpo.
Respuestas
200
Correcto
application/json
{
"$ref": "#/components/schemas/PaginasAmarillas"
}Cualquier otro status
Un error: en JSON, el sobre único, cuyo error.codigo es uno de una lista cerrada
application/json
{
"$ref": "#/components/schemas/SobreDeError"
}Esquemas
Los que nombra esta operación, tal cual están en components.schemas del contrato.
CategoriaDeLasAmarillas
{
"properties": {
"categoria": {
"type": "string"
},
"etiqueta": {
"type": "string"
},
"hosts": {
"items": {
"$ref": "#/components/schemas/HostDeLasAmarillas"
},
"type": "array"
},
"negocios": {
"items": {
"$ref": "#/components/schemas/NegocioDeLasAmarillas"
},
"type": "array"
},
"prestadores": {
"items": {
"$ref": "#/components/schemas/PrestadorDeLasAmarillas"
},
"type": "array"
}
},
"required": [
"categoria",
"etiqueta",
"hosts",
"negocios",
"prestadores"
],
"type": "object"
}CodigoDeError
{
"enum": [
"dominio_invalido",
"slug_ocupado",
"tenant_no_encontrado",
"tenant_no_publicado",
"tenant_suspendido",
"clave_invalida",
"estado_no_permite",
"ventana_no_cumplida",
"metodo_invalido",
"manifiesto_invalido",
"categoria_prohibida",
"terminos_no_aceptados",
"canal_no_confirmado",
"version_de_terminos_desconocida",
"pedido_invalido",
"faltan_datos",
"respuesta_invalida",
"firma_invalida",
"enlace_vencido",
"enlace_ya_usado",
"demasiadas_peticiones",
"parametro_invalido",
"metodo_no_permitido",
"firma_no_configurada",
"correo_no_configurado",
"terminos_no_configurados",
"casa_no_configurada",
"almacen_no_disponible",
"error_interno",
"paybox_no_configurado",
"boveda_no_disponible",
"sesion_requerida",
"estado_oauth_invalido",
"consentimiento_rechazado",
"concesion_insegura",
"paybox_no_responde",
"paybox_rechazo",
"sin_vinculo",
"vinculo_revocado",
"vinculo_vencido",
"reconexion_requerida",
"vinculo_ajeno",
"renovacion_en_curso"
],
"type": "string"
}CuerpoDelError
{
"additionalProperties": false,
"properties": {
"codigo": {
"$ref": "#/components/schemas/CodigoDeError"
},
"detalles": {
"items": {
"$ref": "#/components/schemas/Detalle"
},
"type": "array"
},
"mensaje": {
"type": "string"
},
"peticion_id": {
"type": "string"
}
},
"required": [
"codigo",
"detalles",
"mensaje",
"peticion_id"
],
"type": "object"
}DeclaradoEnLasAmarillas
{
"properties": {
"nombre": {
"type": [
"string",
"null"
]
},
"ofertas": {
"items": true,
"type": "array"
}
},
"required": [
"nombre",
"ofertas"
],
"type": "object"
}DeclaradoPorElPrestador
{
"properties": {
"oferta": true
},
"required": [
"oferta"
],
"type": "object"
}DeclaradoPorElVendedor
{
"properties": {
"categoria": {
"type": [
"string",
"null"
]
},
"descripcion": {
"type": [
"string",
"null"
]
},
"etiquetas": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"categoria",
"descripcion",
"etiquetas"
],
"type": "object"
}Detalle
{
"additionalProperties": false,
"properties": {
"campo": {
"type": "string"
},
"problema": {
"type": "string"
}
},
"required": [
"campo",
"problema"
],
"type": "object"
}EndpointDeLasAmarillas
{
"properties": {
"declarado_por_el_vendedor": {
"$ref": "#/components/schemas/DeclaradoPorElVendedor"
},
"evidencia": {
"$ref": "#/components/schemas/Evidencia"
},
"url": {
"type": "string"
}
},
"required": [
"declarado_por_el_vendedor",
"evidencia",
"url"
],
"type": "object"
}EstadoVivo
{
"enum": [
"alive",
"auth_gated"
],
"type": "string"
}Evidencia
{
"properties": {
"liquido": {
"$ref": "#/components/schemas/Liquido"
},
"precio": {
"anyOf": [
{
"$ref": "#/components/schemas/PrecioLeido"
},
{
"type": "null"
}
]
},
"reputacion": {
"$ref": "#/components/schemas/ReputacionDelTercero"
},
"sin_precio_por": {
"anyOf": [
{
"$ref": "#/components/schemas/MotivoSinPrecio"
},
{
"type": "null"
}
]
},
"sin_vivo_por": {
"anyOf": [
{
"$ref": "#/components/schemas/MotivoSinVivo"
},
{
"type": "null"
}
]
},
"vivo": {
"anyOf": [
{
"$ref": "#/components/schemas/Vivo"
},
{
"type": "null"
}
]
}
},
"required": [
"liquido",
"precio",
"reputacion",
"vivo"
],
"type": "object"
}HostDeLasAmarillas
{
"properties": {
"admision": {
"type": "string"
},
"endpoints": {
"items": {
"$ref": "#/components/schemas/EndpointDeLasAmarillas"
},
"type": "array"
},
"endpoints_total": {
"format": "uint",
"minimum": 0,
"type": "integer"
},
"host": {
"type": "string"
},
"rotulo": {
"type": "string"
}
},
"required": [
"admision",
"endpoints",
"endpoints_total",
"host",
"rotulo"
],
"type": "object"
}Liquido
{
"oneOf": [
{
"properties": {
"estado": {
"const": "sin_evidencia_de_liquidacion",
"type": "string"
}
},
"required": [
"estado"
],
"type": "object"
},
{
"properties": {
"estado": {
"const": "evidencia_de_liquidacion_sin_leer",
"type": "string"
}
},
"required": [
"estado"
],
"type": "object"
}
]
}MedioLeido
{
"properties": {
"activo": {
"type": "string"
},
"decimales": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"monto_atomico": {
"type": "string"
},
"red": {
"type": "string"
}
},
"required": [
"activo",
"decimales",
"monto_atomico",
"red"
],
"type": "object"
}MotivoSinPrecio
{
"oneOf": [
{
"enum": [
"conflict",
"unknown",
"stale"
],
"type": "string"
},
{
"const": "sin_frescura",
"type": "string"
},
{
"const": "otra",
"type": "string"
},
{
"const": "sin_fecha",
"type": "string"
},
{
"const": "sin_medios",
"type": "string"
},
{
"const": "esquema_upto",
"type": "string"
}
]
}MotivoSinVivo
{
"oneOf": [
{
"const": "sin_salud",
"type": "string"
},
{
"const": "otra_salud",
"type": "string"
},
{
"const": "sin_fecha",
"type": "string"
},
{
"const": "sondeo_en_el_futuro",
"type": "string"
}
]
}NegocioDeLasAmarillas
{
"properties": {
"declarado_por_el_negocio": {
"$ref": "#/components/schemas/DeclaradoEnLasAmarillas"
},
"slug": {
"type": "string"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
},
"url_ficha": {
"type": "string"
},
"url_mcp": {
"type": "string"
}
},
"required": [
"declarado_por_el_negocio",
"slug",
"tools",
"url_ficha",
"url_mcp"
],
"type": "object"
}NivelDePrueba
{
"oneOf": [
{
"const": "con_venta_externa",
"type": "string"
},
{
"const": "sin_venta_externa_demostrada",
"type": "string"
}
]
}PaginasAmarillas
{
"properties": {
"aviso": {
"type": "string"
},
"aviso_datos_del_negocio": {
"type": "string"
},
"aviso_datos_del_prestador": {
"type": "string"
},
"categorias": {
"items": {
"$ref": "#/components/schemas/CategoriaDeLasAmarillas"
},
"type": "array"
},
"entradas_sin_mostrar": {
"format": "uint",
"minimum": 0,
"type": "integer"
}
},
"required": [
"aviso",
"aviso_datos_del_negocio",
"aviso_datos_del_prestador",
"categorias",
"entradas_sin_mostrar"
],
"type": "object"
}PrecioLeido
{
"properties": {
"leido_el": {
"type": "string"
},
"medios": {
"items": {
"$ref": "#/components/schemas/MedioLeido"
},
"type": "array"
},
"rotulo": {
"type": "string"
}
},
"required": [
"leido_el",
"medios",
"rotulo"
],
"type": "object"
}PrestadorDeLasAmarillas
{
"properties": {
"prestador_id": {
"type": "string"
},
"procedencia": {
"$ref": "#/components/schemas/ProcedenciaDelCandidato"
},
"prueba": {
"$ref": "#/components/schemas/PruebaEnLaRespuesta"
},
"servicios": {
"items": {
"$ref": "#/components/schemas/ServicioDeLasAmarillas"
},
"type": "array"
},
"servicios_total": {
"format": "uint",
"minimum": 0,
"type": "integer"
}
},
"required": [
"prestador_id",
"procedencia",
"prueba",
"servicios",
"servicios_total"
],
"type": "object"
}ProcedenciaDelCandidato
{
"enum": [
"tenant",
"prestador",
"tercero"
],
"type": "string"
}PruebaEnLaRespuesta
{
"properties": {
"compradores_distintos": {
"format": "uint64",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"compradores_externos": {
"format": "uint64",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"marca": {
"type": "string"
},
"nivel": {
"$ref": "#/components/schemas/NivelDePrueba"
},
"reputacion": {
"format": "double",
"type": [
"number",
"null"
]
},
"trabajos_completados": {
"format": "uint64",
"minimum": 0,
"type": "integer"
}
},
"required": [
"compradores_distintos",
"compradores_externos",
"marca",
"nivel",
"reputacion",
"trabajos_completados"
],
"type": "object"
}ReputacionDelTercero
{
"oneOf": [
{
"properties": {
"estado": {
"const": "no_disponible_en_emporium",
"type": "string"
}
},
"required": [
"estado"
],
"type": "object"
}
]
}ServicioDeLasAmarillas
{
"properties": {
"declarado_por_el_prestador": {
"$ref": "#/components/schemas/DeclaradoPorElPrestador"
},
"servicio_id": {
"type": "string"
}
},
"required": [
"declarado_por_el_prestador",
"servicio_id"
],
"type": "object"
}SobreDeError
{
"additionalProperties": false,
"properties": {
"error": {
"$ref": "#/components/schemas/CuerpoDelError"
}
},
"required": [
"error"
],
"type": "object"
}Vivo
{
"properties": {
"estado": {
"$ref": "#/components/schemas/EstadoVivo"
},
"latencia_ms": {
"format": "uint64",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"ultimo_sondeo": {
"type": "string"
}
},
"required": [
"estado",
"latencia_ms",
"ultimo_sondeo"
],
"type": "object"
}