911Proxy OpenAPI

A chave de autenticação app_key pode ser visualizada na página inicial do centro pessoal após o login.

Por favor, guarde a chave com segurança, pois ela possui permissões de administrador da sua conta.

URLs Base:

https://api.911proxy.com

Métodos de Autenticação

Autenticação por App Key

Parâmetro POST:

app_key: {your_app_key}

Ou como parâmetro de consulta:

?app_key={your_app_key}

Formato de Resposta

Todas as interfaces retornam um formato JSON unificado:

{
	"code": 200,
	"message": "Operação bem-sucedida",
	"data": {}
}

code: Código de status, 200 indica sucesso, outros valores indicam falha
message: Mensagem de resposta (em chinês)
data: Dados de resposta

Authentication

Esta interface suporta os seguintes dois métodos de autenticação:

1. Bearer Token (JWT)

Passar o Token através do HTTP Header.

Exemplo de Header:

Authorization: Bearer <your_jwt_token>

Autenticação por API Key

Esta interface utiliza o método de autenticação por API Key.

O cliente precisa incluir o parâmetro app_key na solicitação, caso contrário, a solicitação será rejeitada.

Exemplo:

GET /api/example?app_key=your_app_key

POST /api/example?app_key=your_app_key
Content-Type: application/json

Gerenciamento de Contas Proxy

GET Lista de Contas Proxy

GET /api-gate-way/whitelist-account/list

Exemplo de Retorno

Resposta de Sucesso (200)

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"username": "string",
				"password": "string",
				"created_at": "string",
				"remark": "string",
				"product_type": 9,
				"usage_flow": 0,
				"limit_flow": 102400,
				"status": 0
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	responseCode	false	none	Código de status, 200 sucesso, 3 app_key inválida
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	none
»»» id	integer	false	none	Número da conta
»»» username	string	false	none	Nome da conta proxy
»»» password	string	false	none	Senha da conta proxy
»»» created_at	string	false	none	Data de adição
»»» remark	string	false	none	Observação
»»» product_type	productTypes	false	none	Tipo de plano: 9 Plano de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP de Data Center Estático, 25 IP Residencial Estático
»»» usage_flow	integer	false	none	Tráfego utilizado, unidade: KB
»»» limit_flow	integer	false	none	Limite de tráfego personalizado: unidade GB, máximo 102400, 0 sem limite
»»» status	integer	false	none	Status de ativação: 1 ativado, 0 desativado

Valores de Enumeração

Propriedade	Valor
product_type	9
product_type	11
product_type	14
product_type	25

POST Adicionar Conta Proxy

POST /api-gate-way/whitelist-account/add

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01:pass,user02:pass,user03:pass",
	"remark": "",
	"product_type": 9
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» accounts	body	string	Não	Conta e senha, preencha no formato username:password. Conta e senha suportam apenas números e letras, proibido inserir símbolos especiais ou espaços, separados por dois pontos. Suporta adição em lote, separados por vírgula em inglês (,).
» remark	body	string	Não	Descrição da conta proxy
» product_type	body	productTypes	Não	Tipo de plano: 9 Plano de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP de Data Center Estático, 25 IP Residencial Estático

Valores de Enumeração

Propriedade	Valor
» product_type	9
» product_type	11
» product_type	14
» product_type	25

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Excluir Conta Proxy

POST /api-gate-way/whitelist-account/delete

Observe que após a exclusão não é possível recuperar, o tráfego utilizado não poderá ser consultado. A exclusão tem um tempo de espera de aproximadamente 5 minutos, durante este período ainda podem ocorrer cobranças.

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» accounts	body	string	Não	Conta proxy, suporta apenas números e letras. Suporta operação em lote, separados por vírgula em inglês (,)

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Desativar Conta Proxy

POST /api-gate-way/whitelist-account/disable

A desativação tem um tempo de espera de aproximadamente 5 minutos, durante este período ainda podem ocorrer cobranças.

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» accounts	body	string	Não	Conta proxy, suporta apenas números e letras. Suporta operação em lote, separados por vírgula em inglês (,)

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Ativar Conta Proxy

POST /api-gate-way/whitelist-account/enable

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» accounts	body	string	Não	Conta proxy, suporta apenas números e letras. Suporta operação em lote, separados por vírgula em inglês (,)

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Alterar Senha da Conta Proxy

POST /api-gate-way/whitelist-account/change-password

Observe que após a alteração há um tempo de espera de 5 minutos, durante este período a senha antiga ainda pode ser usada normalmente.

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"password": "pass"
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» account	body	string	Não	Conta proxy, suporta apenas números e letras.
» password	body	string	Não	Nova senha da conta proxy, suporta apenas números e letras.

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Alterar Observação da Conta Proxy

POST /api-gate-way/whitelist-account/change-remark

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"remark": ""
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» account	body	string	Não	Conta proxy, suporta apenas números e letras.
» remark	body	string	Não	Nova observação da conta proxy, máximo 32 caracteres chineses ou 64 caracteres em inglês.

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

POST Alterar Limite de Tráfego da Conta Proxy

POST /api-gate-way/whitelist-account/change-limit

Observe que as estatísticas de tráfego podem ter um atraso de até 5 minutos, ou seja, o consumo real de tráfego pode exceder este limite.

Parâmetros do Body da Solicitação

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"limit": 0
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Não	none
» app_key	body	string	Não	Chave de autorização
» account	body	string	Não	Conta proxy, suporta apenas números e letras.
» limit	body	integer	Não	Limite de tráfego, unidade: GB, 0 para sem limite

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	null	false	none	none

Consulta de Logs de Tráfego

GET Tráfego Utilizado Resumido por Dia

GET /api-gate-way/user-usage-flow/total

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
app_key	query	string(password)	Sim	Chave de autenticação
start_time	query	string(Y-m-d H:i:s)	Não	Hora de início, pode ser preciso até segundos. Observe que o registro de logs tem um atraso de até 5 minutos. Padrão: últimos 7 dias.
end_time	query	string(Y-m-d H:i:s)	Não	Hora de término, pode ser preciso até segundos. Observe que o registro de logs tem um atraso de até 5 minutos. Padrão: hora atual.
username	query	string	Não	Nome da subconta, padrão consulta todas as contas, pode especificar subconta. Observe que se você adicionou subcontas com o mesmo nome, esta consulta retornará todos os registros de uso das contas proxy com o mesmo nome.
product_type	query	number	Não	Tipo de plano

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"day": "2022-08-01",
				"flow": 0
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	none
»»» day	string	false	none	Data
»»» flow	integer	false	none	Tráfego consumido, unidade KB

Consulta de Planos

GET Lista de Planos Adquiridos

GET /api-gate-way/user-product/list

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
app_key	query	string(password)	Sim	Chave de autenticação
trade_no	query	string	Não	Número do pedido, insira o número completo do pedido. Não suporta busca difusa.
page	query	number	Não	Paginação, padrão: 1
size	query	number	Não	Quantidade de itens por página, padrão: 20
product_type	query	number	Não	Tipo de plano

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"created_at": "2022-05-13 12:14:15",
				"expired_at": "2022-05-13 12:14:15",
				"product_type": 9,
				"trade_no": "2022051312134339861461465434",
				"order": {
					"created_at": "2022-05-13 12:13:43",
					"pay_at": "2022-05-13 12:13:43",
					"title": "入门级"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	none
»»» id	integer	false	none	Número do plano
»»» created_at	string	false	none	Data de ativação do plano
»»» expired_at	string	false	none	Data de expiração do plano, após expirar o tráfego não pode ser usado.
»»» product_type	productTypes	false	none	Tipo de plano: 9 Plano de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP de Data Center Estático, 25 IP Residencial Estático
»»» trade_no	string	false	none	Número de transação do pedido
»»» order	object	false	none	none
»»»» created_at	string	false	none	Data de criação do pedido
»»»» pay_at	string	false	none	Data de pagamento do pedido
»»»» title	string	false	none	Descrição do pedido
»» page	integer	false	none	Página atual
»» page_size	integer	false	none	Tamanho da página
»» total_count	integer	false	none	Quantidade total de registros
»» total_page	integer	false	none	Quantidade total de páginas

Valores de Enumeração

Atributo	Valor
product_type	9
product_type	11
product_type	14
product_type	25

GET Resumo de Pacotes do Usuário

GET /api-gate-way/user-product/summary

Obtém as informações de resumo estatístico dos pacotes do usuário, incluindo quantidade total, quantidade ativa, quantidade próxima do vencimento, quantidade vencida, etc.

Parâmetros da Requisição

Nome do Parâmetro	Tipo	Obrigatório	Descrição
app_key	string(password)	Sim	Chave de autenticação
product_type	integer	Não	Tipo de produto, suporta apenas: 9 (Pacote de Tráfego Dinâmico), 12 (Pacote de Tráfego IDC de Longo Prazo)

Resposta

{
	"code": 200,
	"msg": "Sucesso",
	"data": {
		"total": 1048576,
		"total_count": 5,
		"effective": 524288,
		"effective_count": 3,
		"effective_total": 786432,
		"effective_used": 262144,
		"temporary": 102400,
		"temporary_count": 1,
		"expired": 51200,
		"expired_count": 1,
		"used": 473088
	}
}

Estrutura de Dados da Resposta

Código de Status 200

Campo	Tipo	Descrição
total	integer	Quantidade total de tráfego/IP (unidade: KB)
total_count	integer	Número total de pacotes
effective	integer	Quantidade restante ativa (unidade: KB)
effective_count	integer	Número de pacotes ativos
effective_total	integer	Quantidade total ativa (unidade: KB)
effective_used	integer	Quantidade já utilizada nos pacotes ativos (unidade: KB)
temporary	integer	Quantidade total próxima do vencimento (vence em até 7 dias, KB)
temporary_count	integer	Número de pacotes próximos do vencimento (em até 7 dias)
expired	integer	Quantidade restante vencida (unidade: KB)
expired_count	integer	Número de pacotes vencidos
used	integer	Quantidade total utilizada (unidade: KB)

Extração de IP

GET Extrair IP

GET /api-gate-way/ip/v3

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
app_key	query	string(password)	Não	Chave de acesso
cc	query	string	Não	País ou região
state	query	string	Não	Província ou estado
city	query	string	Não	Cidade
format	query	string	Não	Formato de obtenção
lb	query	string	Não	Separador, válido apenas para formato text
num	query	number	Não	Quantidade a extrair
life	query	number	Não	Período de manutenção - minutos
ep	query	string	Não	Rede proxy

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			[
				"150.109.114.72:1140",
				"150.109.114.72:1141",
				"150.109.114.72:1142",
				"150.109.114.72:1143",
				"150.109.114.72:1144",
				"150.109.114.72:1145",
				"150.109.114.72:1146",
				"150.109.114.72:1147",
				"150.109.114.72:1148",
				"150.109.114.72:1149"
			]
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[any]	false	none	none

GET Lista de Cidades

GET /api-gate-way/ip/dynamic-citys

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"city": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	Lista
»»» name_zh_cn	string	false	none	Nome do país ou região
»»» name_en	string	false	none	Nome do país ou região
»»» continent_code	string	false	none	Código do continente
»»» country_code	string	false	none	Código do país ou região
»»» items	[object]	false	none	Província ou estado
»»»» city	string	false	none	Nome da cidade
»»»» state	string	false	none	Código do nome da província ou estado
»»»» continent_code	string	false	none	Código do continente
»»»» country_code	string	false	none	Código do país ou região

GET Busca de Cidades

GET /api-gate-way/ip/dynamic-citys/search

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
country_code	query	string	Sim	Código do país ou região
state	query	string	Sim	Código do estado ou província

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[string]	false	none	Lista

GET Lista de Estados

GET /api-gate-way/ip/dynamic-states

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	Lista
»»» name_zh_cn	string	false	none	Nome do país ou região
»»» name_en	string	false	none	Nome do país ou região
»»» continent_code	string	false	none	Código do continente
»»» country_code	string	false	none	Código do país ou região
»»» items	[object]	false	none	Província ou estado
»»»» state	string	false	none	Código do nome da província ou estado
»»»» continent_code	string	false	none	Código do continente
»»»» country_code	string	false	none	Código do país ou região

GET Busca de Estado/Província

GET /api-gate-way/ip/dynamic-states/search

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
country_code	query	string	Sim	Código do país ou região

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Solicitação bem-sucedida	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[string]	false	none	Lista

GET Extrair Lista de IPs Estáticos Adquiridos

GET /api-gate-way/ip/get-static-ip

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
country_code	query	string	Não	Código do país ou região
product_type	query	number	Não	Tipo de produto, 25: IP Residencial Estático, 14: IP de Data Center
trade_no	query	string	Não	Filtrar IP por número do pedido
page	query	number	Não	Número da página
size	query	number	Não	Quantidade por página
status	query	number	Não	Status, 1: válido, 2: inválido, 3: expirando em breve, 4: em manutenção

Valores de Enumeração

Propriedade	Valor
product_type	14
product_type	25
status	1
status	2
status	3
status	4

Exemplo de Retorno

Resposta 200

{}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	none	Inline

Estrutura de Dados de Retorno

GET Obter Quantidade de IPs Estáticos Disponíveis por Região

GET /api-gate-way/static-ip-region

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
isp	query	string	Não	Tipo de IP

Descrição do Tipo de IP

Tipo de IP	Descrição
1	IP Estático Residencial
0	IP Estático de Data Center

Exemplo de Retorno

Resposta 200

{
	"code": 200,
	"msg": "请求成功",
	"data": {
		"list": [
			{
				"code": "US",
				"number": 55
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	none	Inline

Estrutura de Dados de Retorno

Código de Status 200

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» list	[object]	false	none	none
»»» code	string	false	none	Código do país ou região
»»» number	integer	false	none	Quantidade

Gerenciamento de Pedidos

GET Lista de Pedidos

GET /api-gate-way/order/list

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
page_no	query	integer	Não	none
page_size	query	integer	Não	none
trade_no	query	string	Não	Número do pedido
status	query	integer	Não	Status do pedido
product_type	query	integer	Não	Tipo de produto

Descrição Detalhada

status: Status do pedido

Status	Descrição
0	Aguardando pagamento
1	Pago
2	Cancelado por timeout de pagamento
3	Reembolsado

product_type: Tipo de produto

Tipo de produto	Descrição
3	Recarga de saldo
9	Plano de tráfego dinâmico
11	Plano global dinâmico por tempo V2
12	Plano de tráfego IDC de longa duração
13	Plano de tráfego IP estático residencial
14	Plano IP estático de data center
15	Plano de tráfego ISP de longa duração
16	Plano de tráfego estático
17	Plano de quantidade de IP dinâmico
18	web-scraper
19	Renovação de IP estático
20	Cota de troca de IP estático
21	Plano de tráfego estático v2
24	Pacote adicional de tráfego estático
25	Plano IP estático residencial
26	Pedido complementar - Alguns canais de pagamento exigem que o usuário preencha manualmente o valor, como: criptomoeda. Se houver pagamento insuficiente, é necessário entrar em contato com o suporte para fazer o pagamento complementar através deste tipo de produto
27	Serp
28	Video

Valores de Enumeração

Propriedade	Valor
status	0
status	1
status	2
status	3
product_type	3
product_type	9
product_type	11
product_type	12
product_type	14
product_type	16
product_type	17
product_type	18
product_type	19
product_type	21
product_type	24
product_type	25
product_type	26
product_type	27
product_type	28

Exemplo de Retorno

Resposta 200

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"id": 0,
				"trade_no": "string",
				"product_id": 0,
				"product_name": "string",
				"total_fee": 0.1,
				"pay_fee": 0.1,
				"status": 0,
				"created_at": "2019-08-24T14:15:22Z"
			}
		],
		"pagination": {
			"total": 0,
			"page_no": 0,
			"page_size": 0,
			"total_pages": 0
		}
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Sucesso	Inline

{
    "pid": x, // Contate o suporte para obter
    "upids": "1,2,3,4,5,6", // Obtenha o ID correspondente de /api-gate-way/ip/get-static-ip
    "pm_id": 1 // Obtenha de /api-gate-way/payment/list
    "coupon_sn: "xxx", // Opcional - cupom
  }

Parâmetros do Body da Solicitação

{
	"pid": 0,
	"upids": "string",
	"amount": 0,
	"pm_id": 0,
	"region_list": "string",
	"coupon_sn": "string",
	"use_invitation_registration_discount": true,
	"renew_duration": 0,
	"product_sku_bandwidth_id": 0,
	"product_sku_concurrency_id": 0,
	"recharge_amount": 0
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Sim	none
» pid	body	integer	Sim	ID do plano
» upids	body	string	Não	Lista de IDs de planos para renovação
» amount	body	number	Não	Quantidade de planos para nova compra
» pm_id	body	integer	Sim	ID do método de pagamento
» region_list	body	string	Não	Especificar região + quantidade ao comprar IP estático
» coupon_sn	body	string	Não	Número do cupom
» use_invitation_registration_discount	body	boolean	Não	Usar desconto de registro por convite
» renew_duration	body	integer	Não	Duração da renovação - opcional para IP estático
» product_sku_bandwidth_id	body	integer	Não	Plano 11: ID do plano de largura de banda
» product_sku_concurrency_id	body	integer	Não	Plano 11: ID do plano de concorrência
» recharge_amount	body	integer	Não	Plano 3: Valor da recarga

Exemplo de Retorno

Resposta 200

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"trade_no": "string",
		"product_id": 0,
		"product_name": "string",
		"total_fee": 0.1,
		"pay_fee": 0.1,
		"status": 0,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Criado com sucesso	Inline

Estrutura de Dados de Retorno

POST Cancelar Pedido

POST /api-gate-way/order/close

Parâmetros do Body da Solicitação

{
	"trade_no": "string"
}

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
body	body	object	Sim	none
» trade_no	body	string	Sim	none

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Operação bem-sucedida	None

Gerenciamento de Usuários

GET Obter Informações do Usuário - Ainda não disponível

GET /api-gate-way/user/info

Exemplo de Retorno

Resposta 200

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"email": "[email protected]",
		"phone": "string",
		"balance": 0.1,
		"status": 0,
		"is_real_name": true,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Sucesso	Inline

Estrutura de Dados de Retorno

Gerenciamento de Pagamentos

GET Obter Lista de Métodos de Pagamento

GET /api-gate-way/payment/groups

Parâmetros da Solicitação

Nome	Localização	Tipo	Obrigatório	Descrição
trade_no	query	string	Não	Número do pedido - pode ser passado ao obter métodos de pagamento específicos para determinados pedidos

Exemplo de Retorno

Resposta 200

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"name": "支付方式分组",
				"logos": ["https://example.com/logo1.png", "https://example.com/logo2.png"],
				"items": [
					{
						"id": 1,
						"title": "title1",
						"logo": "https://example.com/logo1.png",
						"group": "online",
						"disabled": false,
						"min": 10,
						"max": 5000
					}
				]
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	Obtido com sucesso	Inline

Estrutura de Dados de Retorno

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
»» name	string	false	none	Nome do grupo
»» logos	string[]	false	none	Lista de ícones do grupo
»» items	object[]	false	none	Lista de itens do grupo
»»» id	integer	false	none	ID do método de pagamento
»»» title	string	false	none	Nome do método de pagamento
»»» logo	string	false	none	Logo do método de pagamento
»»» group	string	false	none	Identificador do grupo do método de pagamento
»»» disabled	boolean	false	none	Se está desabilitado (padrão `false`)
»»» min	number	false	none	Valor mínimo
»»» max	number	false	none	Valor máximo

Marketing

GET Proporção de Bônus de Recarga

GET /api-gate-way/activity/balance-recharge-gift-ratio

Proporção de bônus de recarga

Exemplo de Retorno

Resposta 200

{
	"code": 0,
	"msg": "操作成功",
	"data": {
		"list": [
			{
				"amount": 100,
				"ratio": 1.2
			}
		]
	}
}

Resultado do Retorno

Código de Status	Significado do Código	Descrição	Modelo de Dados
200	OK	OK	Inline

Estrutura de Dados de Retorno

Nome	Tipo	Obrigatório	Restrição	Descrição
» code	integer	false	none	Código de status, 200 sucesso, 3 app_key inválida, 156 conta não verificada
» msg	string	false	none	Mensagem de status
» data	object	false	none	none
» list	[object]	false	none	none
»» amount	integer	false	none	Valor da recarga
»» ratio	number	false	none	Proporção de recarga

Descrição das Estruturas de Dados (Schemas)

productTypes (Tipos de Planos)

Campo	Tipo	Descrição
product_type	integer	Tipo de plano

Descrição dos valores possíveis:

Valor	Significado
9	Plano de Tráfego Residencial Dinâmico
11	IP Residencial Dinâmico
14	IP de Data Center Estático
25	IP Residencial Estático

API Key (Chave de Autenticação)

Usada para autenticação de interface, passe através do parâmetro Query.

Nome do Parâmetro	Localização	Tipo	Obrigatório	Descrição
app_key	query	string	Sim	Chave de autenticação

Campos de Resposta Comuns

responseCode

Campo	Tipo	Exemplo	Descrição
code	integer	200	Código de status (200 sucesso, 3 indica app_key inválida)

responseMsg

Campo	Tipo	Exemplo	Descrição
message	string	success	Mensagem de resposta

Resposta de Sucesso (SuccessResponse)

{
	"code": 0,
	"message": "操作成功",
	"data": {}
}

Resposta de Erro (ErrorResponse)

{
	"code": 400,
	"message": "参数错误",
	"errors": {}
}

User

{
	"id": 0,
	"email": "[email protected]",
	"phone": "string",
	"balance": 0.1,
	"status": 0,
	"is_real_name": true,
	"created_at": "2019-08-24T14:15:22Z"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
email	string(email)	false	none	none
phone	string	false	none	none
balance	number(float)	false	none	none
status	integer	false	none	none
is_real_name	boolean	false	none	none
created_at	string(date-time)	false	none	none

Order

{
	"id": 0,
	"trade_no": "string",
	"product_id": 0,
	"product_name": "string",
	"total_fee": 0.1,
	"pay_fee": 0.1,
	"status": 0,
	"created_at": "2019-08-24T14:15:22Z"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
trade_no	string	false	none	none
product_id	integer	false	none	none
product_name	string	false	none	none
total_fee	number(float)	false	none	none
pay_fee	number(float)	false	none	none
status	integer	false	none	none
created_at	string(date-time)	false	none	none

Product

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
name	string	false	none	none
type	integer	false	none	none
price	number(float)	false	none	none
description	string	false	none	none

WhiteIp

{
	"id": 0,
	"ip": "string",
	"remark": "string",
	"created_at": "2019-08-24T14:15:22Z"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
ip	string	false	none	none
remark	string	false	none	none
created_at	string(date-time)	false	none	none

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
username	string	false	none	none
limit	integer	false	none	none
used	integer	false	none	none
status	integer	false	none	none

Coupon

{
	"id": 0,
	"name": "string",
	"code": "string",
	"discount": 0.1,
	"expire_time": "2019-08-24T14:15:22Z"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
name	string	false	none	none
code	string	false	none	none
discount	number(float)	false	none	none
expire_time	string(date-time)	false	none	none

Article

{
	"id": 0,
	"title": "string",
	"content": "string",
	"created_at": "2019-08-24T14:15:22Z"
}

Nome	Tipo	Obrigatório	Restrição	Descrição
id	integer	false	none	none
title	string	false	none	none
content	string	false	none	none
created_at	string(date-time)	false	none	none

Pagination

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}

Nome	Tipo	Obrigatório	Restrição	Descrição
total	integer	false	none	none
page_no	integer	false	none	none
page_size	integer	false	none	none
total_pages	integer	false	none	none