Introdução - Gm Proxys

Bem-vindo à documentação oficial da API GmProxys — a interface programática para gerenciar proxies, controlar saldo, consultar localizações e monitorar uso.

URL Base

Todas as requisições devem ser feitas para a seguinte URL base:

https://api.gmproxys.com/v1

Autenticação

A API do GmProxys utiliza API Keys para autenticar as requisições. Envie sua chave no header X-API-Key em todas as chamadas. Você pode obter sua chave no painel da GmProxys.

Headers obrigatórios

Header	Valor
`X-API-Key`	`gm_SUA_CHAVE`
`Content-Type`	`application/json`

Exemplo

curl https://api.gmproxys.com/v1/proffile \
  -H "X-API-Key: gm_SUA_CHAVE" \
  -H "Content-Type: application/json"

const response = await fetch("https://api.gmproxys.com/v1/proffile", {
  headers: {
    "X-API-Key": "gm_SUA_CHAVE",
    "Content-Type": "application/json",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.gmproxys.com/v1/proffile",
    headers={
        "X-API-Key": "gm_SUA_CHAVE",
        "Content-Type": "application/json",
    },
)

data = response.json()

Nunca compartilhe sua API Key publicamente. Trate-a como uma senha.

Fluxo básico

O uso mais comum da API segue esta sequência:

Verifique seu saldo

Use GET /proffile para consultar o saldo disponível na sua conta.

Escolha a localização

Consulte os países, estados e cidades disponíveis para o tipo de proxy desejado.

Crie um proxy

Use POST /proxy informando balance, threads e a localização.

Gerencie o proxy

Liste, obtenha, edite ou delete seus proxies conforme necessário.

Acompanhe uso e saldo

Consulte o histórico de uso, o saldo e o histórico de saldo de cada proxy.

Endpoints disponíveis

Usuário

Consulte informações da conta autenticada e o saldo disponível.

Proxy

Crie, liste, edite, delete e monitore o uso dos seus proxies.

Saldo

Consulte saldo, histórico e gerencie o saldo de cada proxy.

Locais

Descubra países, estados e cidades disponíveis para cada tipo de proxy.

Limites e regras

Threads: ao criar um proxy, o valor de threads deve estar entre 1000 e 3000.
Saldo: informado em GB. Ex.: 30 = 30 GB.
Content-Type: sempre application/json.
Localização: ao editar (POST /update), envie apenas os campos que deseja alterar — todos exceto user_id são opcionais.

Erros

A API retorna erros no formato padrão JSON com os campos success e message.

401 — Token inválido

Retornado quando a X-API-Key está ausente, incorreta ou expirada.

{
  "success": false,
  "message": "Invalid API token."
}

402 — Saldo insuficiente

Retornado ao tentar criar um proxy sem saldo suficiente na conta (consulte o campo balance em GET /proffile).

{
  "success": false,
  "message": "Insufficient balance."
}

404 — Usuário da proxy inexistente

Retornado quando o user_id informado não existe ou foi digitado incorretamente. Aplica-se a: editar, histórico de uso, deletar, obter proxy, consultar saldo, histórico de saldo, adicionar saldo e remover saldo.

{
  "success": false,
  "message": "Proxy user not found."
}

​URL Base

​Autenticação

​Headers obrigatórios

​Exemplo

​Fluxo básico

​Endpoints disponíveis

Usuário

Proxy

Saldo

Locais

​Limites e regras

​Erros

​401 — Token inválido

​402 — Saldo insuficiente

​404 — Usuário da proxy inexistente

URL Base

Autenticação

Headers obrigatórios

Exemplo

Fluxo básico

Endpoints disponíveis

Limites e regras

Erros

401 — Token inválido

402 — Saldo insuficiente

404 — Usuário da proxy inexistente