15 frågor du bör ställa om deras API innan du väljer en plattform

API-urvalsfrågor

En god vän och mentor skrev ställde en fråga till mig och jag skulle vilja använda mina svar för det här inlägget. Hans frågor var lite mer fokuserade på en bransch (e-post), så jag har generaliserat mina svar på alla API: er. Han frågade vilka frågor ett företag skulle ställa en leverantör om deras API innan de gjorde ett urval.

Varför behöver du API: er?

An applikationsprogrammeringsgränssnitt (API) är gränssnittet som ett datorsystem, ett bibliotek eller en applikation tillhandahåller för att tillåta begäran om tjänster från andra datorprogram och / eller för att data ska kunna utbytas mellan dem.

wikipedia

Precis som du skriver in en URL och får tillbaka ett svar på en webbsida är ett API en metod där dina system kan begära och få tillbaka svar för att synkronisera data mellan dem. Eftersom företag vill transformera sig digitalt är automatisering av uppgifter via API ett utmärkt sätt att förbättra effektiviteten inom organisationen och minska mänskliga fel.

API: er är centrala för automatisering, särskilt i marknadsföringsapplikationer. En av utmaningarna när man handlar efter en stor säljare med en omfattande API är att resurser och kostnader för utveckling vanligtvis är en eftertanke. Marknadsföringsteamet eller CMO kan driva köp av en applikation och ibland får utvecklingsteamet inte mycket input.

Att undersöka en plattforms integrationsfunktioner via ett API kräver mer än den enkla frågan, Finns det ett API?

Om du loggar in med en applikation med ett dåligt stödt eller dokumenterat API kommer du att göra ditt utvecklingsteam galet och dina integrationer kommer sannolikt att bli korta eller misslyckas helt. Hitta rätt leverantör, så kommer din integration att fungera och dina utvecklingsfolk hjälper dig gärna!

Forskningsfrågor om deras API-funktioner:

  1. Funktionsgap - Identifiera vilka funktioner i deras användargränssnitt som finns tillgängliga via applikationsprogrammeringsgränssnittet. Vilka funktioner har API: et som gränssnittet inte har och vice versa?
  2. Skala - Fråga hur många samtal som görs till deras API dagligen. Har de en särskild pool av servrar? Kvantitet är oerhört viktigt eftersom du vill identifiera om API: et är en eftertanke eller faktiskt en del av företagets strategi.
  3. Dokumentation - Be om API-dokumentation. Det ska vara robust och stava ut alla funktioner och variabler som finns i API: et.
  4. Community - Fråga om de har en online utvecklargemenskap tillgänglig för att dela kod och idéer med andra utvecklare. Utvecklargrupper är nyckeln till att starta ditt utvecklings- och integrationsarbete snabbt och effektivt. Istället för att utnyttja "API-killen" på företaget, utnyttjar du också alla deras kunder som redan har haft försök och fel som integrerar deras lösning.
  5. REST vs SOAP - Fråga vilken typ av API de har ... Vanligtvis finns det REST API: er och SOAP-API: er (Web Service). De kan utveckla båda. Att integrera med antingen har fördelar och förbannelser ... du bör känna till vad dina integrationsresursers (IT) kapacitet har.
  6. språk - Fråga vilka plattformar och applikationer de har integrerat med framgång och begär kontakter så att du kan ta reda på hur svårt det var att integrera och hur bra API: n fungerar.
  7. Begränsningar - Fråga vilka begränsningar säljaren har i antalet samtal per timme, per dag, per vecka etc. Om du inte är hos en skalbar leverantör kommer din tillväxt att begränsas av kunden.
  8. Prover - Erbjuder de ett bibliotek med kodexempel för att enkelt komma igång? Många företag publicerar SDK (Software Development Kits) för olika språk och ramar som kommer att påskynda din integrationstidslinje.
  9. sandlåda - Erbjuder de en icke-produktionsändpunkt eller en sandlådemiljö som du kan testa din kod i?
  10. Resurser - Fråga om de har dedikerade integrationsresurser inom sitt företag. Har de en intern konsultgrupp tillgänglig för integration? Om så är fallet, kasta några timmar i kontraktet!
  11. säkerhet - Hur autentiserar de med API: et? Är det användaruppgifter, nycklar eller andra metoder? Kan de begränsa begäranden efter IP-adress?
  12. Uptime - Fråga vad deras API drifttid och felprocent är och när deras underhållstid är. Strategier för att arbeta runt dem är också viktiga. Har de interna processer som kommer att försöka igen API samtal om posten inte är tillgänglig på grund av en annan process? Är det något som de har konstruerat i sin lösning?
  13. SLA - Har de en Service Level Agreement där drifttiderna bör vara högre än 99.9%?
  14. färdplan - Vilka framtida funktioner införlivar de i deras API och vilka är de förväntade leveransscheman?
  15. integrationer - Vilka produktiserade integrationer har de utvecklat eller som tredje part har utvecklat? Ibland kan företag avstå från den interna utvecklingen av funktioner när en annan produktiserad integration redan finns och stöds.

Nyckeln till dessa frågor är att integration 'gifter' dig med plattformen. Du vill inte gifta dig med någon utan att lära känna så mycket du kan om dem, eller hur? Detta är precis vad som händer när folk köper en plattform utan kunskap om deras integrationsmöjligheter.

Utöver ett API bör du också försöka ta reda på vilka andra integrationsresurser de kan ha: Streckkodning, kartläggning, datarengöringstjänster, RSS, webbformulär, widgets, formella partnerintegrationer, skriptmotorer, SFTP-droppar etc.

3 Kommentarer

  1. 1
  2. 3

Vad tror du?

Den här sidan använder Akismet för att minska spam. Läs om hur din kommentardata behandlas.