Estados do serviço
O estado que você vê no painel está no campo state; baseie sua integração em state, não em status.
Em cada resposta de serviço, status é o status bruto do banco de dados; o estado que você vê no painel está no campo state. Tome suas decisões com base emstate.
Valores de state
| state | Significado |
|---|---|
preparing | Em preparação no provedor. Em pouco tempo passa a active. |
active | Funcionando. |
expiring | Funcionando, faltam 7 dias ou menos para o vencimento (ISP, Datacenter, Gaming). |
paused | Residential/Mobile parado (no painel, "Pausado"). O motivo e como retomar estão no campo pause_reason. |
suspended | ISP, Datacenter ou Gaming parado. Se pause_reason: expired, pode ser renovado até grace_ends_at; se admin, foi suspenso por um administrador e não pode ser renovado. |
expired | Totalmente vencido ou cancelado. O painel oculta esses serviços; na lista da API, eles também não aparecem por padrão. |
pause_reason
O motivo do estado paused ou suspended. Nos demais estados, null.
| Valor | Motivo | O que fazer |
|---|---|---|
traffic_limit | O limite de tráfego do Residential/Mobile foi atingido. | Aumente ou remova o gb_limit. |
balance | O saldo do Residential/Mobile acabou. | O serviço é retomado sozinho quando o saldo é recarregado. |
admin | Suspenso por um administrador. | Não é liberado por renovação, alteração de limite ou recarga de saldo; entre em contato com o suporte. |
expired | O período terminou na família ISP. | Pode ser renovado com POST /orders/{id}/renew até grace_ends_at. |
Possibilidade de renovação
renewable informa se uma requisição POST /orders/{id}/renew será aceita. Um serviço totalmente vencido ou suspenso por um administrador não pode ser renovado e retorna 409 conflict.
Dias restantes
days_left é o número de dias inteiros restantes, arredondado para baixo: se faltam 27 horas, vale 1; se falta menos de um dia, vale 0. state informa se o serviço já terminou, e expires_at, o momento exato do vencimento. Em serviços sem data de vencimento (pagos conforme o uso),days_left é null.