Aller au contenu principal
SVDY Logo
Guide développeur
Disponible
Starter tier

Construisez vos intégrations avec des clés API

Importez les heures travaillées dans votre tableau de bord BI, envoyez les présences vers votre tableur de paie, ou connectez SVDY à n'importe quoi avec un script de 30 lignes. Clés cantonnées à votre organisation — rotables, journalisées à chaque appel.

Ce que vous pouvez faire

Les victoires du premier jour. Pas besoin d'ingénieur — un admin de PME le met en place.

Limité à votre tenant

Chaque clé porte votre organization ID. Une clé de votre tenant ne peut jamais lire les données d'un autre client, même si vous la partagez par accident. Défense en profondeur, pas juste une vérification de permission.

Rotation sans downtime

Générez d'abord la nouvelle clé, déployez vos services pour l'utiliser, puis révoquez l'ancienne. SVDY autorise plusieurs clés actives par organisation — rotation gracieuse, pas de fenêtres de maintenance.

Accès en écriture par plan

Plan Starter : API en lecture seule. Professional débloque l'écriture. Enterprise : clés illimitées + IP allowlist. La porte s'applique au niveau de la requête — pas de factures surprises, pas de scripts sur-permissionnés.

À configurer en 4 étapes

Temps estimé : moins de 5 minutes pour un admin qui a les identifiants sous la main.

1

Ouvrez Intégrations → API et clés

Vous voyez vos clés actives (tronquées aux 4 derniers chars), date de création, dernier usage, et actions de rotation / révocation.

2

Cliquez « Créer une clé » → nommez-la d'après le consommateur

Utilisez des noms comme « Script backup » ou « Dashboard BI » pour des journaux d'audit lisibles. SVDY affiche la clé complète UNE FOIS — copiez maintenant ; vous ne pouvez pas la récupérer plus tard.

3

Utilisez la clé comme Bearer token

Envoyez-la via `Authorization: Bearer svdy_live_...` à chaque requête vers l'API publique (`https://api.svdy.com/v1/public`). La clé identifie déjà votre organisation — aucun autre en-tête n'est requis.

curl -H 'Authorization: Bearer svdy_live_xxx...' \
     https://api.svdy.com/v1/public/me
# The key identifies your organization — no other header needed.
4

Configurez les alertes de rotation

Chaque clé expose « last_used_at ». Les journaux d'audit dans /system/audit-logs montrent chaque appel. Bonne pratique : rotation tous les 90 jours, révocation des clés non utilisées depuis 30 jours.


Prêt à connecter ?

Ouvrez l'admin de votre organisation → Intégrations et connectez cette intégration en moins de 5 minutes.