Obtenha sua chave API
Obtenha uma conta Zonos: Para usar a API Zonos você precisará de uma chave de API. Para obter sua chave, você precisará preencher nosso formulário de inscrição. A integração começará assim que você tiver um contrato de conta em vigor. Durante a integração, um representante ajudará você a configurar sua conta corretamente para que você obtenha respostas de API mais precisas.
Acesse sua chave API aqui se você tiver uma conta Zonos. Isso permitirá que você se autentique com a API Zonos. Se você não possui uma conta, veja a nota acima.
Decida quais detalhes recuperar
Você pode consultar listas de pedidos com base em accountOrderIds semelhantes ou fornecendo um intervalo de datas entre os quais os pedidos foram publicados. Para obter uma lista completa dos campos disponíveis, consulte a referência da API GraphQL.
Em cada pedido individual que você consulta, todos os campos normais Order estão disponíveis, por exemplo, o país, informações de envio, totais de Landed Cost, etc.. Todos os campos possíveis estão listados na referência da API GraphQL.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id # ... field names here } } }}Envie as páginas para buscar
Todas as consultas que recuperam listas suportam paginação estilo Relay. A variável first permite especificar quantos objetos serão retornados.
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id } } pageInfo { hasNextPage endCursor } }}Envie sua solicitação
Agora que você criou e configurou sua solicitação, você pode enviar uma solicitação POST para a API Zonos. Certifique-se de autenticar com sua chave de API e fornecer o cabeçalho da versão correta em sua solicitação.
POST https://api.zonos.com/graphql
query orders($ordersFilter: OrdersFilter, $first: Int) { orders(filter: $ordersFilter, first: $first) { edges { node { id items { description hsCode quantity } } } }}
Pesquise e filtre pedidos
Recupere listas de pedidos com GraphQL.Usando a consulta
ordersno GraphQL, você pode recuperar listas paginadas de pedidos com vários critérios. Isto é útil quando você precisa de uma lista de pedidos por país, entre datas específicas, para criar uma pesquisa, etc.