OpenAPIOpenAPI
  • English
  • 简体中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • English
  • 简体中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • ProxyCC OpenAPI

ProxyCC OpenAPI

Por favor, faça login para visualizar a chave de autenticação app_key na página inicial da sua central pessoal.

Por favor, mantenha a chave em segurança, pois ela tem privilégios de administrador para a sua conta.

URLs base:

https://api.proxy.cc

Método de autenticação

Autenticação da Chave do Aplicativo

Parâmetros POST:

app_key: {your_app_key}

Ou como um parâmetro de consulta:

?app_key={your_app_key}

Formato de resposta

Todas as interfaces retornam um formato JSON unificado:

{
	"code": 200,
	"message": "操作成功",
	"data": {}
}
  • code: Código de status, 200 indica sucesso, outros valores indicam falha
  • message: Mensagem de resposta (Chinês)
  • data: Dados de resposta

Autenticação

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

1. Token de Portador (JWT)

Passe o Token através do cabeçalho HTTP.

Exemplo de Cabeçalho:

Authorization: Bearer <your_jwt_token>

Autenticação por Chave de API

Esta interface usa o método de Chave de API para autenticação.

O cliente precisa incluir o parâmetro app_key na requisição, caso contrário, a requisiçã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

OBTER Lista de Contas Proxy

GET /open/whitelist-account/list

Exemplo de Retorno

Resposta Bem-Sucedida (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
			}
		]
	}
}

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação bem-sucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» coderesponseCodefalsonenhumCódigo de status, 200 sucesso, 3 app_key inválida
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumnenhum
»»» idinteirofalsonenhumNúmero da conta
»»» nome de usuáriostringfalsonenhumNome da conta do agente
»»» senhastringfalsonenhumSenha da conta do agente
»»» created_atstringfalsonenhumAdicionar Tempo
»»» observaçãostringfalsonenhumObservações
»»» product_typetiposDeProdutofalsonenhumTipo de Pacote, 9 Pacote de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP de Datacenter Estático, 25 IP Residencial Estático
»»» usage_flowinteirofalsonenhumTráfego Usado, Unidade: KB
»»» limite_fluxointeirofalsonenhumLimite de tráfego personalizado: Unidade GB, máximo 102400, 0 para ilimitado
»»» statusinteirofalsonenhumStatus ativado: 1 ativado, 0 desativado

Valor Enum

PropriedadeValor
product_type9
product_type11
product_type14
product_type25

POST Adicionar Conta Proxy

POST /open/whitelist-account/add

Parâmetros do Corpo da Requisição

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

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» accountscorpostringNãoSenha da conta, preencha no formato nome de usuário:senha. Apenas números e letras são suportados para a conta e senha. Não insira nenhum símbolo especial ou espaços. Separe a conta e a senha com dois pontos. A adição em lote é suportada e as contas de proxy são separadas por vírgulas (,) em inglês.
» observaçãocorpostringNãoDescrição da conta proxy
» product_typecorpotiposDeProdutoNãoTipo de Pacote, 9 Pacote de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP de Datacenter Estático, 25 IP Residencial Estático

Valor Enum

PropriedadeValor
» product_type9
» product_type11
» product_type14
» product_type25

Exemplo de retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação bem-sucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Excluir Conta Proxy

POST /open/whitelist-account/delete

Observe que a exclusão é irreversível, e o tráfego usado e outros dados não podem ser consultados após a exclusão. A exclusão leva aproximadamente 5 minutos, e cobranças ainda podem ser incorridas durante este período.

Parâmetros do Corpo da Requisição

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

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contascorpostringNãoConta proxy, suporta apenas números e letras. Suporta operações em lote, separe as contas proxy com vírgulas inglesas (,).

Exemplo de retorno

Resposta 200

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

Resultado do Retorno

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEmbutido

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» códigointeirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválidas, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Desativar Conta Proxy

POST /open/whitelist-account/disable

A desativação tem um período de espera de aproximadamente 5 minutos, durante o qual as taxas ainda podem ser cobradas.

Parâmetros do Corpo da Requisição

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

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contascorpostringNãoConta proxy, suporta apenas números e letras. Suporta operações em lote, separe as contas proxy com vírgulas inglesas (,).

Exemplo de retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEmbutido

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsExplicação
» códigointeirofalsonenhumCódigo de status, 200 sucesso, 3 app_key inválida, 156 conta não autenticada com nome real
» msgstringfalsenenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Ativar Conta Proxy

POST /open/whitelist-account/enable

Parâmetros do Corpo da Requisição

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

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contascorpostringNãoConta proxy, suporta apenas números e letras. Suporta operações em lote, separe as contas proxy com vírgulas inglesas (,).

Exemplo de retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEmbutido

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» códigointeirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválida, 156 conta não autenticada com nome real
» msgstringfalsenenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Modificar senha da conta proxy

POST /open/whitelist-account/change-password

Por favor, note que há um período de espera de 5 minutos após a modificação, durante o qual a senha antiga ainda pode ser usada normalmente.

Parâmetros do Corpo da Requisição

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

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contacorpostringNãoConta proxy, suporta apenas números e letras.
» senhacorpostringNãoNova senha para a conta proxy, apenas números e letras são suportados.

Exemplo de retorno

Resposta 200

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

Resultado do retorno

Código de statusSignificado do código de statusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Modificar observações da conta proxy

POST /open/whitelist-account/change-remark

Parâmetros do Corpo da Requisição

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

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contacorpostringNãoConta proxy, suporta apenas números e letras.
» observaçãocorpostringNãoNova nota da conta do agente, dentro de 32 caracteres chineses ou 64 caracteres ingleses.

Exemplo de retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKRequisição Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosnulofalsonenhumnenhum

POST Modificar Limite de Tráfego da Conta do Agente

POST /open/whitelist-account/change-limit

Por favor, note que as estatísticas de tráfego podem ter um atraso de até 5 minutos, o que significa que o consumo real de tráfego pode exceder este limite.

Parâmetros do Corpo da Requisição

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

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoNãonenhum
» app_keycorpostringNãoChave de Autorização
» contacorpostringNãoConta proxy, suporta apenas números e letras.
» limitecorpointeiroNãoLimite de tráfego, unidade: GB, 0 significa sem limite

Exemplo de retorno

Resposta 200

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

Resultado do retorno

Código de statusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválidas, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosnulofalsonenhumnenhum

Consulta de Log de Tráfego

GET Tráfego de Uso Agregado por Dia

GET /open/user-usage-flow/total

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
app_keyconsultastring(senha)SimChave de autenticação
hora_inicialconsultastring(A-m-d H:i:s)NãoHora de início, com precisão de segundos. Observe que há um atraso de até 5 minutos no registro. Padrão em 7 dias.
hora_de_términoconsultastring(A-m-d H:i:s)NãoHora de término, precisa ser precisa até o segundo. Observe que há um atraso de até 5 minutos no registro. O padrão é a hora atual.
nome de usuárioconsultastringNãoNome da subconta, o padrão é consultar todas as contas, pode especificar uma subconta. Observe que, se você adicionou subcontas com o mesmo nome, esta consulta retornará todos os registros de uso para contas proxy com o mesmo nome.
product_typeconsultanúmeroNãoTipo de Pacote

Exemplo de Retorno

Resposta 200

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

Resultado do Retorno

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválida, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumnenhum
»»» diastringfalsonenhumData
»»» fluxointeirofalsonenhumConsumo de tráfego, unidade: KB

Consulta de pacote

GET lista de pacotes comprados

GET /open/user-product/list

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
app_keyconsultastring(senha)SimChave de Autenticação
trade_noconsultastringNãoNúmero do pedido, por favor, insira o número completo do pedido. A pesquisa difusa não é suportada.
páginaconsultanúmeroNãoPaginação, padrão: 1
tamanhoconsultanúmeroNãoNúmero de itens por página, padrão: 20
product_typeconsultanúmeroNãoTipo de Pacote

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 de Retorno

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválidos, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumnenhum
»»» idinteirofalsonenhumNúmero do Pacote
»»» created_atstringfalsonenhumTempo de Ativação do Pacote
»»» expired_atstringfalsonenhumTempo de Expiração do Pacote, após a expiração, o tráfego não poderá ser usado.
»»» product_typetiposDeProdutofalsonenhumTipo de Pacote, 9 Pacote de Tráfego Residencial Dinâmico, 11 IP Residencial Dinâmico, 14 IP Estático de Datacenter, 25 IP Residencial Estático
»»» trade_nostringfalsonenhumNúmero da transação do pedido
»»» pedidoobjetofalsonenhumnenhum
»»»» created_atstringfalsonenhumHora de criação do pedido
»»»» pay_atstringfalsonenhumHora de pagamento do pedido
»»»» titlestringfalsonenhumDescrição do pedido
»» páginainteirofalsonenhumPágina atual
»» page_sizeinteirofalsonenhumTamanho da página
»» total_countinteirofalsonenhumNúmero total de registros
»» total_pageinteirofalsonenhumNúmero total de páginas

Valor Enum

PropriedadeValor
product_type9
product_type11
product_type14
product_type25

Extração de IP

GET Extrair IP

GET /open/ip/v3

Parâmetros de solicitação

NomeLocalizaçãoTipoObrigatórioDescrição
app_keyconsultastring(senha)NãoChave de Acesso
ccconsultastringNãoPaís ou região
estadoconsultastringNãoEstado ou Província
cidadeconsultastringNãoCidade
formatoconsultastringNãoObter Formato
lbconsultastringNãoSeparador, válido apenas para formato de texto
numconsultanúmeroNãoQuantidade de Extração
vidaconsultanúmeroNãoManter Ciclo - Minutos
epconsultastringNãoRede de 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"
			]
		]
	}
}

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKRequisição Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[qualquer]falsonenhumnenhum

OBTER Lista de Cidades

GET /open/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 StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválida, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumLista
»»» name_pt_brstringfalsonenhumNome do país ou região
»»» nome_enstringfalsonenhumNome do país ou região
»»» código_do_continentestringfalsonenhumCódigo do continente
»»» código_do_paísstringfalsonenhumCódigo do país ou região
»»» itens[objeto]falsonenhumEstado ou província
»»»» cidadestringfalsonenhumNome da cidade
»»»» estadostringfalsonenhumCódigo do nome da província ou estado
»»»» código_do_continentestringfalsonenhumCódigo do continente
»»»» código_do_paísstringfalsonenhumCódigo do país ou região

GET Pesquisa de Cidade

GET /open/ip/dynamic-citys/search

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
código do paísconsultastringSimCódigo do país ou região
estadoconsultastringSimCódigo do estado ou província

Exemplo de retorno

Resposta 200

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

Resultado de retorno

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválidas, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[string]falsonenhumLista

GET Lista de estados

GET /open/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 statusSignificado do código de statusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumLista
»»» name_pt_brstringfalsonenhumNome do país ou região
»»» nome_enstringfalsonenhumNome do país ou região
»»» código_do_continentestringfalsonenhumCódigo do continente
»»» código_do_paísstringfalsonenhumCódigo do país ou região
»»» itens[objeto]falsonenhumEstado ou província
»»»» estadostringfalsonenhumCódigo do nome da província ou estado
»»»» código_do_continentestringfalsonenhumCódigo do continente
»»»» código_do_paísstringfalsonenhumCódigo do país ou região

OBTER pesquisa de estado/província

GET /open/ip/dynamic-states/search

Parâmetros de Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
código do paísconsultastringSimCó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 statusSignificado do código de statusDescriçãoModelo de Dados
200OKSolicitação Bem-SucedidaEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválido, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[string]falsonenhumLista

GET Extrair Lista de IPs Estáticos Adquiridos

GET /open/ip/get-static-ip

Parâmetros de solicitação

NomeLocalizaçãoTipoObrigatórioDescrição
código do paísconsultastringNãoCódigo do país ou região
product_typeconsultanúmeroNãoTipo de Produto, 25: IP Residencial Estático, 14: IP de Data Center
trade_noconsultastringNãoFiltrar IPs por Número de Pedido
páginaconsultanúmeroNãoNúmero da página
tamanhoconsultanúmeroNãoTamanho da página
estadoconsultanúmeroNãoStatus, 1: válido, 2: inválido, 3: expirando em breve, 4: em manutenção

Valor Enum

PropriedadeValor
product_type14
product_type25
estado1
estado2
estado3
estado4

Exemplo de retorno

Resposta 200

{}

Resultado de retorno

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKnenhumEm linha

Estrutura de Dados de Retorno


GET Obtenha o número de IPs estáticos na área de vendas

GET /open/static-ip-region

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
ispconsultastringNãoTipo de IP

Descrição do Tipo de IP

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

Exemplo de retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKnenhumEm linha

Estrutura de Dados de Retorno

Código de Status 200

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de Status, 200 Sucesso
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» lista[objeto]falsonenhumnenhum
»»» códigostringfalsonenhumCódigo do país ou região
»»» númerointeirofalsonenhumQuantidade

Gestão de Pedidos

OBTER Lista de Pedidos

GET /open/order/list

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
página_noconsultainteiroNãonenhum
page_sizeconsultainteiroNãonenhum
trade_noconsultastringNãoNúmero do pedido
estadoconsultainteiroNãoStatus do pedido
product_typeconsultainteiroNãoTipo de produto

Descrição detalhada

status: Status do pedido

StatusDescrição
0Pagamento pendente
1Pago
2Cancelado devido ao tempo limite
3Reembolsado

product_type: Tipo de produto

Tipo de ProdutoDescrição
3Recarregar Saldo
9Pacote de Tráfego Dinâmico
11Pacote Dinâmico Global Horário V2
12Pacote de tráfego IDC de longo prazo
13Pacote de tráfego IP estático residencial
14Pacote de IP estático para data center
15Pacote de tráfego de ISP de longo prazo
16Pacote de Tráfego Estático
17Pacote de Quantidade de IP Dinâmico
18web-scraper
19Renovação de IP Estático
20Cota de Substituição de IP Estático
21Pacote de Tráfego Estático v2
24Pacote Adicional de Tráfego Estático
25Pacote de IP Estático Residencial
26Conclusão do Pedido - Alguns canais de pagamento exigem que os usuários insiram o valor manualmente, como: moeda virtual. Se houver alguma diferença, você precisa entrar em contato com o atendimento ao cliente para fazer um pagamento suplementar através deste produto
27Serp
28Vídeo

Valor Enum

PropriedadeValor
estado0
estado1
estado2
estado3
product_type3
product_type9
product_type11
product_type12
product_type14
product_type16
product_type17
product_type18
product_type19
product_type21
product_type24
product_type25
product_type26
product_type27
product_type28

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 Retornado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSucessoEm linha

Estrutura de Dados de Retorno


POST Criar Pedido

POST /open/order/create

Devido à variedade de pacotes e às diferentes configurações para cada pacote, preencha os parâmetros de acordo com a situação real. Parâmetros preenchidos incorretamente podem fazer com que a criação do pedido falhe.

exemplos:

Renovar IP Estático

{
    "pid": x, // 联系客服获取
    "upids": "1,2,3,4,5,6", // 从 /end-point/ip/get-static-ip 获取对应的ID
    "pm_id": 1 // 从 /end-point/payment/list 获取
    "coupon_sn: "xxx", // 可选 优惠券
  }

Parâmetros do Corpo da Requisiçã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 Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoSimnenhum
» pidcorpointeiroSimID do pacote
» upidscorpostringNãoLista de IDs de Pacotes de Renovação
» quantidadecorponúmeroNãoNova Quantidade do Pacote
» pm_idcorpointeiroSimID do método de pagamento
» region_listcorpostringNãoEspecifique a região + quantidade ao comprar um IP estático
» coupon_sncorpostringNãoCódigo do cupom
» use_invitation_registration_discountcorpobooleanoNãoSe deve usar o desconto de registro de convite
» renew_durationcorpointeiroNãoDuração da renovação - IP estático opcional
» product_sku_bandwidth_idcorpointeiroNãoPacote 11: ID do pacote de largura de banda
» product_sku_concurrency_idcorpointeiroNãoPacote 11: ID do Pacote Concorrente
» recharge_amountcorpointeiroNãoPacote 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 StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKCriado com sucessoEm linha

Estrutura de Dados de Retorno


POST Cancelar Pedido

POST /open/order/close

Parâmetros do Corpo da Requisição

{
	"trade_no": "string"
}

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
corpocorpoobjetoSimnenhum
» trade_nocorpostringSimnenhum

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKOperação bem-sucedidaNenhum

Gerenciamento de usuários

GET Obter Informações do Usuário - Ainda Não Aberto

GET /open/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 Retornado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKSucessoEm linha

Estrutura de Dados de Retorno


Gestão de Pagamentos

GET Obter Lista de Métodos de Pagamento

GET /open/payment/groups

Parâmetros da Requisição

NomeLocalizaçãoTipoObrigatórioDescrição
trade_noconsultastringNãoNúmero do pedido - pode ser transmitido quando alguns pedidos precisam obter um método de pagamento específico

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 StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKObtido com sucessoEm linha

Estrutura de Dados de Retorno

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválida, 156 conta não autenticada com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
»» nomestringfalsonenhumNome do Grupo
»» logotiposstring[]falsonenhumLista de Ícones do Grupo
»» itensobject[]falsonenhumLista de Itens Agrupados
»»» idinteirofalsonenhumID do Método de Pagamento
»»» títulostringfalsonenhumNome do Método de Pagamento
»»» logotipostringfalsonenhumLogotipo do Método de Pagamento
»»» groupstringfalsonenhumIdentificador de Agrupamento do Método de Pagamento
»»» disabledbooleanofalsonenhumSe deve desativar (o padrão é falso)
»» mín.númerofalsonenhumQuantidade mínima
»»» máx.númerofalsonenhumQuantidade máxima

Marketing

OBTER Taxa de Bônus de Recarga

OBTER /open/activity/balance-recharge-gift-ratio

Taxa de Bônus de Recarga

Exemplo de Retorno

Resposta 200

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

Retornar Resultado

Código de StatusSignificado do Código de StatusDescriçãoModelo de Dados
200OKOKEm linha

Estrutura de Dados de Retorno

NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
» codeinteirofalsonenhumCódigo de status: 200 Sucesso, 3 app_key inválidas, 156 contas não autenticadas com nome real
» msgstringfalsonenhumMensagem de status
» dadosobjetofalsonenhumnenhum
» listagem[objeto]falsonenhumnenhum
»» quantidadeinteirofalsonenhumValor do Recarregamento
»» proporçãonúmerofalsonenhumProporção de Recarregamento

Descrição da Estrutura de Dados (Esquemas)

tipos de produto (tipos de pacote)

CampoTipoDescrição
product_typeinteiroTipo de pacote

Descrição dos valores opcionais:

ValorSignificado
9Pacote de Tráfego Residencial Dinâmico
11IP Residencial Dinâmico
14IP Estático de Datacenter
25IP Estático Residencial

Chave de API

Usada para autenticação de interface, por favor, passe-a através do parâmetro de consulta.

Nome do parâmetroLocalizaçãoTipoObrigatórioDescrição
app_keyconsultastringSimChave de Autenticação

Campos de Resposta Comuns

responseCode

CampoTipoExemploDescrição
códigointeiro200Código de status (200 significa sucesso, 3 significa app_key inválida)

responseMsg

CampoTipoExemploDescrição
mensagemstringsucessoInformações da Resposta

Resposta bem-sucedida (SuccessResponse)

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

Resposta de Erro (ErrorResponse)

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

Usuário

{
	"id": 0,
	"email": "[email protected]",
	"phone": "string",
	"balance": 0.1,
	"status": 0,
	"is_real_name": true,
	"created_at": "2019-08-24T14:15:22Z"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
e-mailstring(e-mail)falsonenhumnenhum
telefonestringfalsonenhumnenhum
saldonúmero(flutuante)falsonenhumnenhum
estadointeirofalsonenhumnenhum
is_real_namebooleanofalsonenhumnenhum
created_atstring(data-hora)falsonenhumnenhum

Pedido

{
	"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"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
trade_nostringfalsonenhumnenhum
product_idinteirofalsonenhumnenhum
product_namestringfalsonenhumnenhum
total_feenúmero(flutuante)falsonenhumnenhum
pay_feenúmero(flutuante)falsonenhumnenhum
estadointeirofalsonenhumnenhum
created_atstring(data-hora)falsonenhumnenhum

Produto

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
nomestringfalsonenhumnenhum
tipointeirofalsonenhumnenhum
preçonúmero(flutuante)falsonenhumnenhum
Immersive Translatestringfalsonenhumnenhum

WhiteIp

{
	"id": 0,
	"ip": "string",
	"remark": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
ipstringfalsonenhumnenhum
observaçãostringfalsonenhumnenhum
created_atstring(data-hora)falsonenhumnenhum

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
nome de usuáriostringfalsonenhumnenhum
limiteinteirofalsonenhumnenhum
usadointeirofalsonenhumnenhum
estadointeirofalsonenhumnenhum

Cupom

{
	"id": 0,
	"name": "string",
	"code": "string",
	"discount": 0.1,
	"expire_time": "2019-08-24T14:15:22Z"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
nomestringfalsonenhumnenhum
códigostringfalsonenhumnenhum
descontonúmero(flutuante)falsonenhumnenhum
tempo_expiracaostring(data-hora)falsonenhumnenhum

Artigo

{
	"id": 0,
	"title": "string",
	"content": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
NomeTipoObrigatórioRestriçãoNome ChinêsDescrição
idinteirofalsonenhumnenhum
títulostringfalsonenhumnenhum
conteúdostringfalsonenhumnenhum
created_atstring(data-hora)falsonenhumnenhum

Paginação

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}
NomeTipoObrigatórioRestriçãoNome ChinêsExplicação
totalinteirofalsonenhumnenhum
página_nointeirofalsonenhumnenhum
page_sizeinteirofalsonenhumnenhum
total_pagesinteirofalsonenhumnenhum