get_business_use_cases
A published business's use cases and the gaps it closes, by category
GET https://emporium.ultravioletadao.xyz/api/businesses/{slug}/use-cases
Where to reach it
| REST API | Read-only | GET https://emporium.ultravioletadao.xyz/api/businesses/{slug}/use-cases |
|---|---|---|
| MCP | Coming soon | |
| CLI | Coming soon | |
| Python SDK | Coming soon | |
| TypeScript SDK | Coming soon | |
| Rust SDK | Coming soon |
Live: you can use it today, to read and to write. Read-only: today you can read, not write. Coming soon: not there yet.
Parameters
| Name | In | Required | Schema | What it is |
|---|---|---|---|---|
slug | path | yes | string |
Request body
It takes no body.
Responses
200
OK
application/json
{
"$ref": "#/components/schemas/CasosPublicados"
}Any other status
An error: with JSON, the single envelope, whose error.codigo is one of a closed list
application/json
{
"$ref": "#/components/schemas/SobreDeError"
}Schemas
The ones this operation names, as they are in the contract's components.schemas.
Accion
{
"oneOf": [
{
"properties": {
"nombre": {
"type": "string"
},
"tipo": {
"const": "tool",
"type": "string"
}
},
"required": [
"nombre",
"tipo"
],
"type": "object"
},
{
"properties": {
"medio": {
"type": "string"
},
"tipo": {
"const": "enlace",
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"medio",
"tipo",
"url"
],
"type": "object"
}
]
}Caso
{
"properties": {
"accion": {
"$ref": "#/components/schemas/Accion"
},
"alias_aceptados": {
"items": {
"type": "string"
},
"type": "array"
},
"alias_propuestos": {
"items": {
"type": "string"
},
"type": "array"
},
"estado": {
"$ref": "#/components/schemas/EstadoDelCaso"
},
"frase": {
"type": "string"
},
"id": {
"type": "string"
},
"oferta_id": {
"type": "string"
},
"precio": {
"$ref": "#/components/schemas/PrecioDelCaso"
},
"procedencia": {
"$ref": "#/components/schemas/ProcedenciaDelCaso"
},
"via_de_pago": {
"$ref": "#/components/schemas/ViaDePago"
}
},
"required": [
"accion",
"alias_aceptados",
"alias_propuestos",
"estado",
"frase",
"id",
"oferta_id",
"precio",
"procedencia",
"via_de_pago"
],
"type": "object"
}CasosPublicados
{
"properties": {
"aviso": {
"type": "string"
},
"casos": {
"items": {
"$ref": "#/components/schemas/Caso"
},
"type": "array"
},
"huecos_cerrados": {
"items": {
"$ref": "#/components/schemas/HuecoCerrado"
},
"type": "array"
},
"rio": {
"$ref": "#/components/schemas/EstadoDelRio"
},
"slug": {
"type": "string"
}
},
"required": [
"aviso",
"casos",
"huecos_cerrados",
"rio",
"slug"
],
"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"
}Detalle
{
"additionalProperties": false,
"properties": {
"campo": {
"type": "string"
},
"problema": {
"type": "string"
}
},
"required": [
"campo",
"problema"
],
"type": "object"
}EstadoDelCaso
{
"enum": [
"propuesto",
"aceptado"
],
"type": "string"
}EstadoDelRio
{
"anyOf": [
{
"$ref": "#/components/schemas/VentanaAplicada"
},
{
"const": "no_disponible",
"type": "string"
}
]
}HuecoCerrado
{
"properties": {
"busquedas_sin_candidatos": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"categoria": {
"type": "string"
},
"ciudad": {
"type": [
"string",
"null"
]
},
"etiqueta": {
"type": "string"
},
"frase": {
"type": "string"
}
},
"required": [
"busquedas_sin_candidatos",
"categoria",
"ciudad",
"etiqueta",
"frase"
],
"type": "object"
}PrecioDelCaso
{
"oneOf": [
{
"properties": {
"comprometible": {
"type": "boolean"
},
"modo": {
"const": "publicado",
"type": "string"
},
"moneda": {
"type": "string"
},
"monto": {
"type": "string"
}
},
"required": [
"comprometible",
"modo",
"moneda",
"monto"
],
"type": "object"
},
{
"properties": {
"modo": {
"const": "a_cotizar",
"type": "string"
}
},
"required": [
"modo"
],
"type": "object"
}
]
}ProcedenciaDelCaso
{
"properties": {
"accion": {
"type": "string"
},
"alias": {
"type": "string"
},
"frase": {
"type": "string"
},
"precio": {
"type": "string"
}
},
"required": [
"accion",
"alias",
"frase",
"precio"
],
"type": "object"
}SobreDeError
{
"additionalProperties": false,
"properties": {
"error": {
"$ref": "#/components/schemas/CuerpoDelError"
}
},
"required": [
"error"
],
"type": "object"
}VentanaAplicada
{
"properties": {
"desde": {
"type": "string"
},
"hasta": {
"type": "string"
},
"horas": {
"format": "int64",
"type": "integer"
}
},
"required": [
"desde",
"hasta",
"horas"
],
"type": "object"
}ViaDePago
{
"enum": [
"x402",
"enlace_tarjeta",
"fuera_de_banda",
"ninguna"
],
"type": "string"
}