API de statut VIP de l'application

Cette API permet de consulter le statut VIP et la date d'expiration VIP de l'application actuelle. Elle prend en charge AppPush et WebPush.

Remarque : Le centre de données et le type de produit sont déterminés par le domaine de la requête ou la route URL. Il n'est pas nécessaire de les transmettre dans les paramètres de la requête.

Remarque : L'AppKey est transmis dans les identifiants Basic Auth de la REST API. Il n'est pas nécessaire de le transmettre dans la query string ni dans le corps de la requête.

Authentification

Pour plus de détails, consultez la méthode d'authentification dans la vue d'ensemble de la REST API.

Consulter le statut VIP de l'application

Endpoint

GET v4/app/vip/status
              
              GET v4/app/vip/status

            
Afficher ce bloc de code dans la fenêtre flottante

Exemple de requête

En-têtes de requête

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

            
Afficher ce bloc de code dans la fenêtre flottante

Paramètres de requête

Aucun.

Exemples de réponse

Réponse réussie

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8
              
              HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

            
Afficher ce bloc de code dans la fenêtre flottante
{ "vip_status": 1, "vip_end_time": 1775059200 }
              
              {
    "vip_status": 1,
    "vip_end_time": 1775059200
}

            
Afficher ce bloc de code dans la fenêtre flottante

Paramètres de réponse

Champ Type Description
vip_status int Statut VIP. 0 signifie essai gratuit, 1 signifie forfait payant actif, 2 signifie disponible avec paiement en attente, -1 signifie essai gratuit expiré, -2 signifie forfait payant expiré et -3 signifie indisponible en raison d'un paiement en attente.
vip_end_time int64 Date d'expiration VIP sous forme de timestamp Unix en secondes.

Réponse en échec

HTTP/1.1 401 Unauthorized Content-Type: application/json; charset=utf-8
              
              HTTP/1.1 401 Unauthorized
Content-Type: application/json; charset=utf-8

            
Afficher ce bloc de code dans la fenêtre flottante
{ "error": { "code": 21004, "message": "basic auth failed" } }
              
              {
    "error": {
        "code": 21004,
        "message": "basic auth failed"
    }
}

            
Afficher ce bloc de code dans la fenêtre flottante

Codes d'erreur

Code HTTP Description Error Message Détails
21004 401 Échec de l'authentification basic auth failed L'AppKey et le MasterSecret ne correspondent pas, ou les identifiants Basic Auth n'ont pas été fournis.
21008 400 Erreur de paramètre de requête app_key is not a 24 size string L'AppKey dans Basic Auth ne contient pas 24 caractères.
21030 503 Erreur interne du système. Veuillez réessayer plus tard Server response time out, please try again later Le service interne a dépassé le délai de réponse.
27000 500 Erreur interne du système Server inner err L'appel au service interne a échoué ou une erreur inattendue s'est produite.
27001 401 Informations d'authentification non valides app_key does not exist or basic info is invalid L'AppKey dans Basic Auth a une longueur valide, mais l'application n'existe pas ou les informations d'authentification de l'application sont invalides.
Icon Solid Transparent White Qiyu
Contactez-nous