SDK
Sept SDK clients officiels encapsulent le contrat REST décrit dans cette documentation — et l'API reste orientée curl, donc rien ici n'en exige un.
Tous les exemples de cette documentation utilisent curl, car l'API est du REST simple avec authentification par jeton porteur : le client HTTP de n'importe quel langage suffit. Les SDK vous évitent le code répétitif — types de requêtes et de réponses, taxonomie d'erreurs typées (validation, authentification, permission, introuvable, limite de débit) et signature HMAC des requêtes calculée pour vous.
Authorization: Bearer et vous intégrez dès aujourd'hui. Les SDK sont un confort, jamais une obligation.Langages
Chaque SDK est un portage idiomatique du client Node de référence — mêmes appels, même contrat réseau, conventions de nommage locales.
| Langage | Paquet |
|---|---|
| Node.js | @seeitlive/sdk |
| Go | github.com/SeeItLive-io/seeitlive-go |
| Java | io.seeitlive:seeitlive-sdk |
| PHP | seeitlive/sdk |
| Ruby | seeitlive-sdk |
| Rust | seeitlive-sdk |
| Perl | SeeItLive::SDK |
Ce qu'ils couvrent
Les sept exposent la même surface, celle que peut atteindre une clé API ou un jeton OAuth :
- Créer une session, la relire et interroger son état en direct (
sessions.create,sessions.get,sessions.status). - Relancer une invitation expirée sur place, ou émettre un tout nouveau lien qui tue l'ancien, en changeant éventuellement de canal ou de destinataire (
sessions.reshare). - Protection de l'invité : lire le mot de passe ou le code tournant du moment, le changer après création et lever un verrouillage, avec ou sans rotation du secret.
- Émettre des jetons de vue agent pour intégrer la visionneuse en direct dans votre propre interface.
- Lister les captures d'une session et en récupérer une au format PNG encodé en base64.
- Vérifier le jeton OAuth courant et échanger un code d'autorisation contre un jeton (fonction autonome : elle s'exécute avant l'existence de tout client).
- Signature HMAC facultative des requêtes : définissez un secret de signature et chaque requête porte les en-têtes
X-SeeItLive-SignatureetX-SeeItLive-Timestamp.