Limites, usage et observabilité

Quotas mensuels de requêtes#

Le quota est partagé par l’espace de travail et réinitialisé chaque mois en UTC. Consultez /me, les en-têtes de réponse et Paramètres → API → Usage pour les limites effectives, y compris les ajustements de l’espace.

Répartir le débit entre vos workers#

Les limites par défaut sont de 120 requêtes/minute et 5 000/heure par clé, plus 600/minute par espace. L’opérateur peut les configurer. Répartir les appels entre plusieurs clés ne contourne pas la limite de l’espace. Les clés invalides ont un budget anti-abus distinct par IP.

• X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset décrivent la limite active la plus contraignante.
• X-RateLimit-Reset est le nombre de secondes avant réinitialisation, pas un horodatage Unix.
• X-Quota-Limit, X-Quota-Remaining et X-Quota-Reset décrivent le quota mensuel. La réinitialisation est un horodatage ISO.
• Un quota illimité omet les en-têtes de limite et de solde. Les en-têtes de débit sont omis lorsque toutes les limites de débit sont désactivées.
• Les réponses 429 contiennent Retry-After. Respectez-le plutôt que de multiplier les appels.

Ce qui compte comme une requête#

Une requête authentifiée admise compte, même si son traitement refuse ensuite une entrée invalide, rejoue une réponse idempotente ou échoue. Les refus à l’admission pour clé invalide, permissions, périmètre, débit ou quota ne comptent pas. Un refus lié au déploiement intervient après admission et compte. Les appels aux métadonnées publiques et à OpenAPI ne comptent pas. Des appels simultanés peuvent légèrement dépasser la frontière mensuelle ; ne comptez pas sur ce dépassement.

Consulter l’usage et les modifications#

Paramètres → API contient Clés, Usage et Journal des requêtes. Consultez identifiants, méthodes, chemins, statuts et durées ; les entrées sont conservées 14 jours. Les membres voient l’activité de leurs propres clés ; les administrateurs disposant de api.manage voient celle de tout l’espace.

• Les écritures apparaissent dans le journal d’audit comme API · <nom de clé>, attribuées au propriétaire.
• Conservez X-Request-Id dans vos journaux opérationnels sans y écrire le secret bearer.
• Les chemins et durées des requêtes aident au diagnostic ; l’audit explique les modifications effectives des fiches.

Envoyer les changements à un autre système#

Il n’existe pas d’endpoint REST d’abonnement aux webhooks. Configurez dans Squario une automatisation déclenchée par une fiche avec une action webhook vers votre récepteur HTTPS. Celui-ci peut lire les fiches nécessaires avec l’API. Suivez la configuration de l’automatisation pour le payload sortant et les identifiants.