Pular para o conteúdo

Com estoque, é possível pedir no máximo a quantidade em estoque; sem estoque (pré-venda), no mínimo 250 unidades. O campo sufficient informa se a quantidade desejada pode ser atendida.

Sem target_url, retorna o estoque do modo todos os sites; esse é o mesmo número da resposta de GET /locations. target_url deve ser um dos destinos suportados (GET /target-urls); caso contrário, assim como no endpoint de pedido, retorna 400 e details.unsupported_targets.

Um location_id desconhecido retorna 400. Se o tipo de serviço estiver em manutenção, vêm maintenance: true e sufficient: false.

Autorização

Authorizationstringobrigatório

Enviado no formato Bearer <token>. Este endpoint exige o escopo orders:read (Informações do serviço); um token sem esse escopo recebe 403.

Parâmetros de consulta

typeenum<string>obrigatório

Tipo de serviço.

location_idintegerobrigatório

ID da localização. Obtenha-o no endpoint GET /locations.

quantityinteger

Quantidade de IPs (1-1000).

target_urlstring

Domínio de destino para um pedido direcionado; o estoque é calculado para esse destino.

Resposta

200
application/json
dataobject