SharePoint API og REST API: Hvad er de til for?

API'er er de midler, hvormed forskellige systemer kommunikerer med hinanden og udveksler data og kommandoer. SharePoint, den vigtigste samarbejdsplatform i Microsoft 365, udnytter forskellige typer API'er til at gøre det muligt for brugerne at oprette, tilpasse og vedligeholde de webdele, der udgør websteder som f.eks. virksomhedens intranet. Blandt disse API'er spiller REST API'er en vigtig rolle på grund af deres fleksibilitet.

I denne artikel vil vi se nærmere på, hvad SharePoint API'er er, og hvad de bruges til, hvad der kendetegner REST API'er, og hvilken funktionalitet der er mulig gennem integration med Microsoft Graph.

SharePoint API: Hvad er de?

I programmering repræsenterer API'er de midler, hvormed et program er i stand til at kommunikere med et andet program eller en ekstern datakilde. I SharePoints tilfælde gør API'er det muligt at oprette webdele af et websted, f.eks. et intranet.

Udviklere bruger derefter API'er til at forbinde SharePoint med specifikke datakilder, hvorfra de henter de oplysninger, der er nødvendige for at levere indhold og funktionalitet i de webdele, der udgør et websted.

Når oplysninger fra en datakilde, der er forbundet med SharePoint via API, opdateres, er det vigtigt at bemærke, at indholdet i den relaterede webdel opdateres automatisk og i realtid.

SharePoint API'er falder i fire hovedkategorier:

1. REST API'er, som tillader adgang til og manipulation af SharePoint-ressourcer med simple HTTP-kald. Generelt udfører RESTful-anmodninger CRUD-operationer (Create, Read, Update, Delete) på elementer i SharePoint såsom lister, dokumenter og websteder.
   
   
2. Client-Side Object Model (CSOM): Den type API, der leverer et sæt biblioteker til brug i sprog som JavaScript, .NET og Silverlight til at interagere med SharePoint. Disse API'er er nyttige til at udføre operationer på klientsiden, da de involverer udførelse af kode direkte i brugerens browser.
   
   
3. JavaScript Object Model (JOM): En kategori af API'er, der ligner CSOM, men som er specifik for JavaScript. Den bruges derfor ofte til at skabe de dynamiske grænseflader i SharePoint-webdele.
   
   
4. SOAP Web Services: Selvom de er mindre udbredte end de andre, gør disse API'er det muligt at kommunikere med SharePoint via XML-baserede protokoller.
   
   

SharePoints sæt af API'er gør det muligt at forbinde webdele til en lang række datakilder, herunder eksterne databaser (f.eks. SQL Server), cloud-tjenester (som Microsoft Azure), ERP/CRM-systemer (f.eks. Dynamics 365 og Salesforce) og en lang række andre tjenester og applikationer.

Hvis vi tager API-forbindelsen med en SQL-server som eksempel, kan en webdel vise listen over projekter, der er gemt i databasen. Denne integration gør det muligt for autoriserede brugere at se de oplysninger, de er interesserede i, direkte på SharePoint-intranettet uden at skulle have adgang til separate systemer eller manuelt overføre data efter en opdatering.

Dette er, hvad SharePoint API'er er: de byggesten, vi har brug for til at bygge, tilpasse og vedligeholde alle de webdele, der beriger funktionaliteten og indholdet på ethvert SharePoint-site.

SharePoint REST API: Hvad er de?

REST API'er, som står for Representational State Transfer Application Programming Interfaces, er et sæt arkitektoniske principper for design og udvikling af netværkssystemer.

REST-arkitekturen fokuserer på begrebet ressourcer. De er faktisk baseret på en kommunikationsmodel, hvor klienter sender anmodninger til servere om at udføre handlinger på specifikke ressourcer. Disse anmodninger har typisk form af HTTP-metoder som GET, POST, PUT, PATCH og DELETE, som hver især svarer til forskellige operationer på ressourcerne.

I det specifikke tilfælde med SharePoint kan de ressourcer, som REST API handler på, være:

• Elementerne i en liste
• Dokumenterne i et bibliotek
• Et websted i sin helhed

Klienter kan derefter sende HTTP-anmodninger for at udføre handlinger på ressourcerne, som f.eks. at hente bestemte oplysninger eller foretage ændringer. Et eksempel er at sende en GET-anmodning for at få oplysninger om et dokument i et SharePoint-bibliotek; et andet eksempel kan være en POST-anmodning, som ofte bruges til at tilføje elementer til en liste.

Denne fleksibilitet gør REST API'er til et stærkt værktøj til at integrere og automatisere interaktioner med SharePoint, hvilket gør det muligt for udviklere at bygge applikationer, der nemt kan interagere med platformens data og funktionalitet.

Andre aspekter, der kendetegner SharePoints REST API'er, omfatter:

1. Brugervenlighed, så de kan arbejde effektivt med strukturerede og ustrukturerede data.
2. Sikkerhed, da autentificering håndteres via OAuth og access tokens. Det betyder, at kun autoriserede brugere og applikationer kan interagere med ressourcer.
3. Kontekstuafhængighed, da REST-anmodninger kan foretages fra ethvert miljø, der understøtter HTTP-opkald, herunder browsere og mobilapplikationer.
4. Skalerbarhed, så et stort antal samtidige anmodninger kan håndteres uden at overbelaste serveren.

Hvad er forskellen mellem API og REST API i SharePoint?

Som vi har set, er API'er sæt af definitioner og protokoller, der gør det muligt for forskellig software at kommunikere med hinanden. Der er forskellige typer, herunder biblioteks-API'er, operativsystem-API'er eller webservice-API'er, som kan designes ved hjælp af forskellige arkitektoniske stilarter og protokoller som SOAP, GraphQL og REST.

REST API'er repræsenterer specifikt en type API, der følger de arkitektoniske principper for REST (Representational State Transfer). Denne stil er kendetegnet ved en tilstandsløs kommunikationsmodel, hvor hver klientanmodning til serveren indeholder alle de oplysninger, der er nødvendige for at udføre den ønskede handling. REST API'er bruger HTTP-metoder (GET, POST, PUT, PATCH, DELETE) til at udføre operationer på ressourcer, der identificeres af unikke URL'er.

Så selv om alle REST API'er er API'er, er ikke alle API'er REST API'er.

Selv når det gælder SharePoint, er REST API'er kun en af mange måder, hvorpå du kan interagere med eksterne platforme og datakilder. Det er nyttigt at bruge REST API'er til at skabe SharePoint-webdele, når der er brug for let og fleksibel kommunikation med relaterede datakilder.

Faktisk gør REST API'er det muligt at opbygge dynamiske, interaktive webdele, der kan interagere med en række interne og eksterne datakilder uden at gå på kompromis med ydeevne eller enkelhed i koden.

Andre typer API'er kan bruges i forskellige sammenhænge. For eksempel er SOAP-API'er bedre egnet til komplekse integrationer, der kræver mere kontrol over kommunikationen. På samme måde foretrækkes API'er af CSOM-typen af udviklere, der arbejder med en objektmodel på klientsiden, hvilket giver en mere naturlig udviklingsoplevelse i applikationer.

Hvilke datakilder kan SharePoint forbinde til via API'er?

Via sin API kan SharePoint oprette forbindelse til en lang række datakilder og programmer for at berige funktionaliteten og indholdet på websteder som f.eks. intranettet.

Bare når det gælder intranettet, kan webdele udnytte SharePoints API til at oprette forbindelse til følgende datakilder.

1. SharePoint-lister og -biblioteker

Webparts kan derefter håndtere strukturerede data som meddelelser, kontakter, begivenheder og aktiviteter. De gør det også nemt at se og redigere indhold i SharePoint-biblioteker, f.eks. forretningsdokumenter eller mediefiler.

2. Eksterne databaser

Webparts forbinder til SQL Server-databaser, så intranetbrugere kan få direkte adgang til arkiverede oplysninger uden at skifte miljø. Derudover giver API'er også mulighed for, at webdele kan oprette forbindelse til databasestyringssystemer, såsom Oracle, for at give et centraliseret overblik over virksomhedens data.

3. Microsoft 365-applikationer

Oplysninger fra de andre produkter, der udgør den digitale arbejdsplads Microsoft 365 (som SharePoint er en del af), kan integreres i SharePoint-webdele via API'er. Disse produkter omfatter:

• Outlook til at integrere e-mail, kalender og kontakter.
• OneDrive til at forenkle administrationen af personlige og delte filer.
• Teams til at integrere chat, kanaler og andre samarbejdsfunktioner.
• Planner til at opdatere projektaktiviteter og koordinere teamarbejde.

4. Tjenester i skyen

SharePoint-webdele kan kommunikere med Microsoft Azure-tjenester, herunder Azure Blob Storage, Azure Functions og Azure SQL Database. Desuden kan de rapportere på Power BI-rapporter og -dashboards.

5. ERP/CRM

Webparts kan hente data fra systemer som Microsoft Dynamics 365 og Salesforce. Oplysninger om kunder, salg og supportaktiviteter bliver dermed søgbare på intranettet og understøtter brugernes arbejde.

Salgsteamet kan f.eks. se den seneste kundekommunikation, som supportteamet har håndteret, og få indsigt, som er nyttig i forbindelse med forretningsforhandlinger. På samme måde kan supportteamet få adgang til salgsoplysninger for at analysere kundeproblemer og foreslå tilpassede løsninger.

6. Værktøjer til forretningsintelligens

Ud over Power BI kan SharePoint-webdele oprette forbindelse via API til Tableau og Qlik. Disse er nogle af de mest populære og udbredte værktøjer i virksomheder til dataanalyse, og integration med SharePoint giver mulighed for central adgang til information på intranettet og dermed strømline beslutningsprocesser.

7. Sociale medier og andre kommunikationskanaler

Webparts kan integreres med virksomhedens sociale profiler, f.eks. på LinkedIn eller Twitter, for at vise de senest publicerede indlæg på intranettet eller fremhæve det vigtigste indhold for virksomheden. Ud over sociale medier kan indhold i RSS-format (f.eks. nyheder fra et online fagblad) også importeres til SharePoint.

Hos intranet.ai har vi bygget videre på netop denne brug af SharePoint API til at skabe webdelene "Indlæg på sociale medier" og "RSS-feed", som vores kunder nemt kan berige indholdet af det intranet, vi har bygget sammen.

SharePoint API og Microsoft Graph API:
er der en sammenhæng?

Microsoft Graph er en udviklerplatform, der giver en samlet gateway til adgang til Microsoft 365-data og -tjenester, herunder Azure Active Directory, Outlook, OneDrive, Teams, Excel, Planner og SharePoint.

Den giver således adgang til Microsofts mange tjenester fra en enkelt indgang, hvilket i høj grad forenkler applikationsudvikling og -styring for udviklere. Graph understøtter også en bred vifte af operationer, herunder:

• interaktion med filer og dokumenter i OneDrive
• mail- og kalenderstyring i Outlook
• samarbejde og kommunikation i Microsoft Teams
• administration af brugeridentiteter i Azure Active Directory

Der er således et tæt forhold mellem Microsoft 365-produkt-API'er og Microsoft Graph-API'er, og SharePoint er ingen undtagelse.

Integrationen af SharePoint API'er i Microsoft Graph-økosystemet giver udviklere mulighed for at få adgang til SharePoint-data og -funktionalitet via de samme endpoints og godkendelsestokens, som bruges til andre Microsoft 365-tjenester. I praksis giver Microsoft Graph API'erne en ensartet grænseflade til at interagere med SharePoint-ressourcer, hvilket gør interoperabilitet mellem SharePoint og andre Microsoft 365-tjenester lettere.

Med Microsoft Graph er det f.eks. muligt at hente oplysninger på et SharePoint-site, få adgang til dokumenter, der er gemt i et bibliotek, eller administrere adgangstilladelser til virksomhedsfiler. Nemt, gennem HTTP-kald.

Resultatet er en robust, integreret platform, der forenkler udviklingsprocessen og gør det muligt for virksomheder at udnytte det fulde potentiale i deres data og applikationer.

Hvad er SharePoint API'er, og hvad bruges de til?

SharePoint API'er er sæt af definitioner og protokoller, der muliggør kommunikation mellem SharePoint og andre applikationer eller eksterne datakilder. Disse API'er gør det muligt at oprette, tilpasse og vedligeholde webdele, der udgør websteder som virksomhedens intranet, og sikrer integration og automatiske indholdsopdateringer.

Hvad er SharePoint REST API'er, og hvad bruges de til?

SharePoint REST API'er er et sæt arkitektoniske principper til design og udvikling af netværkssystemer. De muliggør adgang til og manipulation af SharePoint-ressourcer gennem enkle HTTP-kald, hvor CRUD-operationer (Create, Read, Update, Delete) udføres på elementer som lister, dokumenter og websteder.

Hvad er forskellen mellem API'er og REST API'er i SharePoint?

API'er er sæt af definitioner og protokoller til kommunikation mellem forskellige software, mens REST API'er repræsenterer en type API, der følger de arkitektoniske principper i REST (Representational State Transfer). REST API'er bruger HTTP-metoder til at udføre operationer på ressourcer, der identificeres af unikke URL'er. Ikke alle API'er er REST API'er, men alle REST API'er er API'er.

Hvilke datakilder kan SharePoint forbinde til via API'er?

SharePoint kan forbinde til en bred vifte af datakilder via API'er, herunder SharePoint-lister og -biblioteker, eksterne databaser (såsom SQL Server og Oracle), Microsoft 365-applikationer (Outlook, OneDrive, Teams, Planner), cloud-tjenester (Microsoft Azure, Power BI), ERP/CRM-systemer (Dynamics 365, Salesforce), forretningsintelligensværktøjer (Tableau, Qlik) og kommunikationskanaler som sociale medier og RSS-feeds.

Er der en relation mellem SharePoint API'er og Microsoft Graph API'er?

Ja, Microsoft Graph er en platform, der tilbyder en enhedlig adgang til data og tjenester på tværs af Microsoft 365, inklusive SharePoint. Integration af SharePoint API'er i Microsoft Graph gør det muligt for udviklere at få adgang til SharePoint-funktioner ved hjælp af de samme slutpunkter og autentificeringstokener, der bruges til andre Microsoft 365-tjenester, hvilket forenkler interoperabilitet mellem SharePoint og andre Microsoft-tjenester.