API Pública

Como começar

Base URL

https://api.gooproxy.com

Todas as requisições são enviadas para este endereço base.

Autenticação

apiKey + sign

Autentique cada requisição com seu apiKey e sign.

Resposta

JSON

Todos os endpoints retornam um objeto JSON com code, msg e data.

Os exemplos abaixo usam placeholders. Substitua YOUR_API_KEY e YOUR_SIGN pelas credenciais obtidas no painel Gooproxy.

Autenticação

Endpoints GET aceitam as credenciais como parâmetros de query:

GET — Query

https://api.gooproxy.com/api/account/info?apiKey=YOUR_API_KEY&sign=YOUR_SIGN

Endpoints POST aceitam as credenciais como headers:

POST — Header

curl -X POST "https://api.gooproxy.com/api/proxy/buy-residential" \
  -H "apiKey: YOUR_API_KEY" \
  -H "sign: YOUR_SIGN"

Você obtém seu apiKey e sign no painel Gooproxy. Guarde-os com segurança e nunca os exponha em código público.

Formato de resposta

Requisições bem-sucedidas retornam code 200. Em erros, code é um código de erro de negócio e msg contém o motivo.

{
  "code": 200,
  "msg": "ok",
  "data": {}
}

Endpoints

GET/api/account/infoObter informações da conta

GET/api/account/wallet-balanceObter saldo da carteira

GET/api/account/traffic-balanceObter saldo de tráfego

GET/api/account/usage-statisticsEstatísticas de uso de tráfego

POST/api/account/create-accountCriar conta

GET/api/locations/countriesListar países

GET/api/locations/statesListar estados

GET/api/locations/citiesListar cidades

GET/api/locations/asnListar ASN

GET/api/proxy/locationsLocalizações ISP

POST/api/proxy/buy-residentialComprar tráfego residencial

GET/api/proxy-users/user-listListar usuários de proxy

POST/api/proxy-users/create-userCriar usuário de proxy

POST/api/proxy-users/update-userAtualizar usuário de proxy

POST/api/proxy-users/delete-userExcluir usuário de proxy

GET/api/proxy-users/usage-statisticsEstatísticas de uso do usuário

GET/api/proxy-users/usage-statistics-hourEstatísticas de uso do usuário (por hora)

GET/api/whitelisted-ips/ip-listListar IPs da whitelist

POST/api/whitelisted-ips/add-ipAdicionar IP à whitelist

POST/api/whitelisted-ips/delete-ipRemover IP da whitelist

GET/api/proxy/proxy-listListar proxies ISP

GET/api/proxy/expiration-timeObter tempo de expiração ISP

POST/api/order/order-listListar pedidos

POST/api/cdk/createCriar CDK

GET/api/cdk/listListar CDK

POST/api/cdk/revokeRevogar CDK

Códigos de erro

Códigos de erro de negócio comuns retornados pela API. Quando ocorre um erro, cada endpoint retorna a informação completa.

codemessage

200ok

10005Insufficient purchase quantity

10008Insufficient wallet balance

10010IP does not exist

10011Frequent operations, please try again later

10013sign error

10014apiKey error

10020username does not exist

10026The number of whitelists exceeds the limit

10027The IP format is abnormal

Como começar

Autenticação

Formato de resposta

Endpoints

Códigos de erro

Pronto para começar com a Gooproxy?