Dienststatus
Der Status, den Sie im Panel sehen, steht im Feld state; bauen Sie Ihre Integration auf state statt auf status auf.
In jeder Dienstantwort ist status der rohe Datenbankstatus; der Status, den Sie im Panel sehen, steht im Feld state. Treffen Sie Ihre Entscheidungen anhand vonstate.
Werte von state
| state | Bedeutung |
|---|---|
preparing | Wird beim Anbieter vorbereitet. Wechselt kurz darauf zu active. |
active | Läuft. |
expiring | Läuft; bis zum Ablauf sind es 7 Tage oder weniger (ISP, Datacenter, Gaming). |
paused | Residential/Mobile angehalten (im Panel „Pausiert“). Den Grund und wie es weitergeht, nennt das Feld pause_reason. |
suspended | ISP, Datacenter oder Gaming angehalten. Bei pause_reason: expired ist eine Verlängerung bis grace_ends_at möglich; bei admin hat ein Administrator den Dienst gesperrt, er kann nicht verlängert werden. |
expired | Vollständig abgelaufen oder storniert. Das Panel blendet diese Dienste aus; auch in der API-Liste erscheinen sie standardmäßig nicht. |
pause_reason
Der Grund für den Status paused oder suspended. Bei allen anderen Status null.
| Wert | Grund | Was zu tun ist |
|---|---|---|
traffic_limit | Traffic-Limit von Residential/Mobile erreicht. | gb_limit erhöhen oder entfernen. |
balance | Guthaben von Residential/Mobile aufgebraucht. | Läuft nach dem Aufladen des Guthabens von selbst weiter. |
admin | Von einem Administrator gesperrt. | Wird weder durch Verlängerung noch durch eine Limitänderung oder eine Aufladung aufgehoben; wenden Sie sich an den Support. |
expired | Zeitraum in der ISP-Familie abgelaufen. | Bis grace_ends_at mit POST /orders/{id}/renew verlängerbar. |
Verlängerbarkeit
renewable gibt an, ob eine Anfrage POST /orders/{id}/renew angenommen wird. Ein vollständig abgelaufener oder von einem Administrator gesperrter Dienst kann nicht verlängert werden und liefert 409 conflict.
Verbleibende Tage
days_left sind die verbleibenden vollen Tage, abgerundet: Bei 27 verbleibenden Stunden ist der Wert 1, bei weniger als einem Tag 0. Ob der Dienst abgelaufen ist, sagt state, den genauen Ablaufzeitpunkt nennt expires_at. Bei Diensten ohne Ablaufdatum (nutzungsbasierte Abrechnung) ist days_leftnull.