15 întrebări pe care ar trebui să le puneți despre API-ul lor înainte de a selecta o platformă

Întrebări de selecție API

Un bun prieten și mentor mi-a scris o întrebare și aș dori să folosesc răspunsurile mele pentru această postare. Întrebările sale s-au concentrat puțin mai mult asupra unei industrii (e-mail), așa că mi-am generalizat răspunsurile la toate API-urile. El a întrebat ce întrebări ar trebui să pună o companie unui furnizor despre API-ul lor înainte de a face o selecție.

De ce aveți nevoie de API-uri?

An interfață de programare a aplicației (API) este interfața pe care o oferă un sistem de calcul, o bibliotecă sau o aplicație pentru a permite cererilor de servicii să fie făcute de alte programe pentru computer și / sau pentru a permite schimbul de date între ele.

Wikipedia

La fel cum introduceți o adresă URL și obțineți un răspuns pe o pagină web, un API este o metodă în care sistemele dvs. pot solicita și obține un răspuns înapoi pentru a sincroniza datele între ele. Pe măsură ce companiile caută să se transforme digital, automatizarea sarcinilor prin API-uri este o modalitate excelentă de a îmbunătăți eficiența în cadrul organizației și de a reduce erorile umane.

API-urile sunt centrale pentru automatizare, în special în aplicațiile de marketing. Una dintre provocări atunci când faceți cumpărături pentru un mare furnizor cu un cuprinzător API este că resursele și cheltuielile de dezvoltare sunt de obicei o gândire ulterioară. Echipa de marketing sau CMO poate conduce achiziționarea unei aplicații și uneori echipa de dezvoltare nu primește prea multe informații.

Cercetarea capacităților de integrare a unei platforme prin intermediul unui API necesită mai mult decât simpla întrebare, Există un API?

Dacă vă conectați cu o aplicație cu un API slab acceptat sau documentat, veți înnebuni echipa de dezvoltare și probabil că integrările dvs. vor deveni scurte sau vor eșua cu totul. Găsiți furnizorul potrivit, iar integrarea dvs. va funcționa, iar oamenii de dezvoltare vă vor ajuta cu plăcere!

Întrebări de cercetare privind capacitățile lor API:

  1. Caracteristica Gap - Identificați ce caracteristici ale interfeței lor de utilizator sunt disponibile prin interfața de programare a aplicațiilor. Ce caracteristici are API-ul pe care nu îl are interfața de utilizare și invers?
  2. Scară - Întrebați câte apeluri sunt efectuate către ei API zilnic. Au un grup dedicat de servere? Cantitatea este incredibil de importantă, deoarece doriți să identificați dacă API-ul este o gândire ulterioară sau de fapt parte a strategiei companiei.
  3. Documentație - Solicitați documentația API. Ar trebui să fie robust, precizând fiecare caracteristică și variabilă disponibile în API.
  4. Comunitate - Întrebați dacă au sau nu o comunitate de dezvoltatori online disponibilă pentru a partaja cod și idei cu alți dezvoltatori. Comunitățile de dezvoltatori sunt esențiale pentru lansarea rapidă și eficientă a eforturilor de dezvoltare și integrare. Mai degrabă decât să utilizezi „tipul API” de la companie, folosești și toți clienții lor care au avut deja încercări și erori în integrarea soluției lor.
  5. Odihnă vs săpun - Întrebați ce tip de API au ... De obicei, există API-uri REST și API-uri de servicii web (SOAP). Este posibil să se dezvolte pe amândouă. Integrarea cu oricare dintre ele are beneficii și blesteme ... ar trebui să fiți familiarizați cu capacitățile resurselor dvs. de integrare (IT).
  6. Limbi - Întrebați cu ce platforme și aplicații s-au integrat cu succes și solicitați contacte, astfel încât să puteți afla de la acei clienți cât de greu a fost integrarea și cât de bine rulează API-ul.
  7. Limitări - Întrebați ce limitări are furnizorul în ceea ce privește numărul de apeluri pe oră, pe zi, pe săptămână etc. Dacă nu sunteți cu un furnizor scalabil, creșterea dvs. va fi limitată de client.
  8. Probele - Oferă o bibliotecă de exemple de coduri pentru a începe cu ușurință? Multe companii publică SDK (Kituri de dezvoltare software) pentru diferite limbi și cadre care vă vor accelera cronologia de integrare.
  9. Sandbox - Oferă un endpoint non-producție sau un mediu sandbox pentru a vă testa codul?
  10. Resurse - Întrebați dacă au resurse de integrare dedicate în cadrul companiei lor. Au un grup de consultanță internă disponibil pentru integrare? Dacă da, aruncă câteva ore în contract!
  11. Securitate - Cum se autentifică utilizând API-ul? Este vorba de acreditări de utilizator, chei sau alte metodologii? Pot restricționa cererile după adresa IP?
  12. Uptime - Întreabă ce au API timpul de funcționare și rata de eroare sunt, și când sunt orele de întreținere. De asemenea, strategiile de a lucra în jurul lor sunt importante. Au procese interne care vor reîncerca API apeluri în cazul în care înregistrarea nu este disponibilă din cauza unui alt proces? Este ceva ce au conceput ei în soluția lor?
  13. SLA - Au o Serviciul Level Agreement unde timpul de funcționare ar trebui să fie mai mare de 99.9%?
  14. Foaia de parcurs - Ce funcții viitoare încorporează în API-ul lor și care sunt programele de livrare așteptate?
  15. Integrations - Ce integrări produsizate au dezvoltat sau pe care le-au dezvoltat terți? Uneori, companiile pot renunța la dezvoltarea internă a caracteristicilor atunci când există deja o altă integrare productivă și este susținută.

Cheia acestor întrebări este că integrarea te „căsătorește” cu platforma. Nu vrei să te căsătorești cu cineva fără să afli cât de mult poți despre ei, nu-i așa? Este exact ceea ce se întâmplă atunci când oamenii cumpără o platformă fără să cunoască capacitățile lor de integrare.

Dincolo de un API, ar trebui să încercați, de asemenea, să aflați ce alte resurse de integrare ar putea avea: coduri de bare, cartografiere, servicii de curățare a datelor, RSS, formulare web, widget-uri, integrări formale ale partenerilor, motoare de script, pagini SFTP etc.

4 Comentarii

  1. 1
  2. 3

Ce părere ai?

Acest site folosește Akismet pentru a reduce spamul. Aflați cum sunt procesate datele despre comentarii.