Saltar al contenido
docs
Guías
EN
CatálogoCanales
channel:read

Listar publicaciones del canal

GET/v1/channels/{channelId}/listings

Listar publicaciones del canal. Una solicitud exitosa devuelve HTTP 200 con el cuerpo de respuesta documentado.

Autorización

bearerAuth
AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de ruta

channelId*string

Identificador del canal de venta.

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor opaco de la respuesta anterior. Omítelo en la primera página.

search?string

Filtro de texto libre. Los campos consultados dependen del recurso.

sortBy?string

Campo de ordenamiento. Los valores admitidos dependen del recurso.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"
status?array<>

Solo elementos en estos estados.

readiness?array<>
categoryIds?array<ResourceId>

Solo elementos en estas categorías.

gender?array<string>

Género al que se dirige el elemento.

minPrice?number

Precio mínimo a incluir, en la moneda de la tienda.

Formatodouble
maxPrice?number

Precio máximo a incluir, en la moneda de la tienda.

Formatodouble
minStock?integer

Nivel mínimo de existencias.

Formatoint32
maxStock?integer

Nivel máximo de existencias.

Formatoint32
issues?boolean

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/channels/7204558912004325301/listings" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004325301",      "channelId": "7204558912004325301",      "productId": "7204558912004325301",      "listingType": "salesChannel",      "externalId": "7204558912004325301",      "externalUrl": "https://example.com/resource",      "status": "draft",      "price": 1,      "compareAtPrice": 1,      "lastSyncAt": "2026-08-01T15:30:00Z",      "lastSyncError": "example",      "lastSyncErrorCode": "example_code",      "readinessStatus": "unknown",      "readinessIssues": [        {          "code": "example_code",          "message": "example",          "blocking": false,          "source": "example",          "references": [            "example"          ],          "causeCode": 1,          "sku": "SKU-001"        }      ],      "publishable": false,      "readinessUpdatedAt": "2026-08-01T15:30:00Z",      "createdOn": "2026-08-01T15:30:00Z",      "updatedOn": "2026-08-01T15:30:00Z"    }  ],  "hasNextPage": false,  "nextCursor": "example",  "totalCount": 1}