Skip to main content
Há duas formas de começar: baixar as coleções prontas, com pastas em português e o OAuth2 já configurado, ou importar as specs OpenAPI e configurar a autenticação você mesmo.

​
Antes de começar

  • Uma conta no Postman (a gratuita basta).
  • Um app no painel de developers com client_id e client_secret.
  • Uma loja com o app instalado. Não há sandbox: as chamadas vão para produção, então use a loja de teste pedida no Discord.

​
Coleções prontas

1

Importe a coleção e o ambiente

Baixe os arquivos e arraste-os para o Postman, ou use Import.
2

Preencha o ambiente

Selecione o ambiente DeliveryVip e preencha clientId, clientSecret e o merchantId (ou partnerId). No Open Delivery, o clientSecret é o da loja.
3

Gere o token

Abra a coleção, vá em Authorization e clique em Get New Access Token e depois em Use Token. O scope já vem preenchido nas variáveis da coleção (od.all ou dv.partner).
4

Faça uma chamada

Os IDs das rotas usam as variáveis do ambiente ({{merchantId}}, {{orderId}}). Comece por Consultar token atual, na pasta Autenticação.

​
Specs disponíveis

​
Importando a partir das specs

1

Copie a URL da spec

Escolha a spec da tabela acima e copie a URL.
2

Importe no Postman

No Postman, clique em Import, cole a URL e confirme. Escolha gerar uma coleção (Postman Collection).
3

Configure a autenticação

Na coleção, abra Authorization, escolha OAuth 2.0 e preencha:Clique em Get New Access Token e depois em Use Token. Todas as requisições da coleção herdam o token.
4

Faça uma chamada

Comece por GET /authentication/v1/oauth/token/info para confirmar o token e depois chame uma rota da loja de teste.
Guarde client_id e client_secret como variáveis secretas de um ambiente do Postman, nunca direto na coleção. Coleções exportadas ou compartilhadas levam junto o que está salvo nelas.
Para o Open Delivery, use https://od.deliveryvip.com.br/oauth/token como Access Token URL e o client_secret da loja. Veja Primeiros passos do Open Delivery.