Saltar al contenido
docs
Guías
EN
Catálogo

Buscar en el catálogo

POST/ucp/catalog/search

Buscar en el catálogo. Una solicitud exitosa devuelve HTTP 200 con el cuerpo de respuesta documentado.

Autorización

AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de cabecera

Authorization*string

Token bearer OAuth 2.0.

x-Store-Domain*string

Slug o dominio configurado que selecciona el contexto de tienda para UCP.

Longitud1 <= length <= 253
UCP-Agent*string

Perfil del agente en el formato profile="https://agent.example/.well-known/ucp".

Longitud1 <= length
Idempotency-Key?string

Clave de idempotencia opcional para reintentar solicitudes UCP de forma segura.

Longitud1 <= length <= 300

Cuerpo de la solicitud

application/json

Definiciones TypeScript

Usa esta definición en TypeScript.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/ucp/catalog/search" \  -H "Authorization: Bearer <token>" \  -H "x-Store-Domain: my-store" \  -H "UCP-Agent: profile="https://agent.example/.well-known/ucp"" \  -H "Idempotency-Key: checkout-2026-0001" \  -H "Content-Type: application/json" \  -d '{    "query": "polo de algodón",    "context": {      "currency": "PEN",      "address_country": "PE",      "language": "es"    },    "pagination": {      "limit": 10    }  }'
{  "ucp": {    "version": "example",    "status": "example",    "capabilities": {      "key": [        {          "version": "example"        }      ]    },    "payment_handlers": {      "key": [        {          "id": "7204558912004325301",          "version": "example",          "spec": "example",          "schema": "example",          "available_instruments": [            {              "type": "example",              "constraints": {}            }          ],          "config": {}        }      ]    }  },  "products": [    {      "id": "7204558912004325301",      "title": "Example title",      "description": {        "plain": "example",        "html": "example",        "markdown": "example"      },      "price_range": {        "min": {          "amount": 1,          "currency": "PEN"        },        "max": {          "amount": 1,          "currency": "PEN"        }      },      "handle": "example",      "url": "https://example.com/resource",      "categories": [        {          "value": "example",          "taxonomy": "example"        }      ],      "list_price_range": {        "min": {          "amount": 1,          "currency": "PEN"        },        "max": {          "amount": 1,          "currency": "PEN"        }      }    }  ],  "pagination": {    "has_next_page": false,    "cursor": "example",    "total_count": 1  },  "messages": [    {      "type": "example",      "content": "example",      "code": "example_code",      "path": "example",      "content_type": "example",      "severity": "example"    }  ]}