Authentification
S'authentifier auprès de l'API Stream Estate avec une clé API
L'API Stream Estate utilise une clé API transmise dans l'en-tête X-API-KEY sur chaque requête.
Obtenir une clé API
Créez un compte sur la console, puis générez une clé v2 depuis l'écran des clés :
- 🔑 Écran des clés — console.stream.estate/api-keys
- 🆕 Pas encore de compte — console.stream.estate/signup
La création de compte se fait aujourd'hui via connexion GitHub ou Google. Un flux non-interactif (device-code / création de clé par API) pour les agents et la CI est prévu — voir le changelog.
En-tête requis
X-API-KEY: <votre_clé>Exemple cURL
curl https://api-v2.stream.estate/sources \
-H "X-API-KEY: <votre_clé>"Contrôle d'usage
L'endpoint GET /account/api-usage (tag Account) expose les agrégats de consommation facturable de votre compte (totals, ventilations byApiKey et byRoute, série temporelle). C'est la source de vérité pour suivre votre consommation côté facturation. Filtrez par startDate / endDate (ISO 8601, défaut = 30 derniers jours / maintenant), par apiKeyId (UUID public d'une clé à vous) et regroupez via granularity.
Traitez votre clé comme un mot de passe. Ne la commitez jamais dans un dépôt Git public.