SDK (Software Development Kit)
Un SDK (Software Development Kit) est un ensemble prêt à l'emploi de bibliothèques de code, d'outils et de documentation qui traduit une API en fonctions pour un langage de programmation. Au lieu d'écrire des requêtes HTTP brutes, les développeurs appellent des fonctions toutes faites.
Qu'est-ce qu'un SDK ?
Un SDK (Software Development Kit) est un ensemble prêt à l'emploi de bibliothèques de code, d'outils et de documentation pour un langage de programmation. Il traduit une API en fonctions que les développeurs appellent directement. Plus besoin de construire les requêtes HTTP à la main, de lire les réponses JSON ou de gérer soi-même les erreurs : une ligne comme client.messages.send() suffit. Le SDK s'occupe du reste.
Il existe deux variantes. Un SDK léger reproduit les endpoints de l'API un pour un et ajoute surtout des types. Un SDK complet apporte plus de confort, par exemple de nouvelles tentatives automatiques, la pagination ou la vérification des signatures de webhooks. Chaque SDK est lié à un seul langage : un fournisseur qui veut servir les développeurs Python, JavaScript et PHP doit créer et maintenir trois paquets distincts.
SDK ou REST API directe ?
Un SDK est toujours une couche au-dessus d'une API, le plus souvent une REST API. Les deux voies mènent au même résultat. La différence tient à l'effort :
- Avec un SDK : prise en main plus rapide, fonctions typées et moins d'erreurs dans le code. En contrepartie, vous dépendez du fournisseur pour maintenir le paquet à jour pour votre langage et votre version.
- Directement via REST : fonctionne avec tout langage capable d'envoyer des requêtes HTTP, sans paquet supplémentaire. Vous voyez exactement ce qui transite, mais vous écrivez vous-même l'authentification, la gestion des erreurs et les nouvelles tentatives.
Pour la plupart des intégrations de messagerie, quelques appels REST directs suffisent : s'authentifier, envoyer un message, recevoir les mises à jour de statut. C'est pourquoi beaucoup d'équipes se passent de SDK ou génèrent leur propre client à partir de la description de l'API.
Votre propre client à partir d'une spécification OpenAPI
De nombreuses API publient une spécification OpenAPI : un fichier lisible par machine qui décrit chaque endpoint, chaque paramètre et chaque réponse. À partir de ce fichier, vous obtenez une bonne partie de ce qu'offre un SDK, sans attendre un paquet officiel :
- Générer du code client : des outils comme OpenAPI Generator créent un client typé pour votre langage à partir de la spécification.
- Tester dans des outils API : Postman, Insomnia ou Bruno importent la spécification, pour essayer chaque endpoint avant d'écrire du code.
- Utiliser des outils de codage IA : des assistants comme Claude Code, Cursor ou GitHub Copilot lisent la spécification et la documentation, puis écrivent le code d'intégration pour votre stack.
Les SDK chez SendSeven
SendSeven ne propose pas de SDK par langage pour sa REST API. Le seul SDK est le SDK Push : un petit extrait de code qui ajoute les notifications push navigateur à votre propre site web. Pour tout le reste, vous vous connectez directement à la REST API, avec ces aides :
- Spécification OpenAPI : générer du code client ou l'importer dans Insomnia ou Bruno.
- Collection Postman : des requêtes prêtes à l'emploi pour essayer les endpoints.
- Documentation pour les outils de codage IA : chaque page de docs.sendseven.com existe aussi en Markdown, avec un prompt prêt à l'emploi pour Claude Code, Cursor et GitHub Copilot.
- Serveur MCP : les agents IA comme Claude travaillent directement avec SendSeven.
- Sans code : Zapier, Make et n8n relient SendSeven à d'autres outils sans programmation.
L'authentification se fait avec une clé API, envoyée comme jeton Bearer. Les instructions pas à pas se trouvent dans le guide d'authentification API, et tous les endpoints dans la documentation développeur.