15 spørsmål du bør stille om deres API før du velger en plattform

API-valgspørsmål

En god venn og mentor skrev stilte et spørsmål til meg, og jeg vil gjerne bruke svarene mine til dette innlegget. Spørsmålene hans var litt mer fokusert på en bransje (e-post), så jeg har generalisert svarene mine på alle API-er. Han spurte hvilke spørsmål et selskap burde stille en leverandør om API-en sin før de tok et valg.

Hvorfor trenger du APIer?

An applikasjonsprogrammeringsgrensesnitt (API) er grensesnittet som et datasystem, bibliotek eller applikasjon gir for å tillate forespørsler om tjenester som skal gjøres av det av andre dataprogrammer, og / eller for å tillate data å bli utvekslet mellom dem.

Wikipedia

Akkurat som du skriver inn en URL og får svar tilbake på en webside, er en API en metode der systemene dine kan be om og få svar tilbake for å synkronisere data mellom dem. Når selskaper ønsker å transformere seg digitalt, er automatisering av oppgaver gjennom APIer en flott måte å forbedre effektiviteten i organisasjonen og redusere menneskelige feil.

APIer er sentrale i automatisering, spesielt i markedsføringsapplikasjoner. En av utfordringene når du handler for en stor leverandør med en omfattende API er at utviklingsressurser og utgifter vanligvis er en ettertanke. Markedsføringsteamet eller CMO kan føre til kjøp av en applikasjon, og noen ganger får ikke utviklingsteamet mye innspill.

Å undersøke en plattforms integrasjonsfunksjoner via en API krever mer enn det enkle spørsmålet, Finnes det et API?

Hvis du logger på med et program med dårlig støttet eller dokumentert API, kommer du til å gjøre utviklingsteamet ditt gal og integrasjonene dine vil sannsynligvis komme kort eller mislykkes helt. Finn riktig leverandør, så vil integrasjonen din fungere og utviklingsfolkene dine hjelper deg gjerne!

Forskningsspørsmål om deres API-evner:

  1. Feature Gap - Identifiser hvilke funksjoner i brukergrensesnittet som er tilgjengelig via applikasjonsprogrammeringsgrensesnittet. Hvilke funksjoner har APIet som brukergrensesnittet ikke har, og omvendt?
  2. Skala - Spør hvor mange samtaler som blir ringt til deres API daglig. Har de et eget basseng med servere? Mengde er utrolig viktig siden du vil identifisere om API er en ettertanke eller faktisk en del av selskapets strategi.
  3. Dokumentasjon - Be om API-dokumentasjon. Det skal være robust, og stave ut alle funksjoner og variabler som er tilgjengelige i API.
  4. fellesskapet - Spør om de har et online utviklerfellesskap tilgjengelig for deling av kode og ideer med andre utviklere. Utviklerfellesskap er nøkkelen til å starte utviklings- og integrasjonsarbeidet raskt og effektivt. I stedet for å utnytte 'API-fyren' i selskapet, utnytter du også alle kundene deres som allerede har hatt prøver og feil som integrerer løsningen.
  5. REST vs SOAP - Spør hvilken type API de har ... Vanligvis finnes det REST APIer og SOAP-APIer. De kan utvikle begge deler. Integrering med begge har fordeler og forbannelser ... du bør være kjent med hva dine integrasjonsressurser (IT) har.
  6. språk - Spør hvilke plattformer og applikasjoner de har lykkes med å integrere med, og be om kontakter slik at du kan finne ut av disse kundene hvor vanskelig det var å integrere og hvor godt API-en kjører.
  7. Begrensninger - Spør hvilke begrensninger leverandøren har i antall samtaler per time, per dag, per uke osv. Hvis du ikke er hos en skalerbar leverandør, vil veksten din være begrenset av kunden.
  8. Prøver - Tilbyr de et bibliotek med kodeeksempler for enkelt å komme i gang? Mange selskaper publiserer SDK (Software Development Kits) for forskjellige språk og rammer som vil akselerere integrasjonstidslinjen din.
  9. sandkasse - Tilbyr de et ikke-produksjonsendepunkt eller sandkassemiljø som du kan teste koden din i?
  10. Ressurser - Spør om de har dedikerte integrasjonsressurser i selskapet. Har de en intern konsulentgruppe tilgjengelig for integrering? Kast i så fall noen timer i kontrakten!
  11. Sikkerhet - Hvordan autentiserer de ved hjelp av API? Er det brukerlegitimasjon, nøkler eller andre metoder? Kan de begrense forespørsler etter IP-adresse?
  12. Oppetid - Spør hva deres API oppetid og feilrate er, og når vedlikeholdstiden er. Strategier for å omgå dem er også viktige. Har de interne prosesser som vil prøve på nytt API samtaler i tilfelle posten ikke er tilgjengelig på grunn av en annen prosess? Er dette noe de har konstruert i løsningen?
  13. SLA - Har de en Service Level Agreement hvor oppetid skal være oppover 99.9%?
  14. Roadmap - Hvilke fremtidige funksjoner bruker de i API-en, og hva er forventede leveringsplaner?
  15. integrasjoner - Hvilke produktiserte integrasjoner har de utviklet eller at tredjeparter har utviklet? Noen ganger kan bedrifter fravike intern utvikling av funksjoner når en annen produktisert integrasjon allerede eksisterer og støttes.

Nøkkelen til disse spørsmålene er at integrasjon 'gifter' deg med plattformen. Du vil ikke gifte deg med noen uten å bli kjent så mye du kan om dem, gjør du? Dette er akkurat hva som skjer når folk kjøper en plattform uten kjennskap til integrasjonsegenskapene sine.

Utover en API, bør du også prøve å finne ut hvilke andre integrasjonsressurser de kan ha: Strekkoding, kartlegging, datarensingstjenester, RSS, webskjemaer, moduler, formelle partnerintegrasjoner, skriptmotorer, SFTP-dråper osv.

2 Kommentarer

  1. 1

Hva tror du?

Dette nettstedet bruker Akismet for å redusere spam. Lær hvordan kommentaren din behandles.