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

title: NSocks language_tabs:

  • shell: Shell
  • http: HTTP
  • javascript: JavaScript
  • ruby: Ruby
  • python: Python
  • php: PHP
  • java: Java
  • go: Go toc_footers: [] includes: [] search: true code_clipboard: true highlight_theme: darkula headingLevel: 2 generator: "@tarslib/widdershins v4.0.30"

NSocks

O código de autenticação app_key pode ser visualizado na página principal do seu perfil após a sua autenticação.

Faça o seu uso com segurança, pois o seu acesso é gerenciado por um administrador.

forma de certificação

Acreditação da chave da aplicação

Parâmetros POST:

app_key: {aqui a sua chave de aplicativo}

ou como parâmetro de consulta:

?app_key={sua chave de aplicativo}

formato de resposta

Todas as interfaces retornam um formato JSON unificado:

{
"code": 200,
"message": "Operação bem-sucedida",
"dados": {}
}
  • code: código de estado, 200 significa sucesso, os outros valores significam falha
  • message: Mensagem de resposta (em chinês)
  • data: dados da resposta

URLs de base:

  • < a id = 0 > https://api.nsocks.com : < a id = 1 > https://api.nsocks.com

Autenticação

  • Autenticação HTTP, escopo: bearer

  • Chave de API (apiKeyAuth)

    • Nome do parâmetro: app_key, em: query. O nome é suportado para GET/POST

gestão de contas de agência

GET lista de contas de proxy

GET /ep/whitelist-account/list

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
      {
"id": 0,
"username": "string"
"senha": "string"
"created_at": "string",
"observação": "string"
"tipo do produto": 9,
"uso_flow": 0,
"limit_flow": 102400,
status: 0
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigocodificação da respostafalsonãoCódigo de estado, 200 Sucesso, 3 app_key inválido
» mensagemstringfalsonãocomunicação de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» idinteirofalsonãonúmero de conta
»»» nome de utilizadorstringfalsonãonome do agente
»»» senhastringfalsonãosenha do conto proxy
»»» criado emstringfalsonãotempo de adição
»»» observaçãostringfalsonãocomentário
»»» tipo do produtotipos de produtosfalsonãoTipo de pacote, 9 pacotes de fluxo de dados dinâmicos, 11 IP de fluxo de dados dinâmico, 14 IP de data center estático, 25 IP de data center estático
»»» fluxo de usointeirofalsonãoO fluxo já foi usado, em KB
»»» limite fluxointeirofalsonãoLimite de tráfego personalizado: até 102400 GB por unidade, 0 não limitado
»»» statusinteirofalsonãoEstá ativo: 1 Ativo, 0 Inativo

enumar valores

propriedadevalor
tipo_de_produto9
tipo_de_produto11
tipo do produto14
tipo do produto25

POST Adicionar uma conta de proxy.

POST /ep/whitelist-account/add

Parâmetros de corpo

{
"app_key": "stringstringstringstringstringst",
"contas": "user01:pass,user02:pass,user03:pass"
"observação": "",
"tipo do produto": 9
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contascorpostringnãoCaso tenha uma conta e senha, digite o formato username:password. A conta e a senha só podem conter números e letras, sem nenhuma símbolo especial ou espaço, e sem coluna de vírgula. A conta e a senha podem ser adicionadas em massa. A vírgula (,) é o símbolo que separa as contas de proxy.
» observaçãocorpostringnãoDescrição do conto de agência
» tipo de produtocorpotipos de produtosnãoTipos de pacotes, 9 pacotes de fluxo de dados dinâmicos, 11 IP de fluxo de dados dinâmico, 14 IP de data center estático, 25 IP de data center estático

enumar valores

propriedadevalor
» tipo de produto9
» tipo de produto11
» tipo de produto14
» tipo do produto25

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãocomunicação de estado
» dadosnullfalsonãonão

POST Excluir conta proxy

POST /ep/whitelist-account/delete

Tenha em atenção que a eliminação não é restaurável, não é possível verificar o uso de tráfego, etc. O tempo de espera é de cerca de 5 minutos, durante o qual ainda podem haver custos.

Parâmetros de corpo

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

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contascorpostringnãoCaso de agência, só pode conter números e letras. Suporta operações em grupo, separados por vírgula (,)

Retornando o exemplo

200 Resposta

{
"cod": 200,
"msg": "string",
"dados": null
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosnullfalsonãonão

O POST desativou o proxy

POST /ep/whitelist-account/disable

O desligamento pode levar a uma espera de cerca de 5 minutos, que ainda pode custar.

Parâmetros de corpo

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

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contascorpostringnãoCaso de agência, só pode conter números e letras. Suporta operações em grupo, separados por vírgula (,)

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "texto",
"dados": null
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãocomunicação de estado
» dadosnullfalsonãonão

ENABLE POST A PROXIMITY ACCOUNT

POST /ep/whitelist-account/enable

Parâmetros de corpo

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

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contascorpostringnãoCada conta proxy só pode conter números e letras. Suporta operações em massa, separadas por vírgula (,)

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãocomunicação de estado
» dadosnullfalsonãonão

POST alterar a senha do proxy

POST /ep/whitelist-account/change-password

Tenha em mente que, após a alteração, haverá um tempo de espera de 5 minutos, durante o qual a nova senha não será mais aceita.

Parâmetros de corpo

{
"app_key": "stringstringstringstringstringst",
"conta": "usuário"
"senha": "pass"
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contacorpostringnãoCaso tenha uma conta de proxy, só pode usar números e letras.
» senhacorpostringnãoNovo nome de usuário para conta de agência, só pode conter números e letras.

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriorestringirnome chinêsexplicação
» códigointeirofalsonãoCódigos de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosnullfalsonãonão

POST alterar a nota do agente

POST /ep/whitelist-account/change-remark

Parâmetros de corpo

{
"app_key": "stringstringstringstringstringst",
"conta": "usuário"
"observação": ""
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contacorpostringnãoCaso seja necessário, o nome do agente deve ser apenas de letras e números.
» notacorpostringnãoNovas notas para contas de agência, com 32 caracteres em chinês ou 64 caracteres em inglês.

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriorestringirnome chinêsexplicação
» códigointeirofalsonãoCódigos de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosnullfalsonãonão

POST alterar o limite de tráfego para o proxy

POST /ep/whitelist-account/change-limit

Tenha em atenção que a estatística do tráfego pode ter uma lógica de atraso de até 5 minutos, ou seja, o tráfego real pode exceder esta limitação.

Parâmetros de corpo

{
"app_key": "stringstringstringstringstringst",
"conta": "usuário"
"limite": 0
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contacorpostringnãoCaso seja necessário, o nome do agente deve ser apenas de letras e números.
» limitecorpointeironãoLimitar o fluxo, em GB, 0 é sem limite

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosnullfalsonãonão

POST alterar a conta do proxy

POST /ep/proxy-account/change

Modifique a senha, as notas, as limitações de tráfego, as limitações de tráfego diário, o estado de atividade ou o interruptor de UDP do seu agente.

Parâmetros de corpo

{
"app_key": "string",
"conta": "string"
"senha": "string"
"observação": "string"
"limit": 0
"limit_diario": 0,
"status": 0,
"udp": 0
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» contacorpostringnãonome do agente
» senhacorpostringnãoNova senha, de 6 a 16 dígitos ou letras; não alterada sem transmitir
» observaçãocorpostringnãonova nota
» limitecorpointeironãolimiar de tráfego, em GB, 0 significa não limitado
» limite diáriocorpointeironãoLimite de tráfego diário, em GB, 0 significa não limitado
» statuscorpointeironãoativo
» udpcorpointeironãoO suporte de switches no UDP só é válido para os tipos de pacotes 14, 16, 21 e 25

enumar valores

propriedadevalor
» status0
» status1
» udp0
» udp1

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, bem-sucedido
» mensagemstringfalsonãocomunicação de estado
» dadosnullfalsonãonão

lista de IP white list

GET A LIST OF WHITE LIST IP

GET /ep/proxy-ip/list

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
tipo_de_produtoconsultainteironãonúmero de tipo de pacote

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
      {
"IP": "1.1.1.1"
"comentário": "string"
"tipo_de_produto": 0,
"created_at": "string"
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãocomunicação de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» ipstringfalsonãoIPs da lista de ameaças
»»» observaçãostringfalsonãocomentário
»»» tipo do produtointeirofalsonãotipo de pacote
»»» criado emstringfalsonãodata de criação

POST Adicionar uma lista de IP

POST /ep/proxy-ip/add

Parâmetros de corpo

{
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"observação": "string"
"tipo_de_produto": 0,
"user_product_id": 0
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» ipscorpostringnãoIPs da lista de ameaças que precisam ser adicionadas, separadas por vírgula ou espaço em vários casos
» observaçãocorpostringnãocomentário
» tipo de produtocorpointeironãonúmero de tipo de pacote
» id_produto_usercorpointeironãoID do pacote de usuários, obrigatório para o tipo de pacote 11

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, bem-sucedido
» mensagemstringfalsonãocomunicação de estado
» dadosnullfalsonãonão

POST Excluir lista de IPs

POST /ep/proxy-ip/delete

Parâmetros de corpo

{
"app_key": "string",
"ips": "1.1.1.1,2.2.2.2",
"tipo_de_verificação": "string",
"verificação": "string"
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetonãonão
» app_keycorpostringnãochave de autorização
» ipscorpostringnãoIPs da lista branca a ser removida, separados por vírgula em inglês
» tipo de verificaçãocorpostringnãotipo de verificação: telefone, e-mail, wechat, totp
» código de verificaçãocorpostringnãocódigos de verificação

Retornando o exemplo

200 Resposta

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

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãomensagens de estado
» dadosnullfalsonãonão

consultas de logs de tráfego

GET atração de tráfego por dia

GET /ep/user-usage-flow/total

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
app_keyconsultastring(password)simchave de autenticação
data de inícioconsultastring(Y-m-d H:i:s)nãoO tempo de início pode ser preciso até a secção. Observe que o registro tem uma latência de até 5 minutos. O tempo padrão é de até 7 dias.
fim_de_timeconsultastring(Y-m-d H:i:s)nãoO tempo é preciso até a secção. Note que o registro tem uma latência de até 5 minutos. O tempo atual é o padrão.
usuárioconsultastringnãoNome da conta subterrânea, por padrão, consulta todas as contas, mas pode especificar uma conta subterrânea. Observe que se você adicionar uma conta subterrânea com o mesmo nome, a consulta retornará todos os registros de uso de contas subterrâneas com o mesmo nome.
tipo do produtoconsultanúmeronãotipo de pacote

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
      {
"dia": "2022-08-01"
"fluxo": 0
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãocomunicado de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» diastringfalsonãodata
»»» fluxointeirofalsonãoconsumo de tráfego, em KB

consulta de pacotes

GET lista de pacotes comprados

GET /ep/user-product/list

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
app_keyconsultastring(senha)simchave de autenticação
comércio semconsultastringnãoNº de pedido, digite o número completo do pedido. Não é possível fazer uma busca em ambiguidades.
páginaperguntanúmeronãoPaginado, padrão: 1
tamanhoconsultanúmeronãoQuantidade de paginas, por padrão: 20
tipo_de_produtoconsultanúmeronãotipo de pacote

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
      {
"id": 0,
"created_at": "2022-05-13 12:14:15"
"expired_at": "2022-05-13 12:14:15"
"tipo do produto": 9,
"trade_no": "2022051312134339861461465434"
"ordem": {
"nome": "ordem",
"created_at": "2022-05-13 12:13:43"
"pagamento": "2022-05-13 12:13:43"
"título": "Início"
        }
      }
],
"pagina": 1
"pagina_tamanho": 20,
"total_count": 0,
"total_page": 0
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» idinteirofalsonãonúmero de pacote
»»» criado emstringfalsonãodata de início do pacote
»»»expirado_atstringfalsonãoO pacote expira e não é possível usar o fluxo após a data de expiração.
»»» tipo_de_produtotipos de produtosfalsonãoTipos de pacotes, 9 pacotes de fluxo de dados dinâmicos para residências, 11 IP dinâmicos para residências, 14 IP de data center estáticos, 25 IP de data center estáticos
»»» comércio semstringfalsonãonúmero de transação de ordem
»»» pedirobjetofalsonãonão
»»»» criado emstringfalsonãohora de criação da ordem
»»»» pagarstringfalsonãoTempo de pagamento de pedidos
»»»»stringfalsonãodescrição da ordem
»» páginainteirofalsonãoPagina atual
»» página da páginainteirofalsonãotamanho da página
»» total_countinteirofalsonãototal de registros
»» total_pageinteirofalsonãoquantidade total de páginas

enumar valores

propriedadevalor
tipo do produto9
tipo_de_produto11
tipo_de_produto14
tipo do produto25

GET dados agregados do pacote de usuários

GET /ep/user-product/summary

Obter informações agregadas sobre os pacotes de usuários, incluindo o total, o valor válido, o valor de prazo, o valor expirado, etc.

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
app_keyconsultastring(senha)simchave de autenticação
tipo_de_produtoconsultainteironãotipo de produto, só suporta 9 (paket de tráfego dinâmico), 12 (paket de tráfego de longo prazo de IDC)

enumar valores

propriedadevalor
tipo_de_produto9
tipo_de_produto12

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "completo",
"dados": {
"nome": "Dados",
"total": 1048576
"total_count": 5
"eficaz": 524288
"quantidade efetiva": 3
"total": 786432
"usado efetivamente": 262144
"temporário": 102400,
"temporário": 1
"vencido": 51200,
"numero_de_vencimento": 1
"usados": 473088
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigos de estado, 200 OK, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» totalinteirofalsonãofluxo / total de IP (em KB)
»» total_countinteirofalsonãototal de pacotes
»» eficazinteirofalsonãoquantidade restante válida (em KB)
»» número de efetivosinteirofalsonãoquantidade de pacotes válidos
»» total efetivointeirofalsonãoquantidade total válida (em KB)
»» efetivamente usadointeirofalsonãoquantidade de uso efetivo (em KB)
»» temporáriointeirofalsonãoQuantidade total de tempo de vencimento (de 7 dias até o vencimento, em KB)
»» número temporáriointeirofalsonãoQuantidade de pacotes com prazo de validade (prazo de validade de 7 dias)
»» expirouinteirofalsonãoQuantidade restante de tempo de validade (em KB)
»» número de prazosinteirofalsonãoquantidade de pacotes expirados
»» usadointeirofalsonãototal used (em KB)

extrair IP

GET para extrair o IP

GET /ep/ip/v3

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
app_keyconsultastring(senha)simchave de acesso
ccconsultastringnãopaís ou região
estadoconsultastringnãoprovincia ou estado
cidadeconsultastringnãocidade
formatoconsultastringnãoobter o formato
lbconsultastringnãointervalo, válido apenas para texto
númeroperguntanúmeronãoquantidade extraída
vidaconsultanúmeronãoCiclo de manutenção - minutos
epperguntastringnãorede de agências

enumar valores

propriedadevalor
epus
ephk
epde

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
      [
"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 os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[qualquer]falsonãonão

GET lista dinâmica de cidades regionais V4

GET /ep/ip/dcl4

Para obter uma lista de cidades por nome de usuário, é necessário ter uma autenticação de login e o perfil deve pertencer ao usuário atual

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
usuárioconsultastringsimnome de usuário do conto de agente

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados": {
"nome": "Data",
"cache": true,
"lista": [
"lista":
      {
"cidade": "Londres",
"Área": "US",
"Estado": "Califórnia"
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãocomunicação de status
» dadosobjetofalsonãonão
»» cachebooleanfalsonãoé de cache
»» lista[object]falsonãonão
»»» Citystringfalsonãocidade
»»» áreastringfalsonãoregião
»»» Estadostringfalsonãoestado

GET lista dinâmica de regiões, estados e províncias V4

GET /ep/ip/dsl4

Para obter uma lista de estados com base no nome de usuário, é necessário fazer login e o perfil deve estar do usuário atual

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
usuárioconsultastringsimnome de usuário do conto de agência

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"cache": true,
"lista": [
"lista":
      {
"cidade": "Londres",
"Área": "US",
"Estado": "Califórnia"
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriorestringirnome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãocomunicado de estado
» dadosobjetofalsonãonão
»» cachebooleanfalsonãoé de cache
»» lista[object]falsonãonão
»»» Citystringfalsonãocidade
»»» áreastringfalsonãoregião
»»» Estadostringfalsonãoestado

GET lista dinâmica de cidades regionais/estaduais e subregional V4

GET /ep/ip/dal4

Obtenha uma lista de estados e cidades com o nome de usuário, agrupada por regiões. É necessário autenticação de login e o perfil deve pertencer ao usuário atual

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
usuárioconsultastringsimnome de usuário do contêiner

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"cache": true,
"lista": [
"lista":
      {
"Área": "US",
"estados": [
"estados":
          {
"estado": null,
"cidades": null
          }
        ]
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãocomunicação de estado
» dadosobjetofalsonãonão
»» cachebooleanfalsonãoé de cache
»» lista[object]falsonãolista de regiões
»»» áreastringfalsonãocódigo regional
»»» estados[object]falsonãolista de estados
»»»» Estadostringfalsonãonome do estado
»»»» cidades[string]falsonãoLista de cidades

LISTA DE CITIES GET

GET /ep/ip/dynamic-citys

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados": {
"nome": "Dados",
"lista": [
"lista":
      {
"nome_zh_cn": "Estados Unidos",
"nome_en": "Estados Unidos"
"codinho": "NA",
"country_code": "US",
"items": [
"item1", "item2", "item3", "item4", "item5", "item6", "item7", "item8", "item9", "item10", "item11", "item12", "item13", "item14", "item15", "item16", "item17", "item18", "item19", "item20", "item21", "item22", "item23", "item24", "item25", "item26", "item27", "item28", "item29", "item30", "item31", "item32", "item33", "item34", "item35", "item36", "item37", "item38", "item39", "item40", "item41", "item42", "item43", "item44", "item45", "item46", "item47", "item48", "item49", "item50", "item51", "item52", "item53", "item54", "item55", "item56", "item57", "item58", "item59", "item60", "item61", "item62", "item63", "item64", "item65", "item66", "item67", "item68", "item69", "item70", "item71", "item72", "item73", "item74", "item75", "item76", "item77", "item78", "item79", "item80", "item81", "item82", "item83", "item84", "item85", "item86", "item87", "item88", "item89", "item90", "item91", "item92", "item93", "item94", "item95", "item96", "item97", "item98", "item99", "item100", "item101", "item102", "item10
          {
"cidade": null,
"estado": null,
"codinho": null,
"country_code": null
          }
        ]
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãocomunicação de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãolista
»»» nome_zh_cnstringfalsonãonome do país ou região
»»» nome_enstringfalsonãonome do país ou região
»»» código do continentestringfalsonãocódigo do continente
»»» país códigostringfalsonãoCódigo de país ou região
»»» itens[object]falsonãoprovincia ou estado
»»»» cidadestringfalsonãonome da cidade
»»»» estadostringfalsonãoCódigo de nome de estado
»»»» código do continentestringfalsonãocódigo do continente
»»»» país códigostringfalsonãoCódigo de país ou região

Pesquisar cidades com GET

GET /ep/ip/dynamic-citys/search

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
código do paísconsultastringsimCódigo de país ou região
estadoconsultastringsimCódigo do estado ou da província

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
"string"
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[string]falsonãolista

GET lista de estados

GET /ep/ip/dynamic-states

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados": {
"nome": "Data",
"lista": [
"lista":
      {
"nome_zh_cn": "Estados Unidos",
"nome_en": "Estados Unidos"
"codinho": "NA",
"country_code": "US",
"items": [
"item1", "item2", "item3", "item4", "item5", "item6", "item7", "item8", "item9", "item10", "item11", "item12", "item13", "item14", "item15", "item16", "item17", "item18", "item19", "item20", "item21", "item22", "item23", "item24", "item25", "item26", "item27", "item28", "item29", "item30", "item31", "item32", "item33", "item34", "item35", "item36", "item37", "item38", "item39", "item40", "item41", "item42", "item43", "item44", "item45", "item46", "item47", "item48", "item49", "item50", "item51", "item52", "item53", "item54", "item55", "item56", "item57", "item58", "item59", "item60", "item61", "item62", "item63", "item64", "item65", "item66", "item67", "item68", "item69", "item70", "item71", "item72", "item73", "item74", "item75", "item76", "item77", "item78", "item79", "item80", "item81", "item82", "item83", "item84", "item85", "item86", "item87", "item88", "item89", "item90", "item91", "item92", "item93", "item94", "item95", "item96", "item97", "item98", "item99", "item100", "item101", "item102", "item10
          {
"estado": null,
"continente_code": null,
"country_code": null
          }
        ]
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãolista
»»» nome_zh_cnstringfalsonãonome do país ou região
»»» nome_enstringfalsonãonome do país ou região
»»» código do continentestringfalsonãocódigo da região
»»» país códigostringfalsonãoCódigo de país ou região
»»» itens[object]falsonãoprovincia ou estado
»»»» estadostringfalsonãoCódigo de nome de estado
»»»» código do continentestringfalsonãocódigo do continente
»»»» país códigostringfalsonãoCódigo de país ou região

CHEGUE A BUSCA DO ESTADO/PROVÍCIA

GET /ep/ip/dynamic-states/search

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
código do paísconsultastringsimCódigo de país ou região

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "string",
"dados":
"lista": [
"lista":
"string"
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKpedirInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200 sucesso, 3 app_key inválido, 156 conta não autenticada
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[string]falsonãolista

GET recupera a lista de IP estáticos comprados

GET /ep/ip/get-static-ip

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
código do paísconsultastringnãoCódigo de país ou região
tipo_de_produtoconsultanúmeronãotipo de produto, 25: IP para residências estáticas, 14: IP para centros de dados
comércio semconsultastringnãoFiltrar IP por número de pedido
páginaconsultanúmeronãonúmero de página
tamanhoconsultanúmeronãoquantidade por página
statusconsultanúmeronãostatus, 1: válido, 2: inválido, 3: próximo a expiração, 4: em manutenção

enumar valores

propriedadevalor
tipo do produto14
tipo do produto25
status1 - 2 - 3 - 4

Retornando o exemplo

200 Resposta

{}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKnãoInline

retornar a estrutura de dados

GET Obter o número de IP estáticos disponíveis em uma região

GET /ep/ip/static-ip-region

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
ispconsultainteironãofiltrar pelo ISP, não transmitir, não filtrar (1 por padrão, com exceção de 1/4/5)
asnconsultainteironãoretorna os dados do grupo ASN
exclusivoconsultainteironãoEstima-se que o estoque seja exclusivo

descrição detalhada

isp: filtrar o ISP, não filtrar se não for transmitido (1/4/5, excepto 1 como padrão)

valordescrição
0IP estático (IDC) para o centro de dados
1IP estático (ISP) para casa

asn: Se deseja retornar os dados do grupo de ASN

valordescrição
0Não retornar dados do grupo ASN (padrão)
1Retornar dados do grupo ASN

exclusivo: Se o estoque é contabilizado como exclusivo

valordescrição
0Por grupo de usuários/colaboradores atual (definido por padrão)
1Exclui todos os IPs atribuídos, contabilizando apenas os disponíveis

enumar valores

propriedadevalor
isp0
isp1
asn0
asn1
exclusivo0
exclusivo1

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "A solicitação foi bem-sucedida",
"dados": {
"nome": "Data",
"lista": [
"lista":
      {
"cod": "US",
"numero": 55
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

Retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, bem-sucedido
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» códigostringfalsonãoCódigo de país ou região
»»» númerointeirofalsonãoquantidade

GET Obtenha o host_pool com suporte para países

GET /ep/host-pool/regions

Consulte a lista de países atendidos pelo serviço host_pool.

A interface é para cenários de extrato aleatório de dados IP de data centers, com pontos de tráfego, com base na quantidade de data centers disponíveis no país, não suporta filtragem de ASN, ISP, stock privado, e não suporta excluir IP com registro de compras.

Retornando o exemplo

200 Resposta

{
"code": 200,
"msg": "A solicitação foi bem-sucedida",
"dados": {
"nome": "Data",
"lista": [
"lista":
      {
"cod": "US",
"numero": 55
"nome_zh_cn": "Estados Unidos",
"nome_en": "Estados Unidos",
"square_flag": "https://example.com/static/flags/us.png"
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKA solicitação foi bem-sucedidaInline

retornar a estrutura de dados

Código de estado 200

nometipoobrigatóriocondiçãonome chinêsexplicação
» códigointeirofalsonãoCódigo de estado, 200, sucesso
» mensagemstringfalsonãomensagens de estado
» dadosobjetofalsonãonão
»» lista[object]falsonãonão
»»» códigostringfalsonãoCódigo de país ou região, alfa-2 da ISO 3166-1
»»» númerointeirofalsonãoQuantidade de IP dos centros de dados disponíveis para o site atual
»»» nome_zh_cnstringfalsonãonome chinês do país ou região
»»» nome_enstringfalsonãoNome em inglês do país ou região
»»»stringfalsonãoURL da imagem de bandeira quadrada

gestão de pedidos

PAGAR LISTA DE COMPRAS

GET /ep/order/list

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
página_nãoconsultainteironãonão
tamanho da páginaconsultainteironãonão
comércio semconsultastringnãonúmero de ordem
data de inícioconsultastring(data e horanãoData e hora de início (incluindo), por exemplo 2024-01-01 00:00:00
fim_de_timeconsultastring(data e horanãohorário de encerramento (excluindo)
statusconsultainteironãostatus da ordem
tipo_de_produtoconsultainteironãotipo de produto
faturaconsultainteironãoEstágio do faturamento: 0 não limitado 1 faturamento feito -1 faturamento não feito (pode ser feito novamente)
pagar taxa_statusconsultainteironãoFiltragem de compras: 1 excedente, 2 compras de compras

descrição detalhada

status: estado da ordem

estadodescrição
0Ainda não foi pagada
1paginado
2Cancelado sem pagamento de prazo
3Reembolsado

product_type: tipo de produto

tipo de produtodescrição
3Reabastecer
9Pakete de tráfego dinâmico
11Pakete de Global Pack Dynamic V2
12Pakete de tráfego de longo prazo de IDC
13Pakete de tráfego IP estático para residências
14Pacote de IP estático para data center
15Pacote de tráfego de longo prazo para a ISP
16Pacote de fluxo estático
17Pacote de números IP dinâmicos
18escravador de web
19Férias de IP estático
20Cota de troca de IP estático
21Pacote de fluxo estático v2
24Pakete de fluxo dinâmico
25Pakete IP estáticos para residências
26Fatura - alguns canais de pagamento exigem que os usuários preencham o valor manual, como bônus virtuais, e, se houver uma falha, eles devem entrar em contato com o serviço de atendimento para que o valor seja reembolsado com esse produto.
27Serp
28Vídeo

enumar valores

propriedadevalor
status0
status1
status2
status3
tipo do produto3
tipo do produto9
tipo do produto11
tipo do produto12
tipo do produto14
tipo do produto16
tipo_de_produto17
tipo do produto18
tipo do produto19
tipo do produto21
tipo do produto24
tipo do produto25
tipo do produto26
tipo do produto27
tipo_de_produto28
fatura-1
fatura0
fatura1
pagar taxa_status1
pagar taxa_status2

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados":
"lista": [
"lista":
      {
"id": 0,
"trade_no": "string",
"out-trade-no": "string",
"produto_id": 0,
"tipo_de_produto": 0,
"quantidade": 0,
"unit_price": 0.1,
"total fee": 0.1,
"comissão de bens": 0.1,
"comissão": 0.1,
"desconto": 0.1,
"comissão de tratamento": 0.1,
"taxa de reembolso": 0.1,
"pm_id": 0,
"pm_title": "string"
"pm_logo": "string",
"status": 0,
"título": "string"
"detalhe": "string"
"region_desc": "string"
"pagamento": "2019-08-24T14:15:22Z",
"data_time": 0,
"created_at": "2019-08-24T14:15:22Z"
"valor_de_pagação_status": 0,
"faturas": {}
      }
],
"paginacao": {
"pagina": "pagina",
"total": 0,
"pagina": 0,
"pagina_tamanho": 0
"total_pages": 0
    }
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKconhecimentoInline

retornar a estrutura de dados

POST cria pedido

POST /ep/order/create

Por conta da grande variedade de pacotes e das diferentes configurações de cada um, os parâmetros devem ser preenchidos de acordo com a realidade. Se não forem preenchidos de acordo com a realidade, a criação do pedido pode ser impossível.

exemplos:

IP estático para retenção

{
"pid": "ID do pacote", // obtido do /ep/product
"upids": "1,2,3,4,5,6", // Obtenha os campos de id correspondentes do /ep/ip/get-static-ip
"pm_id": 1 // obtido do /ep/payment/list ou /ep/payment/groups
  }

Comprar um imóvel IP em casa estática

{
"pid": "ID do pacote", // obtido do interface /ep/product
"pm_id": ID da forma de pagamento, // obtido do /ep/payment/list ou /ep/payment/groups
"region_list": "JP,15,333|DE,10,444|US,5,555" // Formato: região, quantidade, ASN | região, quantidade, ASN (ASN é opcional)
}

Comprando IP para um centro de dados estático

{
"pid": "ID do pacote", // obtido do interface /ep/product
"pm_id": ID da forma de pagamento, // obtido do /ep/payment/list ou /ep/payment/groups
"region_list": "JP,15,333|DE,10,444|US,5,555" // Formato: região, quantidade, ASN | região, quantidade, ASN (ASN é opcional)
}

acumulação de fluxo de compras de imóveis dinâmicos

{
"pid": "ID do pacote", // obtido do interface /ep/product
"pm_id": ID do método de pagamento // obtido do /ep/payment/list ou /ep/payment/groups
}

Fluxo de rotas estático

{
"pid": "ID do pacote", // obtido do interface /ep/product
"pm_id": ID da forma de pagamento // obtido do /ep/payment/list ou /ep/payment/groups
}

Academia de compras de tráfego dinâmico e infindável

{
"pid": "ID do pacote", // obtido do /ep/product
"pm_id": ID da forma de pagamento, // obtido do /ep/payment/list ou /ep/payment/groups
"productskuBandwidthId": "ID de especificação de banda larga",
"productsku_concurrency_id": ID de especificação de concorrência
}

recompra de saldo

{
"pid": "ID do pacote", // obtido do /ep/product
"pm_id": ID da forma de pagamento, // obtido do /ep/payment/list ou /ep/payment/groups
"valor": valor de reabastecimento
}

Parâmetros de corpo

{
"pid": 0
"upids": "string"
"quantidade": 0
"pm_id": 0,
"region_list": "string",
"coupon_sn": "string",
"use_invitation_registration_discount": true,
"renew_duration": 0,
"product_sku_bandwidth_id": 0,
"productsku_concurrency_id": 0,
"productSKU_duration_id": 0,
"etd": 1,
"quantia_de_reparação": 0
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetosimnão
» pidcorpointeirosimID do pacote, o campo id que é retornado pelo interface /ep/product
» upidscorpostringnãoLista de IDs de planos de continuidade (divididos por virgola) do campo id, retornado pelo interface /ep/user-product/list ou /ep/ip/get-static-ip
» quantidadecorponúmeronãoquantidade de pacotes novos comprados
» idcorpointeirosimID de método de pagamento, que é um campo de id retornado pelo /ep/payment/list ou /ep/payment/groups
» lista de regiõescorpostringnãoPara comprar um IP estático, digite a região + o número de assinatura + o número de assinatura, no formato: região, número de assinatura, número de assinatura
» cupon_sncorpostringnãonúmero de cupom
» usar invitação_registração_descontocorpobooleannãoSeja um parceiro
» duracao_de_renovacaocorpointeironãodurante do reajuste - IP estático opcional
» produto_sku_bandwidth_idcorpointeironãoPakete 11: ID de banda larga
» id_concurrency_produtoSKUcorpointeironãoPlan 11: Paralel Plan ID
» produto_sku_duracao_idcorpointeironãoO tipo de pacote é obrigatório: durabilidade do tipo
» etdcorpointeironãoTempo multiplicado, obtido do pacote extension_of_time_days, 2 é o número de dias × 2, com aumento de preço
» valor da reabastecimentocorpointeironãoPacote 3: valor de reembolso

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados":
"id": 0,
"trade_no": "string",
"out-trade-no": "string",
"produto_id": 0,
"tipo_de_produto": 0,
"quantidade": 0
"unit_price": 0.1,
"valor total": 0.1,
"comissão de bens": 0.1,
"taxa": 0.1,
"desconto": 0.1
"comissão de tratamento": 0.1,
"taxa de reembolso": 0.1,
"pm_id": 0,
"pm_title": "string"
"pm_logo": "string",
"status": 0,
"título": "string"
"detalhe": "string"
"region_desc": "string",
"pagamento": "2019-08-24T14:15:22Z"
"pay_timestamp": 0,
"created_at": "2019-08-24T14:15:22Z"
"valor_de_pague_status": 0,
"invoice": {
"nome": "Fatura",
"nome": "string"
"org_name": "string",
"primeiro_nome": "string"
"last_name": "string"
"telefone": "string"
"email": "user@example.com",
"tipo_de_rola": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string"
"address_line1": "string",
"address_line2": "string",
"address_postal_code": "string"
    }
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKcriar bemInline

retornar a estrutura de dados

POST cancelar pedido

POST /ep/order/close

Parâmetros de corpo

{
"comércio": "string"
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetosimnão
» comércio semcorpostringsimnão

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKOperação bem-sucedidanão

Previsão de pedido POST

POST /ep/order/check

O método de chamada antes da criação de uma ordem, usado para exibir preços, descontos, detalhes de IP, etc., e não cria uma ordem. Os parâmetros são idênticos aos de /ep/order/create.

Parâmetros de corpo

{
"pid": 0
"upids": "string"
"quantidade": 1
"pm_id": 0,
"region_list": "string",
"coupon_sn": "string",
"renew_duration": "1m",
"produtoSKUBandwidthId": 0,
"productSKU_concurrency_id": 0,
"product_sku_duration_id": 0,
"etd": 1,
"quantia_de_reparação": 0
}

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
corpocorpoobjetosimnão
» pidcorpointeirosimID do pacote
» upidscorpostringnãoIP Seguro: Lista de IDs de pacotes de usuários, separados por vírgula
» quantidadecorpointeironãoquantidade de compra
» pm_idcorpointeirosimID de método de pagamento
» lista de regiõescorpostringnãoIP estático comprado por região + quantidade, formatado: ID da região, quantidade
» cupon_sncorpostringnãonúmero de cupom
» duracao_renovacaocorpostringnãoTempo de retenção do IP: 1m = 1 mês, 2m = 2 meses, em = no final do mês seguinte
» produto_sku_bandwidth_idcorpointeironãoO tipo de pacote é obrigatório: tipo=11: especificação de largura de banda
» id_concurrency_produto_skucorpointeironãoO tipo de pacote é obrigatório: ID de especificação de parceria
» produto_sku_duracao_idcorpointeironãoO tipo de pacote é obrigatório: tipo=11: tempo de duração
» etdcorpointeironãoMúltiplo de tempo, obtido do pacote extension_of_time_days
» valor da reaçãocorponúmeronãoO tipo de pacote é obrigatório: o valor do reajuste

enumar valores

propriedadevalor
» duracao_renovada1m
» duracao_de_renovacao2m
» renovar_duraçãoem

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados":
"produto_id": 0
"quantidade": 0
"desconto": 0.1
"valor total": 0.1,
"taxa de imposto": 0.1,
"tipo_de_produto": 0,
"título": "string"
"detalhe": "string"
"ip_result": [
"result": "Não foi possível obter o IP do cliente",
      {
"ip": "string"
"preço": 0.1
"country_code": "string",
"current_time": "2019-08-24T14:15:22Z"
"renewal_time": "2019-08-24T14:15:22Z"
"país": {}
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKPre-consulta bem-sucedidaInline

retornar a estrutura de dados

gestão de pagamentos

GET lista de métodos de pagamento

GET /ep/payment/list

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
comércio semconsultastringnãoNº de pedido - pode ser fornecido para determinados pedidos que exigem um método de pagamento específico
moedaconsultastringnãounidade monetária

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados":
"lista": [
"lista":
      {
"id": 0,
"título": "string"
"logo": "string"
"grupo": "string"
"ratagem": 0,
"comissão de tratamento": 0,
"disabilitado": false,
"min": 0
"mais": 0
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKobter sucessoInline

retornar a estrutura de dados

GET lista de métodos de pagamento

GET /ep/payment/groups

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
comércio semconsultastringnãoNº de pedido - pode ser fornecido para determinados pedidos que exigem um método de pagamento específico

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados": {
"nome": "Data",
"lista": [
"lista":
      {
"nome": "string"
"logos": [
"logo": "logo"
null
],
"items": [
"item1", "item2", "item3", "item4", "item5", "item6", "item7", "item8", "item9", "item10", "item11", "item12", "item13", "item14", "item15", "item16", "item17", "item18", "item19", "item20", "item21", "item22", "item23", "item24", "item25", "item26", "item27", "item28", "item29", "item30", "item31", "item32", "item33", "item34", "item35", "item36", "item37", "item38", "item39", "item40", "item41", "item42", "item43", "item44", "item45", "item46", "item47", "item48", "item49", "item50", "item51", "item52", "item53", "item54", "item55", "item56", "item57", "item58", "item59", "item60", "item61", "item62", "item63", "item64", "item65", "item66", "item67", "item68", "item69", "item70", "item71", "item72", "item73", "item74", "item75", "item76", "item77", "item78", "item79", "item80", "item81", "item82", "item83", "item84", "item85", "item86", "item87", "item88", "item89", "item90", "item91", "item92", "item93", "item94", "item95", "item96", "item97", "item98", "item99", "item100", "item101", "item102", "item10
null
        ]
      }
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKobter sucessoInline

Retornar a estrutura de dados

marketing

porcentagem de ganhos de GET

GET /ep/activity/balance-recharge-gift-ratio

porcentagem de ganhos de carregamento

Retornando o exemplo

200 Resposta

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados":
"lista": [
"lista":
null
    ]
  }
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKOKInline

retornar a estrutura de dados

produtos

GET lista de produtos

GET /ep/product

Obtenha a lista de pacotes disponíveis no seu site atual, com suporte para filtrar por tipo, validade, etc.

parametro de solicitação

nomelocalizaçãotipoobrigatórioexplicação
tipoconsultainteironãoTipo de pacote, ver o Enum do tipo de produto. Se não for fornecido, todos os tipos são retornados.
tipo da categoriaconsultainteironãotipo pai, válido apenas para tipo=19 (reabastecimento de IP), para filtrar linhas de produtos: 14=centros de dados 25=residenciais
dias_de_timeconsultaqualquernãoFiltrar por número de dias de validade, suporta valores singulares ou arrays, como 30 /[30,90,365]
tipo da visualizaçãoconsultaqualquernãoFiltrar tipo de visualização, suporta valores únicos ou arrays

descrição detalhada

tipo: Tipo do pacote, ver a descrição do enumador Product.type. Se não for fornecido, todos os tipos são retornados.

enumar valores

propriedadevalor
tipo da categoria14
tipo da categoria25

Retornando o exemplo

200 Resposta

{
  "code": 0,
  "message": "操作成功",
  "data": [
    {
      "id": 0,
      "title": "string",
      "type": 0,
      "show_type": 0,
      "status": 0,
      "price": 0.1,
      "usd_price": 0.1,
      "price_hkd": 0.1,
      "original_price": 0.1,
      "original_usd_price": 0.1,
      "original_price_hkd": 0.1,
      "local_price": 0.1,
      "local_original_price": 0.1,
      "preferred_currency": "string",
      "support_currencies": "string",
      "flow_value": 0.1,
      "flow_give": 0.1,
      "balance_give": 0.1,
      "balance_value": 0.1,
      "time_validity": 0.1,
      "time_price": 0.1,
      "time_days": 0,
      "tip1": "string",
      "tip2": "string",
      "introduce": [
        "string"
      ],
      "region_list_id": 0,
      "renew_product_list": "string",
      "parent_product_type": 0,
      "total_count": 0,
      "remain_count": 0,
      "extension_of_time_days": [
        0
      ],
      "time_days_price_rate": 0.1,
      "desc": {
        "subtitle": "string",
        "flow_value": 0.1,
        "flow_give": 0.1,
        "balance_give": 0.1,
        "time_validity": 0.1,
        "time_price": 0.1,
        "tip1": "string",
        "tip2": "string",
        "introduce": [
          null
        ]
      },
      "sku": {
        "bandwidth_list": [
          null
        ],
        "duration_list": [
          null
        ],
        "concurrency_list": [
          null
        ]
      }
    }
  ]
}

Retornar os resultados

código de estadoO que significa o código de estadoexplicaçãomodelo de dados
200OKOKInline

retornar a estrutura de dados

modelo de dados

tipos de produtos

9

Tipos de pacotes, 9 pacotes de fluxo de dados dinâmicos para residências, 11 IP dinâmicos para residências, 14 IP de data center estáticos, 25 IP de data center estáticos

propriedade

nometipoobrigatóriorestringirnome chinêsexplicação
anônimointeirofalsonãoTipo de pacote, 9 pacotes de fluxo de dados dinâmicos, 11 IP de fluxo de dados dinâmico, 14 IP de data center estático, 25 IP de data center estático

enumar valores

propriedadevalor
anônimo9
anônimo11
anônimo14
anônimo25

codificação da resposta

200

Código de estado, 200 sucesso, 3 app_key inválido

propriedade

nometipoobrigatóriorestringirnome chinêsexplicação
anônimointeirofalsonãoCódigo de estado, 200 Sucesso, 3 app_key inválido

Satisfazer

{
"cod": 0,
"message": "Operação bem-sucedida",
"dados": {}
}

propriedade

nometipoobrigatóriocondiçãonome chinêsexplicação
códigointeirofalsonãonão
mensagemstringfalsonãonão
dadosobjetofalsonãonão

ordem

{
"id": 0,
"trade_no": "string",
"out-trade-no": "string",
"produto_id": 0,
"tipo_de_produto": 0,
"quantidade": 0
"unit_price": 0.1,
"valor total": 0.1,
"comissão de bens": 0.1
"taxa de imposto": 0.1
"desconto": 0.1
"comissão de tratamento": 0.1
"taxa de reembolso": 0.1,
"pm_id": 0,
"pm_title": "string",
"pm_logo": "string",
"status": 0,
"título": "string"
"detalhe": "string"
"region_desc": "string",
"pagamento": "2019-08-24T14:15:22Z",
"data_time": 0,
"created_at": "2019-08-24T14:15:22Z",
"valor_de_pague_status": 0,
"invoice": {
"nome": "Fatura",
"nome": "string"
"org_name": "string",
"primeiro_nome": "string"
"last_name": "string"
"telefone": "string"
"email": "user@example.com",
"role_type": 0,
"vat_id": "string",
"address_country": "string",
"address_city": "string"
"address_line1": "string"
"address_line2": "string",
"address_postal_code": "string"
  }
}

propriedade

nometipoobrigatóriocondiçãonome chinêsexplicação
idinteirofalsonãoID da ordem
comércio semstringfalsonãoNº de ordem interna
out-trade-nostringfalsonãoNº de pedido externo
id do produtointeirofalsonãoID do pacote
tipo_de_produtointeirofalsonãotipo de pacote, ver enum tipo de produto
quantidadeinteirofalsonãoquantidade de compra
preço unitárionúmero(float)falsonãopreço por unidade
total feenúmero (float)falsonãoPreço total da ordem (sem desconto, incluindo os custos de processamento)
despesa de bensnúmero(float)falsonãoPreço do produto (sem taxas) com desconto
pagar comissãonúmero(float)falsonãovalor pago (com desconto e com taxas)
taxa de descontonúmero(float)falsonãovalor da oferta
taxa de manutençãonúmero (float)falsonãocomissão
taxa de reembolsonúmero (float)falsonãovalor do reembolso
idinteirofalsonãoID de método de pagamento (de /ep/payment/list)
pm_titulostringfalsonãonome do método de pagamento
pm_logostringfalsonãoforma de pagamentoURL da imagem
statusinteirofalsonãostatus da ordem
títulostringfalsonãotítulo do pacote
detalhesstringfalsonãoDescrição do pacote
região descritastringfalsonãoDescrição do parâmetro regional
pagarstring(data e horafalsonãotempo de pagamento
pagar timestampinteirofalsonãoTíquete de pagamento
criado emstring(data e horafalsonãodata de criação
pagar taxa_statusinteirofalsonãoTamanho: 0 normal, 1 grande (excedente), 2 pequeno
faturaobjetofalsonãoInformações de fatura (apenas disponíveis para pedidos feitos online)
» nomestringfalsonãonome completo
» nome do grupostringfalsonãonome corporativo
» primeiroNomestringfalsonãonão
» sobrenomestringfalsonãonão
» telefonestringfalsonãonão
» emailstring(email)falsonãonão
» tipo_de_rolointeirofalsonão1 pessoa 2 empresas
» vat_idstringfalsonãoNº de Renda
» endereço_nacionalstringfalsonãonão
» endereço_cidadestringfalsonãonão
» linha_de_endereço1stringfalsonãonão
» linha2stringfalsonãonão
» código postalstringfalsonãonão

OrderCheckResult

{
"produto_id": 0,
"quantidade": 0
"desconto": 0.1,
"valor total": 0.1,
"taxa de imposto": 0.1
"tipo_de_produto": 0,
"título": "string"
"detalhe": "string"
"ip_result": [
"result": "Não foi possível obter o IP do cliente",
    {
"ip": "string"
"preço": 0.1
"country_code": "string",
"current_time": "2019-08-24T14:15:22Z"
"renewal_time": "2019-08-24T14:15:22Z"
"país": {
"nome": "País"
"nome_zh_cn": "string",
"flag": "string"
"square_flag": "string"
      }
    }
  ]
}

resultados de previsão de ordem

propriedade

nometipoobrigatóriocondiçãonome chinêsexplicação
id do produtointeirofalsonãoID do pacote
quantidadeinteirofalsonãoquantidade
taxa de descontonúmero (float)falsonãoquantidade de desconto
total feenúmero(float)falsonãototal de pedidos
pagar comissãonúmero(float)falsonãovalor pago
tipo do produtointeirofalsonãotipo de pacote
títulostringfalsonãotítulo do pacote
detalhesstringfalsonãodescrição do pacote
ip_result[object]falsonãoResultados de IP para retenção em massa (retornam apenas para retenção de IP)
» ipstringfalsonãonão
» preçonúmero (float)falsonãonão
» país códigostringfalsonãonão
» hora atualstring(data e horafalsonãonão
» tempo de renovaçãostring(data e horafalsonãonão
» paísobjetofalsonãonão
»» nome_zh_cnstringfalsonãonão
»»stringfalsonãoURL da bandeira circular
»»stringfalsonãoURL de bandeira quadrada

Produto

{
  "id": 0,
  "title": "string",
  "type": 0,
  "show_type": 0,
  "status": 0,
  "price": 0.1,
  "usd_price": 0.1,
  "price_hkd": 0.1,
  "original_price": 0.1,
  "original_usd_price": 0.1,
  "original_price_hkd": 0.1,
  "local_price": 0.1,
  "local_original_price": 0.1,
  "preferred_currency": "string",
  "support_currencies": "string",
  "flow_value": 0.1,
  "flow_give": 0.1,
  "balance_give": 0.1,
  "balance_value": 0.1,
  "time_validity": 0.1,
  "time_price": 0.1,
  "time_days": 0,
  "tip1": "string",
  "tip2": "string",
  "introduce": [
    "string"
  ],
  "region_list_id": 0,
  "renew_product_list": "string",
  "parent_product_type": 0,
  "total_count": 0,
  "remain_count": 0,
  "extension_of_time_days": [
    0
  ],
  "time_days_price_rate": 0.1,
  "desc": {
    "subtitle": "string",
    "flow_value": 0.1,
    "flow_give": 0.1,
    "balance_give": 0.1,
    "time_validity": 0.1,
    "time_price": 0.1,
    "tip1": "string",
    "tip2": "string",
    "introduce": [
      "string"
    ]
  },
  "sku": {
    "bandwidth_list": [
      {
        "id": 0,
        "value": 0,
        "price": 0.1,
        "price_usd": 0.1,
        "price_hkd": 0.1
      }
    ],
    "duration_list": [
      {
        "id": 0,
        "value": 0,
        "price": 0.1,
        "price_usd": 0.1,
        "price_hkd": 0.1
      }
    ],
    "concurrency_list": [
      {
        "id": 0,
        "value": 0,
        "price": 0.1,
        "price_usd": 0.1,
        "price_hkd": 0.1
      }
    ]
  }
}

propriedade

nometipoobrigatóriocondiçãonome chinêsexplicação
idinteirofalsonãoID do pacote
títulostringfalsonãoTítulo principal do pacote
tipointeirofalsonãotipo de pacote
tipo da visualizaçãointeirofalsonãoTipos de exibição: 1 Normal 2 Grande recomendação 3 Não disponível (necessita de customização) 4 Testar
statusinteirofalsonãostatus: 1 na loja 0 fora da loja
preçonúmero (float)falsonãopreço do renminbi
usd_pricenúmero (float)falsonãopreço em dólares
preço_hkdnúmero(float)falsonãopreço de HK$
preço originalnúmero (float)falsonãopreço original (CNY)
preço original em dólarnúmero (float)falsonãopreço original (US$)
preço original HKDnúmero (float)falsonãoPreço original (HKD)
preço localnúmero(float)falsonãoPreços localizados (dependem do preferred_currency)
local_original_pricenúmero (float)falsonãoPreço original localizado (depende do preferred_currency)
preferido_dinheirostringfalsonãoMoeda recomendada, por exemplo, USD / CNY / HKD
suporte_currenciesstringfalsonãoLista de moedas suportadas, separadas por vírgula, como usd, cny
valor de fluxonúmero(float)falsonãoPacote de tráfego padrão (GB)
fluxo_de_dadosnúmero (float)falsonãofluxo de entrega (GB)
balanco_de_darnúmero(float)falsonãovalor de ganho de saldo
balanco_de_dadosnúmero (float)falsonãovalor do reembolso
tempo_de_vigêncianúmero (float)falsonãoTempo de validade padrão do pacote de quantidade
tempo_paguenúmero(float)falsonãoPreço por IP por volume
dias_de_timeinteirofalsonãoNúmero de dias de validade, como 30/90/180/365
sugestão1stringfalsonãocomentário de tag 1
sugestão2stringfalsonãodescrição de tags 2
introduzir[string]falsonãoLista de descrições de texto
id da regiãointeirofalsonãoID regional
lista_de_renovacao_de_produtostringfalsonãoLista de IDs de pacotes que podem ser renovados (divididos por virgola)
tipo da categoriainteirofalsonãotipo de pai (aplicável quando type=19): 14 ou 25
total_countinteirofalsonãoestoque total, 0 significa não limitado
quantidade restanteinteirofalsonãoestoque restante
extensão_de_time_de Dias[inteiro]falsonãoLista de fatores de tempo, vazio ou com apenas 1 indica não suportado
horas_dias_prix_taxanúmero(float)falsonãoCóseguro de duração, preço × (1 + (fator-1) × taxa)
descobjetofalsonãoInformação sobre o pacote
» subtítulosstringfalsonãosubtítulo
» valor de fluxonúmero (float)falsonãonão
» fluxo de dívidanúmero(float)falsonãonão
» balance_givenúmero(float)falsonãonão
» tempo válidonúmero (float)falsonãonão
» tempo_prixnúmero(float)falsonãonão
» sugestão1stringfalsonãonão
» sugestão2stringfalsonãonão
» introduzir[string]falsonãonão
skuobjetofalsonãoParâmetros (retornam quando o tipo é 11)
» lista de banda larga[object]falsonãolista de especificações de largura de banda
»» idinteirofalsonãonão
»» valorinteirofalsonãovalor de largura de banda (MBps)
»» preçonúmero (float)falsonãonão
»» preço_usdnúmero(float)falsonãonão
»» preço_hkdnúmero (float)falsonãonão
» duracao_list[object]falsonãolista de especificações de duração
»» idinteirofalsonãonão
»» valorinteirofalsonãodurante (dias)
»» preçonúmero(float)falsonãonão
»» preço_usdnúmero (float)falsonãonão
»» preço_hkdnúmero (float)falsonãonão
» lista de concorrência[object]falsonãoLista de especificações paralelas
»» idinteirofalsonãonão
»» valorinteirofalsonãoquantidade de processos
»» preçonúmero(float)falsonãonão
»» preço_usdnúmero(float)falsonãonão
»» preço_hkdnúmero(float)falsonãonão

Paginagem

{
"total": 0,
"pagina_nota": 0,
"pagina_tamanho": 0,
"total_pages": 0
}

propriedade

nometipoobrigatóriocondiçãonome chinêsexplicação
totalinteirofalsonãonão
página_nãointeirofalsonãonão
tamanho da páginainteirofalsonãonão
total_pagesinteirofalsonãonão