15 questions à poser sur leur API avant de sélectionner une plate-forme »Zone Martech

Un bon ami et mentor a écrit m'a posé une question et j'aimerais utiliser mes réponses pour ce message. Ses questions étaient un peu plus axées sur un seul secteur (e-mail), j'ai donc généralisé mes réponses à toutes les API. Il a demandé quelles questions une entreprise devrait poser à un fournisseur sur son API avant de faire une sélection.

Pourquoi avez-vous besoin d'API?

Une interface de programmation d'application (API) est l'interface d'un système informatique , une bibliothèque ou une application fournit afin de permettre des demandes de services à en être faites par d'autres programmes informatiques, et / ou pour permettre l'échange de données entre eux.

Wikipedia

Tout comme vous tapez une URL et obtenir une réponse sur une page Web, une API est une méthode dans laquelle vos systèmes peuvent demander et obtenir une réponse pour synchroniser les données entre eux. Alors que les entreprises cherchent à se transformer numériquement, l'automatisation des tâches via les API est un excellent moyen d'améliorer l'efficacité au sein de l'organisation et de réduire les erreurs humaines.

Les API sont au cœur de l'automatisation, en particulier dans les applications marketing. L'un des défis lors de l'achat d'un grand fournisseur avec une API complète est que les ressources et les dépenses de développement sont généralement une réflexion après coup. L'équipe marketing ou CMO peut conduire l'achat d'une application et parfois l'équipe de développement ne reçoit pas beaucoup d'informations.

La recherche des capacités d'intégration d'une plate-forme via une API nécessite plus que la simple question, Y a-t-il un API?

Si vous vous connectez avec une application avec une API mal prise en charge ou mal documentée, vous allez rendre votre équipe de développement folle et vos intégrations vont probablement échouer ou échouer complètement. Trouvez le bon fournisseur, et votre intégration fonctionnera et vos développeurs se feront un plaisir de vous aider!

Questions de recherche sur leurs capacités API:

1. Feature Gap – Identifiez les fonctionnalités de leur interface utilisateur disponibles via le Interface de programmation d'applications. Quelles sont les fonctionnalités de l'API que l'interface utilisateur n'a pas et vice versa?
2. Échelle – Demandez combien d'appels sont effectués quotidiennement vers leur API . Ont-ils un pool de serveurs dédié? La quantité est extrêmement importante car vous voulez identifier si l'API est une réflexion après coup ou fait réellement partie de la stratégie de l'entreprise.
3. Documentation – Demandez la documentation de l'API. Il doit être robuste, précisant toutes les fonctionnalités et variables disponibles dans l'API.
4. Communauté – Demandez si une communauté de développeurs en ligne est disponible pour partager du code et des idées avec d'autres développeurs. Les communautés de développeurs sont essentielles pour lancer vos efforts de développement et d'intégration rapidement et efficacement. Plutôt que de tirer parti du «gars de l'API» de l'entreprise, vous tirez également parti de tous leurs clients qui ont déjà subi des essais et des erreurs en intégrant leur solution.
5. REST vs SOAP – Demandez quel type d'API ils ont… Généralement, il existe des API REST et des API de service Web (SOAP). Ils peuvent développer les deux. L'intégration avec l'un ou l'autre présente des avantages et des inconvénients… vous devez être familiarisé avec les capacités de vos ressources d'intégration (TI).
6. Langues – Demandez quelles plates-formes et applications elles ont réussi à intégrer et demandez des contacts afin que vous puissiez trouver de ces clients à quel point il était difficile d'intégrer et à quel point l'API fonctionnait bien.
7. Limitations – Demandez quelles sont les limites du fournisseur en termes de nombre d'appels par heure, par jour, par semaine, etc. Si vous n'êtes pas avec un fournisseur évolutif, votre croissance sera limitée par le client.
8. Exemples – Offrent-ils une bibliothèque d'exemples de code pour démarrer facilement? De nombreuses entreprises publient des SDK (kits de développement logiciel) pour différents langages et frameworks qui accéléreront votre calendrier d'intégration.
9. Sandbox – Offrent-ils un environnement de point de terminaison ou de bac à sable hors production dans lequel vous pouvez tester votre code? [19659011] Ressources – Demandez s'ils disposent de ressources d'intégration dédiées au sein de leur entreprise. Ont-ils un groupe de conseil interne disponible pour l'intégration? Si oui, jetez quelques heures dans le contrat!
10. Sécurité – Comment s'authentifient-ils à l'aide de l'API? S'agit-il des informations d'identification de l'utilisateur, des clés ou d'autres méthodologies? Peuvent-ils restreindre les demandes par adresse IP?
11. Temps de disponibilité – Demandez ce que sont leur API taux de disponibilité et d'erreur, et quand leurs heures de maintenance sont. De plus, les stratégies pour les contourner sont importantes. Ont-ils des processus internes qui réessayeront les appels API au cas où l'enregistrement serait indisponible en raison d'un autre processus? Est-ce quelque chose qu'ils ont conçu dans leur solution?
12. SLA – Ont-ils un Service Level Agreement où les temps de disponibilité devraient être supérieurs à 99,9%?
13. Roadmap – Quelles fonctionnalités futures incorporeront-ils dans leur API et quelles sont les délais de livraison prévus?
14. Intégrations – Quelles intégrations productisées ont-elles développées ou que des tiers ont-elles développées? Parfois, les entreprises peuvent renoncer au développement interne de fonctionnalités lorsqu'une autre intégration produit existe déjà et est prise en charge.

La clé de ces questions est que l'intégration vous «marie» avec la plate-forme. Vous ne voulez pas épouser quelqu'un sans en savoir le plus possible sur eux, n'est-ce pas? C'est exactement ce qui se produit lorsque des gens achètent une plate-forme sans connaître leurs capacités d'intégration.

Au-delà d'une API, vous devriez également essayer de découvrir les autres ressources d'intégration dont ils peuvent disposer: codes-barres, cartographie, services de nettoyage de données, RSS, Web Formulaires, widgets, intégrations formelles de partenaires, moteurs de script, suppressions SFTP, etc.