Webhooks i EasyPractice låter dig skapa enkla och säkra integrationer

Hej alla!

Idag vill jag berätta om en ny uppdatering till vår API-dokumentation. Vi har fått förfrågningar om att lansera Webhooks och det är nu kommet! Kanske har du kikat på att göra en integration med EasyPractice tidigare, och det är enklare nu än det någonsin har varit.

Men vad är API:er och Webhooks egentligen, och hur kan du använda dem? Jag kommer att svara på frågorna och mycket mer i det här blogginlägget, så att du är förberedd för att komma igång med att använda Webhooks. Jag börjar helt enkelt med att förklara begrepp, och sedan kan vi titta på den praktiska tillämpningen av Webhooks.

Vad är API och hur använder man det?

API står för Application Programming Interface; det vill säga ett programmerbart användargränssnitt för appar. Kortfattat innebär det att ett API används för att skicka data mellan program, som normalt inte kommunicerar med varandra. Om du redan använder en integration med EasyPractice som Fortnox, MailChimp eller Google Calendar sker överföringen av data via vårt och deras API. Vi ser till att överföringen av data sker säkert, och det är vad den kan använda en API-nyckel till. En lång rad slumpmässiga bokstäver och siffror som fungerar som ett lösenord. På så sätt kan bara den auktoriserade plattformen utbyta information med varandra – och givetvis på en säker anslutning.

Vad är en Webhook, och hur skiljer det sig från API?

En Webhook beskrivs av många som ett omvänt API. På API begär den tredje parten data från EasyPractice API. En Webhook är annorlunda eftersom den skapas direkt i EasyPractice API, och om den utlöses skickar den data. Vi stödjer för närvarande tre händelser som utlöser Webhooken. Det är:

• Bokning skapad
• Bokning ändrad
• Bokning raderad

Med dessa tre händelser kan du välja när EasyPractice API ska skicka data till din mottagaradress. Det kan till exempel vara så att du vill ha dina bokningar över i en databas och då är det smart om du både har en Webhook för att skapa, ändra och ta bort dina bokningar. På så sätt får du allt i databasen, så att du inte förlorar något. Du måste se till att din mottagaradress kan ta emot en post i ”POST”-format. Det är en av de fyra grundläggande händelserna, som kan göras via en normal API-kodning.

Hur skapar jag en Webhook?

Att skapa en Webhook är superenkelt. Allt du behöver göra är att aktivera ”API”-appen i EasyPractice. Du hittar den under ”Appar”. När du har gjort det är du redo att skapa dina Webhooks.

1. Gå in under ”Inställningar” -> ”API” -> ”Webhooks”
2. Klicka på ”Skapa webhook” som visat nedan:

3. Ge din Webhook ett namn, en URL till dit data ska skickas och välj den händelse som ska utlösa Webhooken. Kom ihåg att URL:en måste vara en länk av HTTPS-typ så att vi kan skicka informationen säkert med TLS-kryptering.

4. Spara din Webhook – så är det klart!

Då är du redo att använda Webhooks! När det finns ny data från ditt EasyPractice-konto skickas data automatiskt till din URL-adress. Det blir nästan inte lättare.

Har du frågor om Webhooks, API:er eller något helt annat? Skicka då ett mail till [email protected] så hjälper vi dig!