OTL ShoesAPI
Exemplos em
Menu da documentação

Postman

Baixe a coleção com todos os endpoints e teste a API sem escrever código.

Baixar a coleçãoAmbiente SandboxAmbiente Produção

São três arquivos: a coleção, com todos os endpoints, e dois ambientes, que guardam a URL base e o token de cada lado. Funcionam no Postman e em ferramentas compatíveis com o formato dele, como Insomnia e Bruno.

Como usar

  1. No Postman, clique em Import e arraste os três arquivos.
  2. No canto superior direito, escolha o ambiente OTL Shoes — Sandbox.
  3. Abra o ambiente (ícone de olho → Edit) e cole o seu token na variável token. Salve.
  4. Abra Conta → Quem sou eu e clique em Send.

Se a resposta trouxer "ambiente": "sandbox" e as suas permissões, está tudo certo.

O que vem na coleção

  • Todos os endpoints desta documentação, organizados por recurso.
  • O cabeçalho Authorization: Bearer {{token}} em cada chamada, visível na aba Headers. Você só preenche a variável token, uma vez, no ambiente.
  • Todos os parâmetros de cada endpoint, com exemplo e descrição. Eles vêm desmarcados — marque os que quiser usar.
  • Um exemplo de resposta em cada chamada, o mesmo que aparece nas páginas de referência.

Trocando de ambiente

Selecione OTL Shoes — Produção no seletor de ambiente e preencha o token desse ambiente com um token otl_prod_…. A URL base troca junto.

Cada ambiente tem o seu token

Um token de sandbox não funciona na produção, nem o contrário: a API responde 401 TOKEN_DE_OUTRO_AMBIENTE. Guardar um token em cada ambiente do Postman evita esse erro.

Cuidado com o token

Não exporte nem compartilhe o ambiente com o token preenchido

Os arquivos baixados daqui vêm sem token. Depois que você preenche, o ambiente passa a conter uma credencial: não o envie a ninguém, e não o sincronize com um workspace compartilhado. No Postman, a variável é do tipo secret — o valor fica mascarado na tela, mas continua no arquivo se você exportar.

A coleção acompanha a documentação

Ela é gerada junto com este site, a partir da mesma descrição de endpoints e dos mesmos exemplos. Quando um endpoint novo entrar, baixe a coleção de novo e importe por cima — o Postman pergunta se deve substituir.