API: er formar allt mer det tekniska ekosystemet. Nästan alla moderna applikationer har nu en API-slutpunkt som du kan interagera med.
API: er fungerar som mellanhänder, vilket gör att du kan bygga programmatiska interaktioner mellan applikationer som människor och företag använder dagligen.
Men inte alla API: er är lämpliga för integration och användning. Det finns fruktansvärda API: er som frustrerar användare. Följande är en riktlinje som du kan använda för att identifiera ett API som passar dina utvecklingsbehov.
1. Optimerad API-anropstid
Optimerande API-anrop innebär att sänka svarstiden för ett API. Detta inkluderar hur snabbt API: et betjänar förfrågningar och skickar svar. Det innebär också att minska effekten som stora datamängder har på API-hastigheten.
En API-svarstid påverkar användarupplevelsen. Långsamma API: er frustrerar användaren och påverkar applikationens prestanda. Ett högpresterande API bör ha en svarstid på mindre än en sekund.
Som utvecklare kan du testa hastigheten på alla API som använder Chrome DevTools. Öppna Utvecklarverktyg > Nätverk, öppna sedan API-slutpunkten i din webbläsare.
Du kommer att se en uppdelning av API-prestanda baserat på status, typ, storlek och tid. Tiden mäter API: ets hastighet.
Du kan gå längre och analysera API-komponenterna på samma flik. Klicka på slutpunkten. Du kommer att se en flik öppen med information om dess komponenter. Dessa inkluderar detaljer om Rubriker, Svar, och Timing.
Du kan nu se om API: et är tillräckligt snabbt för din applikation. Det finns andra onlineverktyg du kan använda till testa för API-hastighet. De populära bland utvecklarna är Brevbärare och Skryt.
2. Har onboardingguider
Ett bra API ger introduktionsriktlinjer för användare. Introduktionsguiden bör göra dig bekant med innehållet i API: et. Den förklarar API: s användningsfall och hur man integrerar dem. Informationen kan innefatta dess slutpunktsdefinitioner, kodavsnitt och exempelsvar.
RapidAPI: s onboardingguide är ett bra exempel. Guiden har allt användare behöver veta för att konsumera sina API: er.
Introduktionsguider bör också innehålla autentiseringsinformation. Det är viktigt att ha en väldokumenterad autentiseringsprocess så att du enkelt kan börja arbeta med API: t.
API: er använder olika sätt att autentisera sina användare. Det vanligaste är att använda en API-nyckel. Varje registrerad användare får en API-nyckel som de använder för att ringa. API: t kan ha olika autentiseringsnycklar för olika kategorier av användare.
3. Har tydlig och koncis dokumentation
Allt tekniskt innehåll ska vara tydligt och koncist. Tydlighet är särskilt viktigt för API: er. Som utvecklare har du inte tid att gå igenom för mycket dokumentation, så leta efter API: er som gör det enkelt att lära dig hur du använder dem.
Dokumentation säkerställer att användarna får en bra användarupplevelse. Erfarenhet är avgörande för att öka användningen av API. Välstrukturerad dokumentation beskriver endpoints, metoder och svarsalternativ.
Bra dokumentation har användarna i åtanke. Det här är personer utan kunskap om API: et. Därför bör all information använda bekanta ord och fraser.
Dokumentationen bör innehålla steg-för-steg-exempel och illustrationer. Dessa hjälper dig att snabbt förstå begreppen. Nedan är ett exempel på välstrukturerad dokumentation från Twilio hemsida.
En API: s dokumentation bör följa starka riktlinjer. Ett bra exempel på en API-dokumentationsguide är Tom Johnsons Jag skulle hellre skriva guide. Det är en komplett guide om hur man strukturerar och skriver API-dokumentation.
4. Har en interaktiv konsol
Ett bra API har en konsol där du kan testa API: et. Genom att testa ett API: s slutpunkter kan du se om det uppfyller dina krav.
Interaktiva konsoler skapar en lekplats där du kan testa slutpunkterna snabbt. Detta är en fördel eftersom det innebär att du inte behöver använda andra testverktyg. Konsoler är ett bra sätt att avgöra om API: et passar dina utvecklingsbehov.
RapidAPI-webbplatsen har ett bra exempel på en interaktiv konsol som du kan använda för att testa API-användningsfall.
5. Ger användningsalternativ
API-dokumentation bör göra det klart om det är gratis eller inte. Du måste vara medveten om vilka planer som är gratis och vilka som kräver betalning. Undvik komplicerade prissättningsplaner och de med många begränsningar.
Bra API: er har flera planer för att tillgodose olika kundkretsar. Informationen bör vara öppen om användningskvoter och begränsningar som följer med varje plan. RapidAPI har en tydlig prisplan som inkluderar grundläggande gratis och betalda företagsplaner för sina användare.
6. Har guider och handledningar
Handledningar hjälper användare att förstå hur ett API fungerar. De lär en nybörjare hur man använder API praktiskt. Genom att följa en bör du förstå vad du kan förvänta dig när du interagerar med API: et.
Målet med en handledning är att vägleda dig att producera enklast möjliga utdata med systemet. En API-handledning kan vara ett svar på en begäran som görs på API: et. Den visar hur du använder ett språk eller ramverk för att få ett visst svar.
Handledningar bör innehålla instruktioner om hur man registrerar sig för ett konto och generera API-nycklar. Dessutom bör det finnas instruktioner om hur man skickar en förfrågan och kontrollerar svaret. En bra handledning kommer också att ha illustrationer som diagram, infografik och audiovisuella bilder. Dessa gör det lättare att förstå de processer som är involverade.
Ett exempel på ett API med bra illustrationer är AsyncAPI-initiativet.
Antagandet är att om du ringer på ett användningsfall med hjälp av en handledning, kommer du att lyckas ringa andra samtal. Det är en bra idé att kontrollera om handledningarna är korrekta.
Varför du bör använda denna API-riktlinje
API: er skapar möjligheter att interagera med applikationer över hela världen. Att identifiera en bra kommer att spara den tid du skulle ha lagt ner på att skapa en funktion från början.
API: er ger dig tillgång till applikationer i världsklass med fantastiska funktioner. För att få ett bra API måste du överväga aspekter av API: t som går utöver endpoints och anropsmetoder.
Ett bra API är snabbt och väldokumenterat för att inspirera utvecklare att interagera med det. Följ ovanstående riktlinjer och välj det bästa API: et för din applikation.