Obtener un producto del catálogo
POST
/ucp/catalog/productObtener un producto del catálogo. Una solicitud exitosa devuelve HTTP 200 con el cuerpo de respuesta documentado.
AutorizaciónBearer <token>
Token de acceso OAuth 2.0 emitido por Ecomiq Auth.
Ubicación: header
Parámetros de cabecera
x-Store-Domain*string
Slug o dominio configurado que selecciona el contexto de tienda para UCP.
Longitud
1 <= length <= 253UCP-Agent*string
Perfil del agente en el formato profile="https://agent.example/.well-known/ucp".
Longitud
1 <= lengthIdempotency-Key?string
Clave de idempotencia opcional para reintentar solicitudes UCP de forma segura.
Longitud
1 <= length <= 300Cuerpo 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
curl -X POST "https://example.com/ucp/catalog/product" \ -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 '{ "id": "7204558912004325301", "selected": [ { "name": "Example resource", "label": "example", "id": "7204558912004325301" } ], "preferences": [ "example" ], "filters": { "categories": [ "example" ], "price": { "min": 1, "max": 1 } }, "context": { "currency": "PEN", "address_country": "example", "address_region": "example", "postal_code": "example_code", "intent": "example", "language": "es", "eligibility": [ "example" ] }, "signals": { "dev.ucp.buyer_ip": "example", "dev.ucp.user_agent": "example" }, "attribution": {} }'{ "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": {} } ] } }, "product": { "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" } } }, "messages": [ { "type": "example", "content": "example", "code": "example_code", "path": "example", "content_type": "example", "severity": "example" } ]}