Referência da API

A API da Proxynet permite consultar os serviços de proxy da sua organização a partir do seu próprio sistema, abrir novos pedidos e gerenciar os serviços existentes. Todas as requisições e respostas são JSON; a autenticação é feita com um Bearer token.

URL base

https://api.proxynet.io/api/v1

Use este endereço em todas as chamadas entre servidores. O endereço do painel (app.proxynet.io) fica atrás da proteção da Cloudflare e pode aplicar uma verificação de navegador a requisições vindas de alguns IPs de servidor; api.proxynet.io serve apenas a API e não faz essa verificação. O token e os caminhos são os mesmos nos dois.

Autenticação

Adicione o cabeçalho Authorization a cada requisição. Cookies não são aceitos, e o token não pode ser enviado na URL.

curl -H "Authorization: Bearer pxn_live_…" \
  https://api.proxynet.io/api/v1/me

Para a criação de tokens e os escopos, consulte as páginas Autenticação e Tokens e escopos.

Formato da resposta

As respostas de sucesso retornam os dados em data; as listas trazem as informações de paginação em meta.

{
  "data": [ … ],
  "meta": { "total": 6, "limit": 25, "offset": 0, "has_more": false }
}

Os erros vêm no mesmo envelope em todos os endpoints; tome decisões pelo campo code, não pelo texto da mensagem. A lista completa de códigos está na página Erros.

Endpoints

Os endpoints estão organizados na ordem do ciclo de vida de um pedido: primeiro veja no catálogo o que você pode comprar, depois abra um pedido e acompanhe o serviço aberto nas páginas do produto.

Organização

• GET/meInformações do token e da organização · Retorna a validade do token, seus escopos, a organização a que ele pertence, o plano, o saldo e o limite de requisições.

Catálogo e preços

• GET/catalogCatálogo · Retorna em uma única resposta tudo o que pode ser comprado, com os preços do seu plano.
• GET/locationsLocalizações · Retorna as localizações disponíveis e o estoque em tempo real.
• GET/target-urlsDomínios de destino · Retorna os domínios que podem ser escolhidos no modo direcionado.
• GET/stockVerificação de estoque · Executa a mesma verificação de estoque feita na criação do pedido.
• GET/pricingCotação de preço · Calcula o valor a ser debitado para um tipo, uma quantidade e opções adicionais.

Pedidos

• GET/ordersLista de pedidos · Lista os serviços de proxy da organização; os cinco tipos vêm juntos.
• POST/ordersCriar pedido · Abre o mesmo pedido que o painel abre e debita o valor do seu saldo.
• GET/orders/{id}Detalhes do pedido · Retorna o estado, os dias restantes e os contadores de uso de um serviço.

Endpoints por produto

Os caminhos são os mesmos entre os produtos (/orders/…); as páginas de produto restringem o corpo e os exemplos aos campos daquele produto. Para ir à mesma operação de outro produto, use o menu lateral.

Nos produtos por IP, você escolhe a localização e a quantidade, e o serviço é renovado em períodos de 30 dias; nos produtos por GB, há um único endereço de gateway, a segmentação por país/cidade é feita com o Gerador de endpoint e o uso é debitado do saldo por GB.