curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
API de gestion — Analytique et forfaits
Plan actuel
GET /plans/current/
GET
/
plans
/
current
/
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
Renvoie le plan d’abonnement actif du compte authentifié — son expiration, l’état de facturation, et l’ensemble complet des quotas/permissions accordés par le plan.
Vérifié en conditions réelles sur un compte de test au plan Pro —
Nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la vue d’ensemble de la Management API.Requête
curl --request GET \
--url 'https://management.scanova.io/plans/current/' \
--header 'Authorization: YOUR_API_KEY'
{
"is_active": true,
"is_free": false,
"expire": "2027-08-16",
"is_expired": false,
"days_left": 365,
"recurring_enabled": false,
"can_cancel_subscription": false,
"payment_method": null,
"pricing": null,
"plan": {
"id": 275,
"slug": "pro-scanova-io",
"name": "Pro - scanova.io",
"plan_type": "Normal",
"description": "...",
"version": 1,
"family": {
"id": 12,
"name": "Pro"
},
"quotas": [
{
"quota_id": 401,
"codename": "QR_CODE_LIMIT",
"name": "QR Code Limit",
"value": 100
}
],
"is_enterprise_plan": false,
"is_custom_plan": false
},
"upcoming_plan": null
}
pricing et payment_method valent null sur ce compte car il n’est actuellement pas sur un cycle de facturation récurrent payant ; plan.quotas est tronqué ci-dessus par souci de concision (une réponse réelle inclut chaque quota accordé par le plan).
Champs de réponse
boolean
Indique si le plan est actuellement actif (non expiré, non annulé).
boolean
Indique s’il s’agit d’un plan gratuit.
string
Date d’expiration (
YYYY-MM-DD), ou la chaîne littérale "Lifetime" pour un plan sans expiration.boolean
Indique si le plan a déjà expiré.
integer
Jours restants jusqu’à
expire.boolean
Indique si le renouvellement automatique est activé.
boolean
Indique si le compte est éligible pour annuler son abonnement depuis le tableau de bord.
object | null
Le moyen de paiement enregistré du compte, ou
null si aucun n’est défini (par ex. comptes Free Trial/Enterprise provisionnés).object | null
L’enregistrement spécifique de tarification/période de facturation sous lequel ce plan a été acheté (
{id, name, period}, plus amount/currency lorsque résolvable à partir de l’historique des commandes), ou null si le compte n’a aucun historique de facturation pour ce plan.object
La définition du plan lui-même.
Afficher propriétés de plan
Afficher propriétés de plan
integer
string
string
string
Type de plan lisible, par ex.
Normal, Enterprise.string
integer
object
{id, name} — la famille de plans à laquelle ce plan appartient (par ex. tous les paliers de « Pro »).array
Chaque quota accordé par ce plan, chacun sous la forme
{quota_id, codename, name, value, ...}. codename est l’identifiant stable auquel font référence les messages d’erreur de restriction de quota des autres endpoints (par ex. MANAGEMENT_API, FOLDER_MANAGEMENT, EXPORT_ANALYTICS_REPORT).boolean
boolean
object | null
Même structure que
plan, si le compte a un changement de plan planifié (par ex. une rétrogradation prenant effet à la fin du cycle de facturation en cours) — null sinon.Le plan Pro standard n’accorde pas le quota
MANAGEMENT_API — seuls les plans Free Trial, Enterprise et Internal l’accordent dans l’environnement de test vérifié. Si vous développez avec cette API et recevez une erreur 401 avec « Your plan does not have management API quota. », vérifiez plan.quotas ici pour MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et contactez le support si vous pensez que votre plan devrait l’inclure — il n’existe pas actuellement de parcours de mise à niveau en libre-service pour ce quota spécifiquement.Voir aussi
- Vue d’ensemble de la Management API — la correspondance
environment-vers-quota (MANAGEMENT_API,INTEGRATION_ZAPIER,INTEGRATION_MCP) à laquelle correspondent les codenames deplan.quotasde cet endpoint. - Créer un token API — où l’
environmentd’une clé détermine lequel de ces quotas est vérifié. - Exporter les analyses — un endpoint restreint par le codename
EXPORT_ANALYTICS_REPORTque vous pouvez vérifier ici. - Gestion des dossiers — un endpoint restreint par le codename
FOLDER_MANAGEMENTque vous pouvez vérifier ici.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Réponse
200 - application/json
Current plan detail — expiry, billing state, and the full quota/permission set the plan grants.
Cette page vous a-t-elle été utile ?
⌘I