App-VIP-Status-API
Diese API fragt den VIP-Status und die VIP-Ablaufzeit der aktuellen Anwendung ab. Sie unterstützt AppPush und WebPush.
Hinweis: Das Rechenzentrum und der Produkttyp werden durch die Anfragedomain oder die URL-Route bestimmt. Sie müssen nicht zusätzlich in den Anfrageparametern übergeben werden.
Hinweis: Der AppKey wird über die Basic-Auth-Anmeldedaten der REST-API übertragen. Er muss nicht zusätzlich im Query-String oder Request Body übergeben werden.
Authentifizierung
Weitere Details finden Sie in der REST-API-Übersicht unter Authentifizierungsmethode.
App-VIP-Status abfragen
Endpunkt
GET v4/app/vip/status
GET v4/app/vip/status
Diesen Codeblock im schwebenden Fenster anzeigen
Anfragebeispiel
Request Headers
GET /v4/app/vip/status
Authorization: Basic (base64 auth string)
Content-Type: application/json
GET /v4/app/vip/status
Authorization: Basic (base64 auth string)
Content-Type: application/json
Diesen Codeblock im schwebenden Fenster anzeigen
Anfrageparameter
Keine.
Antwortbeispiele
Erfolgreiche Antwort
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Diesen Codeblock im schwebenden Fenster anzeigen
{
"vip_status": 1,
"vip_end_time": 1775059200
}
{
"vip_status": 1,
"vip_end_time": 1775059200
}
Diesen Codeblock im schwebenden Fenster anzeigen
Antwortparameter
| Feld | Typ | Beschreibung |
|---|---|---|
vip_status |
int | VIP-Status. 0 bedeutet kostenlose Testphase, 1 bedeutet kostenpflichtig und aktiv, 2 bedeutet mit ausstehender Zahlung verfügbar, -1 bedeutet kostenlose Testphase abgelaufen, -2 bedeutet kostenpflichtiger Plan abgelaufen, und -3 bedeutet wegen ausstehender Zahlung nicht verfügbar. |
vip_end_time |
int64 | VIP-Ablaufzeit als Unix-Zeitstempel in Sekunden. |
Fehlgeschlagene Antwort
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8
Diesen Codeblock im schwebenden Fenster anzeigen
{
"error": {
"code": 21004,
"message": "basic auth failed"
}
}
{
"error": {
"code": 21004,
"message": "basic auth failed"
}
}
Diesen Codeblock im schwebenden Fenster anzeigen
Fehlercodes
| Code | HTTP | Beschreibung | Error Message | Details |
|---|---|---|---|---|
| 21004 | 401 | Authentifizierung fehlgeschlagen | basic auth failed | AppKey und MasterSecret stimmen nicht überein, oder es wurden keine Basic-Auth-Anmeldedaten bereitgestellt. |
| 21008 | 400 | Fehlerhafte Anfrageparameter | app_key is not a 24 size string | Der AppKey in Basic Auth ist nicht 24 Zeichen lang. |
| 21030 | 503 | Interner Systemfehler. Bitte später erneut versuchen | Server response time out, please try again later | Der interne Dienst hat nicht rechtzeitig geantwortet. |
| 27000 | 500 | Interner Systemfehler | Server inner err | Der interne Dienstaufruf ist fehlgeschlagen oder es ist ein unerwarteter Fehler aufgetreten. |
| 27001 | 401 | Ungültige Authentifizierungsinformationen | app_key does not exist or basic info is invalid | Der AppKey in Basic Auth hat eine gültige Länge, aber die Anwendung existiert nicht oder die Authentifizierungsinformationen der Anwendung sind ungültig. |
