API Manual, ikke-udviklervejledning til API'er

"Kan vi oprette forbindelse til andre apps?" Spørgsmålet om, at virksomhedsejere skal kende svaret og "API" er nøglen!

Har du nogensinde haft lyst til at sidde i et marketingmødelokale? Pludselig sagde nogen "API"? Alle nikkede, som at forstå, men dybt, vi er måske stadig forvirrede, "Hvad er disse tre karakterer?" Eller når du skal købe nye programmer eller software, og salget siger: "Denne har en API til at forbinde komfortabelt." Du kan kun smile og tænke i sindet, at "er det godt eller dårligt?"

Hvis du har stødt på en situation som denne, er du ikke alene. Dette problem er normalt for mennesker, der ikke er programmerere. Uanset om det er virksomhedsejere, marketingfolk eller salgsteam, der skal arbejde med teknologi hver dag, men ikke skriv koden selv. At føle sig som at blive efterladt, når vi taler om teknikker, er et ubehageligt problem og får os til at gå glip af forretningsmuligheder desværre i dag vil vi ødelægge den væg!

‍

[Spørg om illustration]

"Et billede af en forretningsmand eller marketingmedarbejder gjorde lidt forvirret. Siddende i et moderne mødelokale med ordet 'API?' Flydende som et spørgsmålstegn over hovedet.

Hvorfor er "API" svært? På trods af at være omkring os hele tiden?

Hovedårsagen til, at API bliver en "skræmmende" teknisk betegnelse, fordi dens oprindelse er forårsaget af softwareudviklere verden. De fleste mennesker, der forklarer dette, er programmerere, der taler med programmerere selv. De bruger en unik og klar betegnelse i hans gruppe. Men for udenforstående er det som at lytte til en god fremmed dialog.

Forestil dig, når vi spørger, hvad API er, får vi ofte svaret, "Det er applikationsprogrammeringsgrænsefladen. Reglerne og protokollerne, der gør software, kan kommunikere", som ... det er korrekt, men det hjælper os ikke med at se billedet! Som vi spurgte vejen til Siam, så få svaret som en breddegrad koordinerer-Lonjit tilbage. Det mangler "formidlere" ved at oversætte det tekniske sprog til en historie, som folk kan forbinde. Dette er grunden til, at mange mennesker giver op og ser, at API er en fjern sag. På trods af det faktum, at vi alle bruger API'er ti gange om dagen uden engang at vide det.

‍

[Spørg om illustration]

"Sammenligningens tegneseriebillede til venstre er en programmør. Taler den komplekse kode. Højre side er en marketingmedarbejder, der ikke forstår. Med en mur, der har ordet 'jargon' (teknisk ordforråd) i midten"

Lad "ikke vide" yderligere ... kan miste flere forretningsmuligheder, end du tror

Ikke at forstå, hvad API er en triviel sag. Men i den digitale forretningsverden påvirker det mere, end du tror. Forestil dig disse situationer:

• Mangler muligheden for at oprette et automatisk system: Du kan stadig bruge eksporten fra et system (f.eks. Facebook -blyannoncer) og import i et andet system (såsom CRM eller Google Sheets) hver dag, selvom dette arbejde automatisk kan være med API, hvilket sparer en masse tid på teamet. Og er noget, som moderne marketingautomationssystemer er normale
• Vælg at købe forkert software: Du kan investere i at købe dyre software uden at vide det "tale" med andre programmer. At din virksomhed overhovedet ikke kan bruge (også kendt som "No API" eller "API lukket"), hvilket får dataene fra hver afdeling til at blive spredt. Ikke knyttet sammen bliver en silodata, der er vanskelig at analysere det samlede billede
• Usemaet Race: Mens dine konkurrenter bruger API til at forbinde forskellige systemer til at skabe en god oplevelse for kunderne, såsom at kontrollere ordrer med det samme eller udstede et automatisk tilbud, men vi er stadig nødt til at bede kunden om at ringe for at bede eller vente på, at personalet laver et manuelt dokument
• Kan ikke evaluere projektet: Når udviklerteamet tilbyder et projekt, der kræver API, er du muligvis ikke i stand til at vurdere værdi, kompleksitet eller dets sande fordele. Resulterer i teknologiinvesteringsbeslutninger baseret på ren gæt

Manglen på forståelse af API er den samme som at prøve at bygge et hus uden at forstå, at "døre" eller "windows" fungerer. Vi bygger muligvis alle væggene. Der får vores hjem til ikke at kunne bruge den fulde effektivitet og mangel på vigtige forbindelser

‍

[Spørg om illustration]

"Grafikken viser spredte data til separate øer (siloer), såsom CRM, Accounting Island, Website Island, med en båd med navnet 'API' parkeret stadig, fordi ingen bruger. Får de oplysninger til at rejse til hinanden."

Den nemmeste løsning: glem først koden og tænk på "servitrice i restauranten"

Okay, det er tid til at låse API's hemmeligheder op på den nemmeste måde. Glem alle tekniske udtryk først. Og forestil dig, at du sidder i en luksusrestaurant

I denne restaurant er der 3 hovedkomponenter:

1. Du (kunder): Den person, der ønsker at bestille mad (du er den 'applikation', der har brug for information)
2. Køkken: Madlavningssteder og indsamling af alle råvarer (dette er 'server' eller 'database', der gemmer de ønskede data).
3. Servitrice: Den person, der modtager ordren fra dig, gik ind i køkkenet for at fortælle kokken og derefter medbringe den færdige mad til at servere dig ved bordet

I denne situation er "servitrice" "API".

Servitrice (API) er ansvarlig for "formidler" i din kommunikation (applikation). Det er ikke nødvendigt at vide, at i køkkenet (server) hvor travlt at lave mad eller hvor man skal beholde råmaterialerne, det eneste, du skal gøre, er at "bestille mad fra menuen" (send en anmodning eller anmodning via API), så vil servitrice (API) styre resten. Og bringe resultaterne (mad eller data) tilbage til dig

Så i resumé er API:

• Ikke en database: Det er ikke selve køkkenet, men det er en "kanal" at bede om ting fra køkkenet.
• Der er klare regler: Du skal kun bestille mad fra "menuen". Vil ikke være i stand til at bestille menuer, der ikke findes, ligesom API, der har et sæt kommandoer, der kan bede om oplysninger
• Hjælp med sikkerhed: Servitrice giver dig ikke mulighed for at gå. Gå ind i køkkenet selv. API hjælper med at forhindre nogen i at få adgang til systemdatabasen direkte.

Dette koncept er et vigtigt grundlag for mange moderne softwarearkitektur, såsom hovedløs CMS eller komponeret arkitektur, der fokuserer på at adskille fronten og baghaven. Og forbinde med API for maksimal fleksibilitet

‍

[Spørg om illustration]

"Sødt og let -forstående info -billede af en person, der sidder ved spisebordet (applikation), bestiller mad med servitrice (API), og servitrice går til køkkenbordet (server) med en kok. Med pile, der viser retningen for ordenen og modtager mad (svar)"

Eksempler på API i det virkelige liv, som du bruger hver dag (men vidste aldrig!)

Efter at have set billedet fra restauranten, ikke? Lad os nu se på de rigtige eksempler i den digitale verden. Og du vil blive forbløffet over, hvor tæt API er:

• "Log ind med Google/Facebook": Når du indtaster det nye websted eller app og doven, trykker du ofte på knappen. "Log ind med Google", ikke? I det øjeblik du trykker på. Er det webstedet (kunden) sender servitrice (API) for at spørge Google (køkken), "Denne person er den rigtige, der er licenseret, ikke?" Google svarede: "Ja," det websted giver dig mulighed for straks at logge ind. Som du ikke behøver at udfylde en ny adgangskode, og det websted ikke ser din Google -adgangskode.
• Vis kortet på hotellets websted: Når du indtaster Agoda -webstedet eller booking.com, og se Google Maps -kortet begravet foran hotellet. Det er Agoda -webstedet (kunder), der bruger Google Maps API (Kitchen) til at hente kortdataene.
• Mobil Air Prognose: Air Application -appen på din mobiltelefon har ikke din egen vejrstation. Men den app (kunde) bruger API til at hente oplysninger fra instituttet for afdeling eller vejrtjenesteudbyder (køkken) til at vise dig i realtid
• Sammenligning af flybilletter: Web Skyscanner eller Traveloka er ikke ejeren af flyselskabet. Men de skabte "den ultimative tjener" (API), der løb for at spørge prisen fra "køkkenet" i flyselskabet rundt om i verden (såsom Thai Airways, AirAsia, Nok Air) og bringe alle oplysninger tilbage til dig på en skærm.

Ser du, at API er personen bag mange bekvemmeligheder i onlineverdenen? Det er det, der fremstiller applikationer og tjenester. "Tal med ved" og udveksler information glat og sikkert. Se mere information om API og grundlæggende arbejde på Postman API 101.

‍

[Spørg om illustration]

"4 smukke kraveudstillinger, der viser eksempler på at bruge API i det virkelige liv: Kanal 1-ICON 'Login med Google', Channel 2- Hotel Map på side 3-Air Conditioning-app på mobil, kanal 4-siders søgeresultater til flybilletter"

Vil du begynde at bruge fra API, hvad skal jeg gøre? (Virksomhedsejer version)

Når du forstår begrebet API, er det næste spørgsmål "Hvordan kan jeg bruge det til min virksomhed?" Bare rolig. Du behøver ikke at skrive koden selv, selv en linje! Prøv at starte fra et simpelt trin. Disse ser på:

1. Udforsk de anvendte værktøjer: Prøv at liste alle de programmer eller software, som din virksomhed bruger i dag (såsom CRM, regnskabssystem, chatprogram, platform til reklame)
2. På udkig efter ordet "Integrations" eller "API": Gå til webstedet for denne software. Og på udkig efter en menu med navnet "Integrations", "Marketplace", "Apps" eller "API -dokumentation" er dette pligten til at sige, at dit program har en "madmenu" (API) til at bestille og kan "forbinde" til andre programmer eller ej.
3. Brug "automatiseringsværktøjer": I øjeblikket er der en fantastisk platform, der fungerer som "det ultimative personale for den serverende" specifikt for dig. Disse værktøjer kender "madmenuen" for de berømte apps til tusinder af apps og giver dig mulighed for at oprette en simpel forbindelse. Bare trækplads. For eksempel:
   • Zapier: Det er et værktøj, der er let at bruge og er meget populært. Velegnet til begyndere
   • N8n.io: Meget fleksibel og kraftfuld. Kan være lidt mere kompliceret, men kan gøre mere kompliceret, og dette er en af vores eksperter, der læses mere på N8N Automation X10 -eksperter.
4. Opret et problem fra "dovenskab": prøv at finde et job gentagne gange i et firma, som ingen vil gøre. For eksempel, "Hver gang der er en ny kunde i HubSpot, skal den oprette en mappe på Google Drive" eller "Hver gang kunden betaler gennem Stripe, skal du sende en besked til teamet i slakken." Disse værker er "automatiske muligheder" til at bruge tid til at spare tid og reducere fejl. Det åbenlyse eksempel er HubSpot -forbindelsen til WebFlow for automatisk at sende data fra formularen på nettet til CRM.

Begyndelsen på API mener er at ændre udsigten fra det "manuelle" arbejde til det "automatiserede" arbejde, som allerede bruges af det meste af softwaren. Læs mere om de grundlæggende koncepter i API på Zapiers guide til API'er.

‍

[Spørg om illustration]

"Smukke tjeklistebilleder og let at læse. Vis 4 trin ovenfor med ikoner i hvert element, såsom forlængelsesglas ikoner, strømstikikoner, robotikoner og lampeikoner"

Spørgsmål, som folk har en tendens til at undre sig over API (Q & A klar snit)

Jeg har udarbejdet et populært spørgsmål, der ofte opstår efter at have forstået de grundlæggende begreber i API.

Q1: Bruger du API?
A: Der er både gratis og affald! Mange API'er, især i berømte tjenester, der normalt er gratis i en vis grad (såsom at anmode om information 1.000 gange om måneden), men hvis det bruges for tungt, det kvote, der er specificeret, kan det være nødvendigt at betale yderligere beløb i henhold til brugsmængden. Eller køb en højere prisplan skal kontrollere betingelserne for hver tjenesteudbyder

Q2: API og integration er den samme eller forskellige?
A: Det er et meget godt spørgsmål! Tror, at API er "ingredienserne i køkkenet", der tillader forbindelsen at forekomme. Integrationen er "den mad, der er tilberedt". For eksempel har Google Sheets en API åben for udvikleren. Men når vi bruger Zapier til at forbinde Google Sheets med Gmail, det vil sige, vi bruger "integration", som Zapier har oprettet. Som baggrunden for det er at køre API for begge tjenester

Q3: Hvor sikker er de data, der transmitteres gennem API?
A: Meget sikker. (Hvis det gøres korrekt) Kommunikation gennem API, har de fleste af dem kryptering (kryptering) som når vi kommer ind på bankens websted. Og har ofte brug for at bruge den "nøgle nøgle", der er som en bestemt hemmelig kode til din app for at anmode om oplysninger for at bekræfte, at du er den person, der virkelig er licenseret

Q4: Hvis den software, jeg bruger, er der ingen integration, som jeg ønsker, men der er en API at bruge. Hvad skal jeg gøre?
A: Dette er pointen at tale med udvikleren! Softwaren har en API at bruge, som en restaurant med gode ingredienser. Men der er ingen menu, du ønsker. Du kan "ansætte en kok" (programmerer). Brug disse API'er "specielle retter" (Opret en brugerdefineret integration), der møder din virksomhed specifikt.

‍

[Spørg om illustration]

"Spørgsmål om tegneserie-stil tegneseriebilleder-2-tegn taler. Den ene stillede spørgsmål fra listen. Og den anden svarer selvtillid og klar."

Konklusion: API er ikke en programmør, men er en "en fordel" for forretningsværktøjer.

På dette tidspunkt håber jeg, at "API" ikke længere vil være et skræmmende ord for dig. Dets hjerte er let: API er "servitrice" eller "postman" i den digitale verden. Der tjener til at modtage og sende data mellem forskellige programmer for at tale om

At forstå dette koncept får dig ikke til at sidde og skrive koden, men giver dig en ny "briller", som du kan se. "Muligheder" til at forbedre alle skjulte virksomheder. Du vil begynde at se slagtekroppen, der kan være automatisk. Du vil være i stand til at købe teknologi smartere. Og du vil være i stand til at tale med udviklingsteamet med flere og flere retninger

Lad ikke uvidenhed om teknikker som en mur for at blokere væksten i din virksomhed. Prøv i dag at udforske de værktøjer, du har. Prøv at stille spørgsmålet "Hvad skal der forbindes?" Og du vil opdage, at API's magt kun er inden for rækkevidde. Og klar til at låse din virksomheds ydeevne op som aldrig før

Det er tid til at ændre sig fra hårdt arbejde. At arbejde smart ved at oprette forbindelse!

‍

[Spørg om illustration]

"Et billede af en forretningsmand, der står på toppen af bakken, ser på horisonten, der er fuld af applikationer af forskellige applikationer, der er forbundet med smukke lyslinjer, formidler synspunkterne på forretningsmuligheder, der er brede gennem API -forbindelsen."

‍