När marknadsföringsbranschen först övergick från utgående till inkommande marknadsföring övergav många marknadsförare sina gamla roller som innehållsväxlare för nya som innehållsskapare.
Men den förändringen producerar fortfarande efterskalv, och för att hålla jämna steg med dina konkurrenter idag måste du förstå vad API:er är, hur de integreras med din innehållsstrategi och de sociala insikter de tillför din webbplats.
Oroa dig inte, API:er kan verka komplicerade, men i slutet av det här inlägget kommer du att veta hur de fungerar och vad deras användning innebär. Här är en kort definition av ett API, följt av nyckelinformation om hur man får en att fungera för ditt företag.
Vad är ett API?
Ett API, förkortning för applikationsprogrammeringsgränssnitt, är en serie regler. För att vara tydligare är det en informationsförmedlare. API: er tillåter en applikation att extrahera information från en mjukvara och använda den informationen i sin egen applikation eller ibland för dataanalys.
I enklare termer är ett API en modell som låter “dina grejer” prata med och arbeta med “dina grejer”. Dina saker, i det här fallet, kallas API-slutpunkten.
Låter det förvirrande? Oroa dig inte, vi ska titta på ett exempel nedan.
Exempel på API-slutpunkt
Låt oss säga att du vill sända offentliga tweets i realtid så att du kan hålla dig informerad om ett specifikt ämne av intresse eller aktuella trender i världen. Då kan du använda Twitters slutpunkt för den filtrerade strömmen. Dess URL är: https://api.twitter.com/2/tweets/search/stream
Tekniskt sett behöver du bara referera till en API-slutpunkt med resurs-URL:s slutliga sökväg. Basrutten, som är gemensam för alla slutpunkter, är https://api.twitter.com. Eftersom det förblir detsamma finns det inget behov av att fortsätta inkludera det. Istället kan du bara lista slutpunkten: /2/tweets/search/stream.
Hur man testar en API-slutpunkt
Det finns flera onlineverktyg tillgängliga för att testa en API-slutpunkt. För det här inläggets skull kommer vi att titta på hur man ställer in ett test med hjälp av cURL. cURL är ett kommandoradsverktyg för att överföra data som stöder flera protokoll, inklusive HTTP. Du kan göra förfrågningar, hämta data och skicka data, vilket gör det till det perfekta verktyget för att begära information från API:er.
Låt oss använda ett exempel på. Säg att du vill hålla dig informerad om Twitter API. Då vill du ta emot tweets från viktiga konton som @TwitterDev och @TwitterAPI så snart de publiceras. Och kanske vill du bara ha tweets som innehåller länkar till artiklar eller dokumentation för att få så mycket sammanhang som möjligt.
I så fall är det perfekta valet att använda slutpunkten för den filtrerade strömmen. Men för att slutpunkten ska veta vilken typ av tweets som ska skickas måste du definiera filtreringskriterier. Annars skulle du bara be att få se alla tweets publicerade i realtid.
Filtreringskriterierna kommer att tillämpas på endpointen i form av regler. För att skapa dessa regler behöver du en uppsättning operatörer. För det här exemplet kan du använda två operatorer: från: och har: länkar – för att bara se tweets från vissa konton och som innehåller länkar. För att tala om för den filtrerade strömslutpunkten att endast visa tweets från kontona @Twitterdev och @TwitterApi som innehåller länkar, använder du följande regel: “Från: twitterdev från: twitterapi har: länkar”
För att begära denna information från den filtrerade strömslutpunkten måste du inkludera korrekt HTTP-begäran för att tala om för API:et vilken åtgärd som ska vidtas. Det finns fyra huvudalternativ. Ta en titt på en kort beskrivning av var och en nedan:
- GET: hämta en resurs
- POST: skapa en resurs
- PUT: uppdatera en befintlig resurs
- DELETE: radera en resurs
För det här exemplet kommer du att använda POST-begäran. Förutom att inkludera regeln som nämns ovan i din begäran kommer du att inkludera innehållstyp och auktorisering. Innehållstypen definieras sedan som “applikation/json”, så begäran presenteras i det lätta JavaScript Object Notation (JSON) dataformatet. För att autentisera din begäran måste du ersätta platshållartexten $BEARER_TOKEN med din applikations unika text, som kan genereras i din utvecklarportal.
curl -X POST 'https://api.twitter.com/2/tweets/search/stream/rules'
-H "Content-type: application/json"
-H "Authorization: Bearer $BEARER_TOKEN" -d
'{
"add": [
{"value": "from:twitterdev from:twitterapi has:links"}
]
}'
Varför är API:er viktiga?
En av de första frågorna många marknadsförare ställer är: Varför delar alla dessa företag sin data öppet och gratis?
Vanligtvis är svaret: skala. När mjukvaruföretag växer inser människor på dessa företag snabbt att de har fler idéer än de har tid och resurser att utveckla dem.
Genom att skapa API:er tillåter företag tredjepartsutvecklare att skapa applikationer som kan förbättra användningen och adoptionen av kärnplattformen. På så sätt kan ett företag bygga ett ekosystem som blir beroende av dess API-data, en dynamik som ofta leder till ytterligare intäktsmöjligheter.
Hur man använder ett API
Att förstå värdet av ett visst API handlar i huvudsak om att förstå vilken information som är tillgänglig genom ett API och hur den kan nås. För att ta reda på vad ett visst API kan göra för dig kan du göra en av två saker.
- Be en webbutvecklare att titta på ett API och diskutera det med dig.
- Gör forskningen på egen hand. Om du inte har tillgång eller budget för att använda en webbutvecklare är detta ett attraktivt alternativ. Men få inte panik, många onlinetjänster har bra API-dokumentation.
API dokumentation
Låt oss ta en snabb titt på Twitters API-riktmärke som ett exempel.
Mycket av Twitters tillväxt har berott på tredjepartsutvecklare, och det första Twitter API startade som en grundläggande wiki. Det har sedan dess utvecklats till ett detaljerat API som en marknadsförare kan använda för att avgöra vilken information som kan vara tillgänglig för en utvecklare i form av ett API och hur man inkluderar detta API på sin webbplats.
Om du tittar på skärmdumpen ovan kan du se att det finns flera kategorier av information tillgängliga för tredjepartsutvecklare. När du väl har valt ett API som du är intresserad av kan du klicka på det för att se vilken information som är tillgänglig via detta API. Kontrollera Twitters Tweet Timeline API-slutpunkt nedan.
I API-dokumentationen ovan förklarar Twitters Tweet Timeline API hur du kan ta en kort samling av senaste tweets från en specifik användares tidslinje och visa dem, i en klickbar form, på din egen webbplats. API-dokumentationen inkluderar volymbegränsningar för tweet, API-resurs-URL, samt vad du kan och inte kan välja att visa genom detta API.
Applicera API:t på din webbplats
Om du lägger till API-resurs-URL till backend av din webbplats, kommer den att returnera informationen du begärde till frontend av din webbplats. Så här ser det ut på New York Road Runners webbplats, vilket hjälper dem att marknadsföra New York City Marathon (med några anpassade designjusteringar):
Du kan också kolla in HubSpot API-dokumentationen för att se hur du kan bygga appar och integrationer med hjälp av HubSpot-data.
En sista varning: för att officiellt använda en utvecklares API kan du också behöva ha en API-nyckel tilldelad till dig.
Se din API-nyckel som din autentiseringstoken, vilket förklarar dig som medlem i en utvecklargemenskap. I själva verket identifierar denna token vad du använder API:et till och verifierar att ägaren av API:et har gett dig tillåtelse att utföra detta projekt.
Var säker, din API-nyckel ger utvecklaren tillgång till din personliga information.
API som marknadsföringsplattform
Marknadsföring i en inkommande värld handlar om att företag utvecklar användbara applikationer och tjänster för att behålla kunderna. Varumärken kommer att behöva sluta publicera reklam periodvis för att bli kommunikationskanaler med konsumenten.
I denna process tillhandahåller API:er de data som behövs för att tillhandahålla lösningar på kundproblem.
API-exempel
Att förstå vilken information som är tillgänglig via ett API hjälper dig att avgöra om det är värt det att arbeta med en utvecklare för att fortsätta projektet. Nedan följer två exempel.
Twitter omnämnanden
Om du vill visa tweets på din webbplats som inkluderar Twitter-omnämnanden av dina bloggartiklar, måste du förstå om du bara kan begära tweets med specifika webbadresser från Twitter API.
YouTube-videoinbäddning
När du högerklickar på en YouTube-video på youtube.com och väljer “Kopiera inbäddningskod” ber du i princip att få använda YouTubes API på din webbplats. YouTube gör det enkelt för allmänheten att bädda in YouTube-videor för att spela direkt på andra webbplatser.
API:s användarvillkor
Oavsett projekt är det viktigt att du verkligen läser och förstår användarvillkoren för ett API du överväger för din webbplats.
De flesta API:er har vissa användningsbegränsningar. Om du inte tar dig tid att förstå begränsningarna för ett API som du är intresserad av kan du lägga mer tid och pengar på att utveckla en marknadsföringstillgång som blir värdelös när API-leverantören fastställer att du har brutit mot API:s användarvillkor . API:et. (och återkallar din åtkomst).
Av denna anledning har de flesta API:er “anropsgränser”.
Vad är ett API-anrop?
Ett API-anrop, även känt som en API-begäran, är en instans där en webbplatsägare “begär” användning av en utvecklares API. Att spara API, inloggning på utvecklarens webbplats och frågor om appen räknas som API-anrop.
Med detta i åtanke är en API-anropsgräns antalet gånger du kan begära information om ett API från en webbtjänst inom en given tidsperiod. Återigen, läs användarvillkoren för alla API du funderar på att använda. Dessa dokument bör tydligt beskriva eventuella begränsningar samt lämplig användning av programmet.
Framtiden för API:er i näringslivet
Att bygga på befintliga API:er för webbtjänster är bara början. Vi lever i en värld som nu förväntar oss innehåll som är öppet och tillgängligt för alla; Den naturliga utvecklingen av detta är att publicister själva släpper sina egna API:er, så att kunderna kan utveckla applikationer som ett resultat.
API-delning gäller för alla företag, inte bara webbaserade, utan alla som har ett verktyg eller en komponent i sin organisation webbaserad. Uppenbarligen kan detta koncept skapa hinder för vissa organisationer, särskilt den juridiska avdelningen. Det är upp till dig att ta reda på vilka API:er som är mest värdefulla och hur du kan använda dem lagligt och hållbart.
