Quem sou eu
Confirma que o token funciona e mostra o que ele pode fazer. É a primeira chamada de toda integração.
GET/v1/eu
qualquer token
Quando usar
- Ao configurar a integração, para conferir token, ambiente e permissões.
- No início de cada execução, para parar cedo — com uma mensagem clara — se o token venceu ou perdeu uma permissão.
Não use como “ping” a cada poucos segundos: a chamada conta no limite.
Requisição
Sem parâmetros.
curl "https://api.otlshoes.com.br/v1/eu" \
-H "Authorization: Bearer otl_prod_SEU_TOKEN"curl "https://api-sandbox.otlshoes.com.br/v1/eu" \
-H "Authorization: Bearer otl_sbx_SEU_TOKEN"const resposta = await fetch('https://api.otlshoes.com.br/v1/eu', {
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/eu', {
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/eu');
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/eu');
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/eu",
headers={
"Authorization": "Bearer otl_prod_SEU_TOKEN",
},
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/eu",
headers={
"Authorization": "Bearer otl_sbx_SEU_TOKEN",
},
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.
Resposta
{
"parceiro": {
"nome": "Loja do João",
"loja": "João Calçados"
},
"integracao": {
"id": "cmuq5txm9000510arvq62c497",
"nome": "Bling – João Dev",
"criadaEm": "2026-10-01T20:23:15-03:00",
"expiraEm": "2026-10-31T20:23:15-03:00"
},
"permissoes": [
"conta:ler",
"produtos:ler"
],
"limite": {
"porMinuto": 60,
"restante": 59
},
"ambiente": "producao"
}| Campo | Tipo | Descrição |
|---|---|---|
parceiro.nome | texto | Nome da conta do parceiro. |
parceiro.loja | texto ou null | Nome da loja, se ele informou na ficha. |
integracao.id | texto | Identificador da integração dona deste token. |
integracao.nome | texto | O nome que o parceiro deu à integração. |
integracao.criadaEm | data | Quando a integração foi criada. |
integracao.expiraEm | data ou null | Quando o token vence. null = sem expiração. |
permissoes | lista de texto | As permissões efetivas: o que a integração pediu e o teto do parceiro ainda permite. Veja Permissões. |
limite.porMinuto | número | Chamadas por minuto permitidas ao parceiro. |
limite.restante | número | Quantas ainda cabem na janela atual. |
ambiente | texto | producao ou sandbox. |
Erros possíveis
Só os de autenticação — veja Usando o token.