SharePoint API och REST API: vad är de och vad används de till?

SharePoint API: vad är de och vad används de till?

API:er är det sätt på vilket ett program kan kommunicera med ett annat program eller med en extern datakälla.

När det gäller SharePoint Online gör API:erna det möjligt att berika en webbplats, till exempel företagsintranätet, genom att utveckla anpassade och dynamiska komponenter.

Utvecklare använder API:er för att koppla SharePoint till specifika datakällor, varifrån de hämtar information för att skapa funktioner och innehåll som integreras direkt i en webbplats webbdelar.

Till exempel kan en webbdel kopplas till en extern databas för att visa listan över arkiverade projekt, så att behöriga användare snabbt kan komma åt relevant information.

När informationen i en datakälla som är ansluten till SharePoint via API:er uppdateras kan innehållet i webbdelarna synkroniseras.

Men uppdatering i realtid beror på konfigurationen: ofta krävs en manuell uppdatering av sidan eller implementering av anpassade lösningar, som specifika skript eller funktioner för automatisk uppdatering.

SharePoints API:er delas in i fyra huvudkategorier. Låt oss se dem i tabellen nedan.

 

SharePoint-API: huvudtyper

 

Typer av SharePoint-API	Beskrivning
REST API	Ger åtkomst till och hantering av SharePoints resurser via enkla HTTP-anrop. RESTful-begäranden gör att du kan utföra CRUD-operationer (Create, Read, Update, Delete) på objekt som listor, dokument och webbplatser, vilket gör dem till ett nyckelverktyg för många integrationer.
Client-Side Object Model	Ett uppsättning bibliotek som kan användas i språk som JavaScript, .NET och Silverlight. CSOM-API:er är användbara för klientbaserade operationer och kör kod direkt i användarens webbläsare eller i skrivbordsapplikationer.
JavaScript Object Model	En variant av CSOM specifikt för JavaScript, som främst används för att skapa dynamiska gränssnitt i SharePoints webbdelar. Den används i stor utsträckning för att anpassa företagswebbplatser.
SOAP Web Services	Även om de används mindre än de andra gör dessa API:er det möjligt att kommunicera med SharePoint via XML-baserade protokoll. Trots att de har en sekundär roll är de fortfarande användbara i äldre miljöer eller för särskilda integrationer.

 

Tack vare API:erna kan du koppla SharePoint till ett brett spektrum av datakällor och externa tjänster, inklusive databaser (som SQL Server), molntjänster (som Microsoft Azure) och ERP/CRM-system (som Dynamics 365 och Salesforce).

Dessa integrationer gör att du kan centralisera informationen i företagsintranätet eller i vilken SharePoint Online-baserad webbplats som helst, och eliminerar behovet av att användare ska gå in i separata system för att få den information de behöver eller att manuellt överföra data efter varje uppdatering.

API:erna är därför de grundläggande byggstenarna för att skapa, anpassa och underhålla alla webbdelar som berikar funktionerna och innehållet på en SharePoint-webbplats, och de erbjuder ett kraftfullt och flexibelt ekosystem som kan möta alla behov.

 

SharePoint REST API: vad är de och vad används de till?

REST-API:er, som står för Representational State Transfer Application Programming Interfaces, är en uppsättning arkitektoniska principer för att utforma och utveckla nätverkssystem.

REST-arkitekturen fokuserar på begreppet resurser. Den bygger på en kommunikationsmodell där klienter skickar förfrågningar till servrar för att utföra åtgärder på specifika resurser.

Dessa förfrågningar uttrycks vanligtvis som HTTP-metoder som GET, POST, PUT, PATCH och DELETE, där varje metod motsvarar olika operationer på resurser.

När det gäller SharePoint kan resurserna som REST-API:erna arbetar med vara:

• Poster i en lista
• Dokument i ett bibliotek
• En webbplats i sin helhet

Klienter kan därför skicka HTTP-förfrågningar för att utföra åtgärder på resurser, till exempel hämta viss information eller göra ändringar. Ett exempel är att skicka en GET-förfrågan för att få detaljer om ett dokument i ett SharePoint-bibliotek. Ett annat exempel är en POST-förfrågan, som ofta används för att lägga till nya poster i en lista.

Denna flexibilitet gör REST-API:er till ett kraftfullt verktyg för att integrera och automatisera interaktioner med SharePoint. Det gör att utvecklare kan bygga applikationer som enkelt kopplar upp sig mot plattformens data och funktioner.

Andra aspekter som kännetecknar SharePoints REST-API:er är:

• Enkel användning, vilket gör att du kan arbeta effektivt med både strukturerad och ostrukturerad data.
  
  
• Säkerhet, eftersom autentisering hanteras via OAuth och åtkomsttoken. Det innebär att endast behöriga användare och applikationer kan interagera med resurserna.
  
  
• Oberoende av kontext, eftersom REST-förfrågningar kan göras från alla miljöer som stödjer HTTP-anrop, inklusive webbläsare och mobila appar.
  
  
• Skalbarhet, vilket möjliggör hantering av ett stort antal samtidiga förfrågningar utan att överbelasta servern.
  
  

Men hur kan du använda SharePoints REST-API:er i praktiken i företaget?

Som sagt är REST-API:er ett nyckelverktyg i SharePoint Online-ekosystemet för att automatisera processer, integrera system och skapa anpassade lösningar som berikar webbplatser som intranätet och extranätet. Ett första användningsfall kan därför gälla automatisering av dokumenthantering.

Ett signerat avtal kan till exempel laddas upp till ett SharePoint-bibliotek med fördefinierade metadata, så att det blir lätt att hitta för den juridiska avdelningen. På samma sätt kan lagrade data användas för att bygga interaktiva instrumentpaneler och integreras med verktyg som Power BI för att följa KPI:er eller statusen för ett projekt.

Du kan också skapa system för aviseringar eller godkännanden som förenklar hanteringen av dagliga arbetsuppgifter. Till exempel kan REST-API:erna användas för att automatiskt skicka ett e-postmeddelande till ansvarig när ett objekt i en viss SharePoint-lista kräver deras godkännande.

REST-API:er används även för att skapa portaler för medarbetare, till exempel för åtkomst till personliga dokument eller för att skicka supportärenden. De kan dessutom integreras med tredjepartssystem, som CRM eller HR-verktyg, för att centralisera information om personal, leverantörer och kunder.

 

 

Vad är skillnaden mellan API och REST API i SharePoint?

Som vi har sett är API:er uppsättningar av definitioner och protokoll som gör att olika programvaror kan kommunicera med varandra. Det finns flera typer, bland annat biblioteks-API:er, operativsystems-API:er eller webbtjänst-API:er, som kan utformas med olika arkitekturstilar och protokoll som SOAP, GraphQL och REST.

REST API:er är specifikt en typ av API som följer de arkitektoniska principerna för REST (Representational State Transfer).

Denna stil kännetecknas av ett tillståndslöst kommunikationsmönster där varje begäran från klienten till servern innehåller all information som behövs för att utföra den begärda åtgärden. REST API:er använder HTTP-metoderna (GET, POST, PUT, PATCH, DELETE) för att utföra operationer på resurser som identifieras av unika URL:er.

Alltså: medan alla REST API är API är inte alla API REST API.

Även i SharePoint är REST API:er bara ett av många sätt som du kan använda för att interagera med externa plattformar och datakällor.

I synnerhet är det användbart att använda REST API:er för att skapa webbdelar på en SharePoint-webbplats när du behöver en lätt och flexibel kommunikation med anslutna datakällor.

REST API:er gör det möjligt att bygga dynamiska och interaktiva webbdelar som kan koppla upp sig mot en mängd interna och externa datakällor utan att kompromissa med prestanda eller kodens enkelhet.

Andra typer av API:er kan vara lämpliga i andra situationer.

Till exempel passar SOAP-API:er bättre för komplexa integrationer som kräver större kontroll över kommunikationen. På samma sätt föredras CSOM-API:er av utvecklare som arbetar med en objektmodell på klientsidan, vilket ger en mer naturlig utvecklarupplevelse i applikationer.

Till vilka datakällor kan SharePoint ansluta via API:er?

Tack vare API:er kan SharePoint Online ansluta till ett brett utbud av datakällor och program för att berika funktionerna och innehållet på webbplatser som företagsintranätet. Just i fallet med intranätet kan webbdelskomponenter utnyttja SharePoints API:er för att ansluta till följande datakällor.

 

 

1. Listor och bibliotek i SharePoint

Webbdelskomponenter kan interagera med SharePoints listor och bibliotek via API:er för att hantera strukturerade data som meddelanden, kontakter, evenemang och uppgifter. Detta möjliggör en intuitiv visning och direkt redigering av innehåll, inklusive företagsdokument och mediefiler, utan att du behöver lämna den SharePoint-webbplats där webbdelen finns.

 

Webbdel för att främja företagsnyheter i Intranet.ai:s SharePoint-intranät

2. Externa databaser

Även om SharePoints REST API inte stöder en direkt anslutning till externa databaser var det tidigare möjligt att använda tjänster för applikationsintegrering (Business Connectivity Services, eller BCS) för att ansluta till relationsdatabaser eller OData-källor. Microsoft har dock permanent avvecklat BCS från och med den 30 september 2024.

I dag är det därför lämpligt att använda verktyg som Power Apps och Power Automate för att integrera denna information i SharePoint, eftersom de erbjuder dedikerade konnektorer för att på ett säkert och flexibelt sätt koppla relationsdatabaser. Dessa verktyg gör det dessutom möjligt att skapa intuitiva gränssnitt för att hantera data direkt i intranätet utan behov av mellanliggande lösningar.

 

Integrera data i SharePoint med Power Apps

3. Applikationer i Microsoft 365

Via API:er kan du integrera i SharePoints webbdelar den information som kommer från andra produkter som utgör den digitala arbetsplatsen i Microsoft 365. Bland dessa finns:

• Outlook, för att integrera e-post, kalendrar och kontakter;
• OneDrive, för att förenkla hanteringen av personliga och delade filer.
• Teams, för att integrera chattar, kanaler och andra samarbetsfunktioner.
• Planner, för att uppdatera projektaktiviteter och samordna teamets arbete.

 

Microsoft Planner-webbdelen för SharePoint

4. Molntjänster

SharePoint-webbdelar kan kommunicera med Microsoft Azures tjänster, inklusive Azure Blob Storage, Azure Functions och Azure SQL Database. De kan dessutom visa Power BI-rapporter och instrumentpaneler.

 

Integrering av en Power BI-rapport i SharePoint Online

5. ERP/CRM

SharePoint-webbdelar kan hämta data som finns i system som Microsoft Dynamics 365 och Salesforce. Information om kunder, försäljning och supportaktiviteter blir därmed tillgänglig på intranätet och stödjer användarnas arbete.

Till exempel kan säljteamet visa de senaste kundkommunikationerna som hanteras av supportteamet och få värdefulla insikter för att hantera affärsförhandlingar. På samma sätt kan supportteamet få åtkomst till försäljningsdetaljer för att analysera kundernas problem och föreslå lösningar för att lösa dem.

 

Integration av data i Microsoft Dynamics 365 i SharePoint

6. Sociala medier och andra kommunikationskanaler

Du kan integrera webbdelar med företagets profiler på sociala medier, till exempel LinkedIn eller Twitter, för att visa de senaste inläggen på intranätet eller lyfta fram det viktigaste innehållet för organisationen.

 

Webbdel "Inlägg i sociala medier" från intranet.ai

Förutom sociala medier kan du också importera innehåll i RSS-format till SharePoint, till exempel nyheter från en branschtidning online.

 

Webbdel "RSS-flöde" från intranet.ai

SharePoint API och Microsoft Graph API: finns det en relation?

Microsoft Graph är en utvecklingsplattform som erbjuder en enhetlig gateway för åtkomst till data och tjänster i Microsoft 365, inklusive Azure Active Directory, Outlook, OneDrive, Teams, Excel, Planner och SharePoint.

Den låter dig komma åt Microsofts många tjänster från en enda ingångspunkt, vilket avsevärt förenklar utveckling och hantering av applikationer för utvecklare.

Graph stöder dessutom ett brett spektrum av åtgärder, bland annat:

• interaktion med filer och dokument i OneDrive
• hantering av e-post och kalender i Outlook
• samarbete och kommunikation i Microsoft Teams
• hantering av användaridentiteter i Azure Active Directory

Det finns alltså en nära koppling mellan API:erna i Microsoft 365-produkter och API:erna i Microsoft Graph, och SharePoint är inget undantag.

Integreringen av SharePoint-API:erna i Microsoft Graph-ekosystemet gör att utvecklare kan komma åt SharePoints data och funktioner via samma slutpunkter och autentiseringstoken som används för andra Microsoft 365-tjänster.

I praktiken tillhandahåller Microsoft Graph-API:erna ett enhetligt gränssnitt för att interagera med SharePoint-resurser, vilket gör interoperabiliteten mellan just SharePoint och andra Microsoft 365-tjänster smidigare.

Med Microsoft Graph kan du till exempel hämta information om en SharePoint-webbplats, komma åt dokument som lagras i ett bibliotek eller hantera behörigheter till företagsfiler. Enkelt, via HTTP-anrop.

Resultatet är en robust och integrerad plattform som förenklar utvecklingsprocessen och gör det möjligt för företag att utnyttja potentialen i sina data och applikationer fullt ut.

FAQ om SharePoint API och REST-API

Vad är SharePoint-API:er och vad används de till?

SharePoint-API:er är uppsättningar av definitioner och protokoll som möjliggör kommunikation mellan SharePoint och andra applikationer eller externa datakällor. Dessa API:er gör att du kan skapa, anpassa och underhålla de webbdelar som utgör webbplatser som till exempel företagsintranätet, vilket säkerställer integration och automatisk uppdatering av innehåll.

Vad är SharePoints REST-API:er och vad används de till?

SharePoints REST-API:er bygger på en uppsättning arkitekturprinciper för att designa och utveckla nätverkssystem. De gör det möjligt för dig att komma åt och manipulera SharePoint-resurser via enkla HTTP-anrop och att utföra CRUD (Create, Read, Update, Delete) på objekt som listor, dokument och webbplatser.

Vad är skillnaden mellan API och REST-API i SharePoint?

API:er är uppsättningar av definitioner och protokoll för kommunikation mellan olika programvaror, medan REST-API:er är en typ av API som följer REST-principerna (Representational State Transfer). REST-API:er använder HTTP-metoder för att utföra operationer på resurser som identifieras av unika URL:er. Alla REST-API:er är API:er, men inte alla API:er är REST-API:er.

Vilka datakällor kan SharePoint ansluta till via API:er?

SharePoint kan ansluta till en bred uppsättning datakällor via API:er, inklusive SharePoint-listor och -bibliotek, externa databaser (till exempel SQL Server och Oracle), Microsoft 365-appar (Outlook, OneDrive, Teams, Planner), molntjänster (Microsoft Azure, Power BI), ERP/CRM (Dynamics 365, Salesforce), verktyg för Business Intelligence (Tableau, Qlik) och kommunikationskanaler som sociala medier och RSS-flöden.

Finns det en relation mellan SharePoint-API:er och Microsoft Graph API?

Ja, Microsoft Graph är en plattform som erbjuder en enhetlig gateway till data och tjänster i Microsoft 365, inklusive SharePoint. Integreringen av SharePoint-API:er i Microsoft Graph gör att utvecklare kan komma åt SharePoints funktioner via samma slutpunkter och autentiseringstoken som används för andra Microsoft 365-tjänster, vilket förenklar interoperabiliteten mellan SharePoint och andra Microsoft-tjänster.