Pedidos
Permissão: orders:read.
GET /api/v1/orders
Seção intitulada “GET /api/v1/orders”Parâmetros: offset, limit, family, status, client_reference (correspondência exata).
Um valor desconhecido de family ou status é lido como “sem filtro”. A ordem é fixa e não
configurável: os mais novos primeiro.
| Campo | Significado |
|---|---|
product, kind, family | o que foi comprado; kind: resident ou ipv4 |
quantity | número de unidades compradas: endereços em ipv4; em um pedido de tráfego é sempre 1 - foi comprado um pacote, e o volume está em packages[].traffic.purchased_gb |
price_per_proxy, total | preço da unidade (total / quantity) e valor do pedido; em um pedido de tráfego são iguais |
status | veja abaixo |
applied_to_package_id | preenchido - o pedido foi aplicado a um pacote existente: recarga de tráfego ou prolongamento de endereços |
client_reference | seu rótulo do corpo da compra |
packages | o pacote de tráfego entregue pelo pedido. Vazio nas recargas de tráfego e nos pedidos de endereços fixos - leia esses pacotes via GET /api/v1/packages?family=dedicated, a ficha traz order_id |
GET /api/v1/orders/{id}
Seção intitulada “GET /api/v1/orders/{id}”O formato é o mesmo da lista. Um pedido de outra conta responde 404 sem a chave code.
Status de entrega
Seção intitulada “Status de entrega”A compra é concluída dentro da requisição, por isso na resposta de POST /api/v1/packages o pedido já está
completed. Os outros status aparecem ao ler os pedidos.
| Status | O que fazer |
|---|---|
pending, provisioning | consultar a cada 5-10 segundos |
completed | pronto: o pacote de tráfego em packages[0], o pacote de endereços em package_id da resposta da compra |
failed | dinheiro não debitado ou devolvido, pode repetir |
refunded | dinheiro devolvido por decisão do suporte; repita como uma nova compra |
needs_attention | dinheiro debitado, análise manual. Não compre de novo, fale com o suporte |
Em vez de consultar os pedidos, você pode ler o log de eventos.