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, mobile.

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.

countryCodestring

Residential/Mobile: país padrão no nível do pedido, código ISO (TR, DE, US, GB, FR, IT, ES, NL, PL, RU). Na família ISP, o país vem de locationId; se for enviado ali, é rejeitado.

gbLimitnumber

Residential/Mobile, opcional: limite de tráfego (GB), no mínimo 0.001. 0 significa sem limite fixo. Se não for enviado, o consumo fica limitado pelo seu saldo.

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