Estados del servicio
El estado que ves en el panel está en el campo state; construye tu integración sobre state, no sobre status.
En cada respuesta de servicio, status es el estado en bruto de la base de datos; el estado que ves en el panel está en el campo state. Toma tus decisiones segúnstate.
Valores de state
| state | Significado |
|---|---|
preparing | Se está preparando en el proveedor. En poco tiempo pasa a active. |
active | Funciona. |
expiring | Funciona, pero quedan 7 días o menos para que venza (ISP, Datacenter, Gaming). |
paused | Residential/Mobile se detuvo (en el panel, «En pausa»). El motivo y cómo reanudarlo están en el campo pause_reason. |
suspended | ISP, Datacenter o Gaming se detuvo. Si es pause_reason: expired, se puede renovar hasta grace_ends_at; si es admin, un administrador lo suspendió y no se puede renovar. |
expired | Venció por completo o se canceló. El panel oculta estos servicios; en la lista de la API tampoco aparecen de forma predeterminada. |
pause_reason
El motivo del estado paused o suspended. En los demás estados es null.
| Valor | Motivo | Qué hacer |
|---|---|---|
traffic_limit | Se alcanzó el límite de tráfico de Residential/Mobile. | Aumenta o elimina gb_limit. |
balance | Se agotó el saldo de Residential/Mobile. | Se reanuda automáticamente al recargar saldo. |
admin | Un administrador lo suspendió. | No se levanta con una renovación, un cambio de límite ni una recarga de saldo; ponte en contacto con soporte. |
expired | Terminó el periodo en la familia ISP. | Se puede renovar con POST /orders/{id}/renew hasta grace_ends_at. |
Renovabilidad
renewable indica si se aceptará la solicitud POST /orders/{id}/renew. Un servicio que venció por completo o que un administrador suspendió no se puede renovar y devuelve 409 conflict.
Días restantes
days_left son los días completos que quedan, redondeados hacia abajo: si quedan 27 horas, es 1; si queda menos de un día, es 0. state indica si el servicio terminó, y expires_at, el momento exacto de vencimiento. En los servicios sin fecha de vencimiento (pago por uso), days_left esnull.