Pular para o conteúdo

Aplicam-se a mesma precificação, o mesmo desconto de plano e as mesmas verificações de estoque e saldo. Protocolo, localização, domínios de destino ou modo todos os sites e todas as opções adicionais são suportados.

Se o nome de usuário e a senha não forem enviados, eles são gerados automaticamente e retornados na resposta (se o token também tiver proxies:read). Se o nome do serviço não for enviado, ele é gerado no formato do painel. Os campos válidos para cada tipo estão na tabela da página Operações que geram cobrança; campos desconhecidos são rejeitados.

O pedido pode não ficar ativo na hora (preparação, pré-venda ou atraso do provedor). Se meta.ready for false, meta.warning vem preenchido; antes de colocar o serviço em uso, consulte o endpoint Detalhes do serviço até que state seja active.

Autorização

Authorizationstringobrigatório

Enviado no formato Bearer <token>. Este endpoint exige o escopo orders:write (Criação de pedidos); um token sem esse escopo recebe 403.

Cabeçalhos

Idempotency-Keystringheaderobrigatório

Um valor único para cada tentativa de pedido (por exemplo, um UUID). Em caso de timeout, tente de novo com o MESMO valor; a cobrança não é feita duas vezes. Guarde o valor em uma variável e não gere um novo para a nova tentativa.

Corpo

orderTypeenum<string>obrigatório

Tipo de serviço; nesta página, gaming.

locationIdintegerobrigatório

Obrigatório para ISP, Datacenter e Gaming. Obtenha-o no endpoint GET /locations. O país é definido automaticamente pela localização.

quantityintegerobrigatório

Obrigatório para ISP, Datacenter e Gaming, 1-1000. Sem estoque, o pedido vira pré-venda e exige pelo menos 250.

protocolenum<string>padrão: socks5

ISP, Datacenter e Gaming. auto: HTTP e SOCKS5 na mesma porta, além de UDP ASSOCIATE; http: apenas HTTP/HTTPS; socks5: apenas SOCKS5. Se não for enviado, usa-se auto em ISP e Datacenter e socks5 em Gaming (default_protocol na resposta de GET /catalog). O alias parentUpstreamProtocol também é aceito (AUTO, HTTP ou SOCKS; sem diferenciar maiúsculas de minúsculas); envie apenas um dos dois. Não é enviado em Residential/Mobile; nesses tipos, HTTP e SOCKS5 funcionam ao mesmo tempo, em portas separadas.

highConnectionboolean

Alto limite de conexões. Na família ISP, é um adicional pago: 100 conexões simultâneas por IP em vez de 50. Em Residential/Mobile, é gratuito: o limite de conexões do gateway passa de 500 para 1000; aparece na resposta como options.high_connection.

extraIpWhitelistboolean

Apenas família ISP: cota extra de whitelist de IPs, com cobrança adicional por pedido. Em Residential/Mobile, retorna 400 invalid_request.

nonSequentialIpsboolean

Família ISP: IPs não sequenciais (dispersos), com cobrança adicional.

highSpeedboolean

Família ISP: 2× a largura de banda, com cobrança adicional.

usernamestring

Opcional; se não for enviado, é gerado automaticamente e retornado na resposta. 3-40 caracteres: letras, números, _ ou -. Para escolher o seu, o plano precisa permitir; caso contrário, retorna tier_required.

passwordstring

Opcional; se não for enviada, é gerada automaticamente. 6-40 caracteres; @ . : ! e espaços não são permitidos. Não pode ser igual ao nome de usuário. Ao usar uma senha com # / ? % dentro de um endereço (por exemplo, socks5://user:pass@host), aplique percent-encoding; as senhas geradas pelo sistema não contêm #.

gateNamestring

Opcional. Nome do serviço exibido no painel, no máximo 80 caracteres. Se não for enviado, é gerado no formato do painel (por exemplo, ISP Proxy #a1b2c3d4).

Resposta

200
application/json
dataobject
metaobject