Pular para o conteúdo principal

Listar coleções

Método#

/catalogs/collection#

GET https://api.z-api.io/instances/{{instanceId}}/token/{{instanceToken}}/catalogs/collection

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Utilizando esse método você será capaz de listar as coleções do seu catálogo.


Atributos#

Opcional#

AtributosTipoDescrição
nextCursorstringToken utilizado para paginação dos registros

Request Params#

URL exemplo#

Método

GET https://api.z-api.io/instances/{{instanceId}}/token/{{instanceToken}}/catalogs/collection?nextCursor=VALOR_DO_CURSOR


Response#

200#

AtributosTipoDescrição
collectionsarray objectLista com dados da coleção
nextCursorstring ou nullToken que define os registros da próxima requisição

Object (collections)

AtributosTipoDescrição
idstringId da coleção
namestringNome da coleção
statusstringStatus da coleção (PENDING, APPROVED)

Exemplo

{
"nextCursor": "AQHRi6eu3NyRTR30t5Sr2CtkURU7rMF_e2K7NPbELxJFAa-K_HI1I6v8_C3o2j6d4wve",
"collections": [
{
"id": "1072603710847740",
"name": "Nome da coleção",
"status": "PENDING"
},
{
"id": "902834786123343",
"name": "Nome da coleção 2",
"status": "APPROVED"
}
]
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"

---retailerId

Code#