Dois-je utiliser l'API GraphQL ou le SDK ?
Ce guide s'adresse aux développeurs qui hésitent entre utiliser l'API GraphQL ou le SDK pour s'intégrer à Legalesign. Il fournit des informations sur les capacités de chaque option et vous aide à choisir la meilleure approche pour votre projet.
Les développeurs avancés ou ceux dont la pile technologique actuelle ne comprend pas de SDK (comme .Net ou GOLANG) ont le choix d'utiliser directement les API GraphQL ou REST. Pour beaucoup, l'API REST est une approche éprouvée, cependant, notre nouvelle API GraphQL a un champ d'action bien plus large, tout ce que vous pouvez faire dans l'application Console web peut être automatisé et exécuté avec l'API GraphQL. En fait, vous pouvez étendre ce qui est actuellement dans la Console et créer des interfaces dédiées et personnalisées rien que pour vous.
Utiliser à la fois l'API GraphQL et le SDK
Oui. Tout à fait, oui. Si vous avez un runtime compatible Node ou JavaScript, vous pouvez utiliser le SDK pour faire la majeure partie du travail à votre place et n'exécuter des appels GraphQL personnalisés que lorsque c'est nécessaire. Pourquoi travailler plus dur que nécessaire ?
Comparaison des fonctionnalités
| Fonctionnalité | API GraphQL | SDK |
|---|---|---|
| Facilité d'utilisation | Nécessite une connaissance des requêtes GraphQL | Simplifie les tâches courantes |
| Flexibilité | Contrôle total des requêtes et des mutations | Méthodes préconstruites pour les cas d'usage courants |
| Compatibilité | Fonctionne avec toute pile technologique | Nécessite un runtime Node.js ou JavaScript |
Exploration du schéma
Il y a deux principales façons.
- Consultez ce que l'application Console affiche dans ses requêtes réseau et sélectionnez ce que vous voulez ou,
- parcourez les requêtes et mutations disponibles via l'API dans le GraphQL Explorer.
En résumé, l'API GraphQL est idéale pour les développeurs qui ont besoin de contrôle total et de flexibilité, tandis que le SDK est parfait pour ceux qui cherchent une intégration rapide et facile. Si vous n'êtes pas sûr, envisagez de commencer avec le SDK et d'utiliser l'API GraphQL pour des personnalisations avancées.