API PUBLIQUE
Plans et limites
Le plan Gratuit est ouvert à tous les comptes développeur, pour essayer et pour un usage personnel léger. Le plan Max, qui relèvera les limites, est à venir. Nexus System fixe le plan de chaque compte.
Ce que compte chaque limite
- Requêtes par heure
- Toute requête faite avec une clé, réussie ou non, sur une fenêtre d’une heure. Le quota vaut pour le compte entier : toutes ses clés le partagent.
- Écritures par minute
- Les modifications de réglages (PATCH) et les commandes (POST), en plus du quota horaire, pour tout le compte.
- Nombre de clés
- Les clés du compte, actives, suspendues ou expirées : révoquer une clé libère une place.
- Appareils accessibles
- Les appareils rattachés au compte que l’API publique renvoie. Au-delà de la limite, les premiers par numéro de série restent lisibles ; les autres répondent 403.
- Profondeur d’historique
- Jusqu’où remontent l’historique et les événements, depuis maintenant. Au-delà : 403. La télémétrie est conservée 13 mois au plus.
- Écriture et commandes
- La modification des réglages et les commandes, si le plan les ouvre et si la clé a le droit choisi à sa création. Sinon : 403.
Une limite par adresse IP s’ajoute à tous les plans, avec ou sans clé, pour freiner les essais de clés au hasard.
Suivre son quota
Chaque réponse porte trois en-têtes : le quota de la fenêtre, ce qu’il en reste et le nombre de secondes avant la fenêtre suivante. La console affiche les mêmes valeurs sans consommer de requête.
HTTP/1.1 200 OK
RateLimit-Limit: <quota de l’heure>
RateLimit-Remaining: <requêtes restantes>
RateLimit-Reset: <secondes avant la nouvelle fenêtre>Au dépassement
La requête est refusée avec le statut 429 et l’en-tête Retry-After, en secondes. Rien n’est exécuté : une écriture refusée n’a pas modifié l’appareil.
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: <secondes>
{ "status": 429, "code": "NX-API-005", "request_id": "…" }Attendez la durée indiquée par Retry-After avant de réessayer, plutôt que de répéter la requête aussitôt.
Le plan Max
Seul le plan Gratuit est ouvert aujourd’hui. Le plan Max arrive bientôt ; ses limites et son prix seront publiés ici.
Conserver l’historique plus de 13 mois
La télémétrie est conservée 13 mois. Une conservation plus longue est prévue en option du plan Max, à venir.