Todos os endpoints
A API inteira em uma página, por recurso. Clique no nome para ver parâmetros, exemplos e erros.
URL base: https://api.otlshoes.com.brhttps://api-sandbox.otlshoes.com.br. Toda chamada leva o cabeçalho Authorization: Bearer <token>.
Conta
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/eu | Quem sou eu | qualquer token |
| GET | /v1/conta | Conta do parceiro | conta:ler |
Produtos
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/produtos | Listar produtos | produtos:ler |
| GET | /v1/produtos/{sku} | Detalhar produto | produtos:ler |
| GET | /v1/produtos/{sku}/estoque | Estoque do produto | produtos:ler |
| GET | /v1/categorias | Categorias, estilos e tags | produtos:ler |
| GET | /v1/numeracoes | Numerações | produtos:ler |
Clientes
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/clientes | Listar clientes | clientes:ler |
| GET | /v1/clientes/{id} | Detalhar cliente | clientes:ler |
| POST | /v1/clientes | Criar cliente | clientes:escrever |
| PATCH | /v1/clientes/{id} | Alterar cliente | clientes:escrever |
| DELETE | /v1/clientes/{id} | Remover cliente | clientes:escrever |
Pedidos
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/pedidos | Listar pedidos | pedidos:ler |
| GET | /v1/pedidos/{id} | Detalhar pedido | pedidos:ler |
| POST | /v1/pedidos | Criar pedido | pedidos:criar |
| POST | /v1/pedidos/validar | Simular pedido | pedidos:criar |
| PATCH | /v1/pedidos/{id}/itens/{itemId}/valor-venda | Informar valor de venda | pedidos:escrever |
| POST | /v1/pedidos/{id}/despesas | Lançar despesa | pedidos:escrever |
| DELETE | /v1/pedidos/{id}/despesas/{despesaId} | Remover despesa | pedidos:escrever |
| POST | /v1/pedidos/{id}/rastreios | Cadastrar rastreio | pedidos:escrever |
| DELETE | /v1/pedidos/{id}/rastreios/{rastreioId} | Remover rastreio | pedidos:escrever |
| POST | /v1/pedidos/{id}/anexos | Enviar comprovante | pedidos:escrever |
| GET | /v1/pedidos/{id}/anexos/{anexoId}/arquivo | Baixar anexo | pedidos:ler |
| DELETE | /v1/pedidos/{id}/anexos/{anexoId} | Remover comprovante | pedidos:escrever |
Financeiro
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/financeiro/saldo | Saldo | financeiro:ler |
| GET | /v1/financeiro/extrato | Extrato | financeiro:ler |
Etiquetas
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/superfrete | Conta SuperFrete | etiquetas:ler |
| GET | /v1/pedidos/{id}/etiquetas/cotacao | Cotar frete | etiquetas:ler |
| POST | /v1/pedidos/{id}/etiquetas | Emitir etiqueta | etiquetas:emitir |
| GET | /v1/pedidos/{id}/etiquetas | Etiquetas do pedido | etiquetas:ler |
| DELETE | /v1/pedidos/{id}/etiquetas/{etiquetaId} | Cancelar etiqueta | etiquetas:emitir |
Loja-hub
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| GET | /v1/loja-hub | Ver a loja | loja-hub:ler |
| PATCH | /v1/loja-hub | Alterar a loja | loja-hub:escrever |
| POST | /v1/loja-hub/publicar | Publicar | loja-hub:escrever |
| POST | /v1/loja-hub/despublicar | Despublicar | loja-hub:escrever |
| GET | /v1/loja-hub/selecao | Ver a seleção | loja-hub:ler |
| PUT | /v1/loja-hub/selecao | Definir a seleção | loja-hub:escrever |
| GET | /v1/loja-hub/estatisticas | Estatísticas | loja-hub:ler |
| GET | /v1/loja-hub/aparencia | Ver a aparência | loja-hub:ler |
| PUT | /v1/loja-hub/aparencia | Definir a aparência | loja-hub:escrever |
| GET | /v1/loja-hub/banners | Listar banners | loja-hub:ler |
| POST | /v1/loja-hub/banners | Enviar banner | loja-hub:escrever |
| PATCH | /v1/loja-hub/banners/{bannerId} | Alterar banner | loja-hub:escrever |
| PUT | /v1/loja-hub/banners/ordem | Ordenar banners | loja-hub:escrever |
| DELETE | /v1/loja-hub/banners/{bannerId} | Remover banner | loja-hub:escrever |
| POST | /v1/loja-hub/logo | Enviar logo | loja-hub:escrever |
| DELETE | /v1/loja-hub/logo | Remover logo | loja-hub:escrever |
| GET | /v1/loja-hub/seo/produtos/{sku} | Ver texto do produto | loja-hub:ler |
| PUT | /v1/loja-hub/seo/produtos/{sku} | Gravar texto do produto | loja-hub:escrever |
| DELETE | /v1/loja-hub/seo/produtos/{sku} | Remover texto do produto | loja-hub:escrever |
Simuladores (sandbox)
| Método | Rota | O que faz | Permissão |
|---|---|---|---|
| POST | /v1/sandbox/pedidos/{id}/status | Simular status do pedido | qualquer token de teste |
| POST | /v1/sandbox/pedidos/{id}/anexos/{anexoId}/validar | Simular validação do comprovante | qualquer token de teste |
| POST | /v1/sandbox/pedidos/{id}/rastreios/{rastreioId}/validar | Simular validação do rastreio | qualquer token de teste |
| POST | /v1/sandbox/etiquetas/{id}/status | Simular status da etiqueta | qualquer token de teste |
| POST | /v1/sandbox/financeiro/lancamentos | Simular lançamento no saldo | qualquer token de teste |
| PUT | /v1/sandbox/produtos/{sku}/estoque | Simular estoque | qualquer token de teste |
| POST | /v1/sandbox/conta/resetar | Resetar a conta de teste | qualquer token de teste |
Cores dos métodos
GET lê, sem alterar nada. POST cria.PATCH altera parte de um recurso. PUT substitui um recurso inteiro. DELETE remove.
