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.

Chargement…

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
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
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.