Autenticação
Autentique cada requisição com um Bearer token da sua organização.
A autenticação é feita apenas pelo cabeçalho Authorization. Cookies não são aceitos, e o token não pode ser enviado na URL (como parâmetro de consulta). Todos os endpoints exigem o mesmo cabeçalho.
Authorization: Bearer pxn_live_…Bearer seguido do token. Requisições sem token ou com formato inválido recebem 401 unauthorized.
Por que apenas o cabeçalho
As URLs acabam nos logs de servidor e no cabeçalho Referer; um token levado na URL vaza por ali. Não aceitar cookies também elimina por completo a superfície de falsificação de requisição entre sites (CSRF).
URL base
https://api.proxynet.io/api/v1Primeira requisição
curl -H "Authorization: Bearer pxn_live_…" \
https://api.proxynet.io/api/v1/meA resposta traz o nome do token, seus escopos e a organização à qual ele está vinculado. Uma requisição a um endpoint para o qual o token não tem escopo retorna 403 insufficient_scope; quais endpoints cada escopo libera está na página Tokens e escopos.
Mantenha o token em segurança
- Guarde o token em uma variável de ambiente ou em um gerenciador de segredos.
- Use um token separado para cada integração; se um token vazar, você revoga apenas ele.
- Escolha apenas os escopos necessários. Um servidor de monitoramento não precisa do escopo
orders:write. - A criação e a revogação de tokens aparecem na página Atividade da organização.
Perguntas frequentes
Posso enviar o token na URL?
Não. Um parâmetro de consulta como ?token= não é aceito; apenas o cabeçalho Authorization é lido.
Posso chamar a API pelo navegador?
Não. A API não libera CORS para chamadas vindas do navegador. O painel Experimente! desta documentação envia as requisições pelo nosso próprio proxy; no seu front-end, faça a requisição a partir do seu próprio servidor.
Um token pode acessar mais de uma organização?
Não. O token pertence à organização em que foi criado. Para os serviços de outra organização, crie um token separado nessa organização.