Obtenir le statut de facturation
curl --request GET \
--url https://api.truthlocks.com/v1/billing/status \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/billing/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"plan": "<string>",
"status": "<string>",
"trial_ends_at": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Facturation
Obtenir le statut de facturation
Renvoie l’état de facturation actuel, le mode de fonctionnalité et la période de grâce pour le locataire authentifié.
GET
/
v1
/
billing
/
status
Obtenir le statut de facturation
curl --request GET \
--url https://api.truthlocks.com/v1/billing/status \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/billing/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"plan": "<string>",
"status": "<string>",
"trial_ends_at": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}GET /v1/billing/status
feature_mode est NORMAL et grace_until est null. Si un paiement échoue, le compte entre dans un flux de travail d’accès gradué — Dégradé, Restreint, puis Suspendu — avec une période de grâce à chaque étape.
Réponse
Le niveau de capacité de la fonctionnalité actuelle :
NORMAL— toutes les fonctionnalités disponiblesDEGRADED— paiement échoué ; toutes les fonctionnalités fonctionnent toujours pendant la période de grâceRESTRICTED— période de grâce sur le point d’expirer ; les opérations d’écriture (création, création de clés) sont désactivéesSUSPENDED— période de grâce expirée ; tout accès API est désactivé jusqu’à ce que le paiement soit résolu
Horodatage ISO 8601 indiquant la fin de la période de grâce actuelle, ou
null si le compte est en règle.Un message lisible par l’homme décrivant l’action requise, ou
null lorsqu’aucune action n’est nécessaire.Quand utiliser ce point de terminaison
UtilisezGET /v1/billing/status pour :
- Afficher les invites de paiement — vérifiez
feature_modeau démarrage de l’application ou à la connexion et affichez une bannière lorsque la valeur est différente deNORMAL. - Protéger les opérations d’écriture — avant de frapper ou de créer des clés, vérifiez que
feature_moden’est pasRESTRICTEDouSUSPENDED. - Suivre les délais de grâce — lisez
grace_untilpour montrer à vos utilisateurs exactement combien de temps ils ont pour résoudre un problème de paiement.
const res = await fetch("https://api.truthlocks.com/v1/billing/status", {
headers: { "X-API-Key": "tl_live_..." },
});
const { feature_mode, grace_until } = await res.json();
if (feature_mode !== "NORMAL") {
showPaymentBanner(feature_mode, grace_until);
}
Délai de grâce
Les fenêtres de grâce par défaut pour le mode de contrat Standard sont :| Transition | Fenêtre de grâce | Notifications |
|---|---|---|
| NORMAL → DÉGRADÉ | 7 jours | Rappels à T+24h, T+48h, T+72h |
| DÉGRADÉ → RESTREINT | 14 jours | Rappels à T+24h, T+48h, T+72h |
| RESTREINT → SUSPENDU | Immédiat | Avis de suspension final |
Voir échecs de paiement et périodes de grâce pour une description complète du flux de travail d’accès gradué.

