API OTL Shoes

Ligue seu ERP, sua loja ou sua automação ao catálogo, ao preço de atacado e ao estoque da OTL — sem copiar e colar do painel.

A API é para parceiros do programa de dropshipping da OTL Shoes e para quem programa para eles. Com ela, o sistema do parceiro consulta o catálogo com preço de atacado e estoque por numeração sempre atualizados.

curl "https://api.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true" \
  -H "Authorization: Bearer otl_prod_SEU_TOKEN"

curl "https://api-sandbox.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true" \
  -H "Authorization: Bearer otl_sbx_SEU_TOKEN"

const resposta = await fetch('https://api.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true', {
  headers: {
    Authorization: 'Bearer otl_prod_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

const resposta = await fetch('https://api-sandbox.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true', {
  headers: {
    Authorization: 'Bearer otl_sbx_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

<?php
$ch = curl_init('https://api.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_prod_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

<?php
$ch = curl_init('https://api-sandbox.otlshoes.com.br/v1/produtos?limite=3&comEstoque=true');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_sbx_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

import requests

resposta = requests.get(
    "https://api.otlshoes.com.br/v1/produtos",
    headers={
        "Authorization": "Bearer otl_prod_SEU_TOKEN",
    },
    params={
        "limite": 3,
        "comEstoque": True
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

import requests

resposta = requests.get(
    "https://api-sandbox.otlshoes.com.br/v1/produtos",
    headers={
        "Authorization": "Bearer otl_sbx_SEU_TOKEN",
    },
    params={
        "limite": 3,
        "comEstoque": True
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

Testar agora no ambiente de testes

A chamada é feita de verdade, do seu navegador para a API de testes (https://api-sandbox.otlshoes.com.br/v1). Use um token otl_sbx_…: ele fica só nesta aba, e some ao fechá-la. Token de produção não é aceito aqui.

Token de testeGET

O que dá para fazer hoje

Recurso	O que entrega
Produtos	Catálogo com preço de atacado, o preço de venda da loja do parceiro, fotos e estoque por numeração
Estoque	Só o estoque de um produto — leve, para consultar com frequência
Categorias e numerações	O que você precisa para filtrar o catálogo e montar o SKU de cada variação
Conta	Dados da loja do parceiro e o endereço de remetente
Clientes	A agenda de clientes finais do parceiro: listar, criar, alterar e remover
Pedidos	Criar pedido, acompanhar o status, informar valor de venda, despesas, rastreio e comprovante
Financeiro	O saldo do parceiro com a OTL e o extrato de lançamentos
Webhooks	Avisos automáticos de estoque, preço, nome, categoria e do andamento dos pedidos

Etiquetas de envio e a vitrine do HUB estão em desenvolvimento. O changelog registra cada novidade.

Como funciona, em três passos

O parceiro pede o acesso à equipe OTL e cria uma integração no painel dele.
O painel mostra um token de acesso — uma única vez. É esse token que o programador recebe. A senha do parceiro nunca sai das mãos dele.
O sistema chama a API mandando o token no cabeçalho Authorization.

Comece por Primeiros passos: do token à primeira resposta em cinco minutos.

O essencial antes de programar

URL base: https://api.otlshoes.com.br/v1https://api-sandbox.otlshoes.com.br/v1. Troque entre produção e sandbox no seletor do topo — todos os exemplos acompanham.
Formato: JSON, com campos em português (precoAtacado, numeracoes).
Dinheiro é texto, com duas casas: "139.90". Nunca número.
Limite: 60 chamadas por minuto por parceiro, salvo combinação diferente com a OTL.
Erros têm sempre o mesmo formato e um código estável para o seu sistema tratar.

Você é programador e ainda não tem um parceiro?

O acesso à API é sempre por meio de um parceiro aprovado. Quem quer se tornar parceiro começa pelo cadastro em dropshipping.otlshoes.com.br.