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

API-er er måten ulike systemer kommuniserer med hverandre på, og utveksler data og kommandoer. SharePoint, den viktigste samarbeidsplattformen i Microsoft 365, benytter seg av ulike typer API-er for å gjøre det mulig for brukerne å opprette, tilpasse og vedlikeholde webdelene som utgjør nettsteder som for eksempel bedriftens intranett. Blant disse API-ene spiller REST API-er en viktig rolle på grunn av deres fleksibilitet.

I denne artikkelen skal vi se nærmere på hva SharePoint API-er er og hva de brukes til, hva som kjennetegner REST API-er, og hvilken funksjonalitet som er mulig gjennom integrasjon med Microsoft Graph.

SharePoint API: Hva er de?

Innen programmering representerer API-er måten et program kan kommunisere med et annet program eller en ekstern datakilde på. I SharePoint gjør API-er det mulig å opprette nettdelene av et nettsted, for eksempel intranettet.

Utviklere bruker API-er til å koble SharePoint til bestemte datakilder, og fra disse henter de informasjonen som trengs for å levere innhold og funksjonalitet i webdelene som utgjør et nettsted.

Når informasjon fra en datakilde som er koblet til SharePoint via API oppdateres, er det viktig å merke seg at innholdet i den tilhørende webdelen oppdateres automatisk og i sanntid.

SharePoint API-er kan deles inn i fire hovedkategorier:

1. REST API-er, som gir tilgang til og manipulering av SharePoint-ressurser ved hjelp av enkle HTTP-anrop. Generelt utfører REST-forespørsler CRUD-operasjoner (Create, Read, Update, Delete) på elementer i SharePoint, for eksempel lister, dokumenter og områder.
   
   
2. Client-Side Object Model (CSOM): en type API som tilbyr et sett med biblioteker som kan brukes i språk som JavaScript, .NET og Silverlight for å samhandle med SharePoint. Disse API-ene er nyttige for å utføre operasjoner på klientsiden, siden de innebærer kjøring av kode direkte i brukerens nettleser.
   
   
3. JavaScript Object Model (JOM): En API-kategori som ligner på CSOM, men som er spesifikk for JavaScript. Den brukes derfor ofte til å lage dynamiske grensesnitt i SharePoint-webdeler.
   
   
4. SOAP Web Services: Selv om disse API-ene er mindre utbredt enn de andre, gjør de det mulig å kommunisere med SharePoint gjennom XML-baserte protokoller.
   
   

SharePoints sett med API-er gjør det mulig å koble webdeler til et bredt spekter av datakilder, inkludert eksterne databaser (f.eks. SQL Server), skytjenester (som Microsoft Azure), ERP/CRM-systemer (f.eks. Dynamics 365 og Salesforce) og en rekke andre tjenester og applikasjoner.

Hvis vi tar API-tilkoblingen til en SQL Server som eksempel, kan en webdel vise listen over prosjekter som er lagret i databasen. Denne integrasjonen gjør det mulig for autoriserte brukere å se den informasjonen de er interessert i, direkte på SharePoint-intranettet, uten å måtte gå inn i separate systemer eller overføre data manuelt etter en oppdatering.

Dette er altså hva SharePoint API-er er: byggesteinene vi trenger for å bygge, tilpasse og vedlikeholde alle webdelene som beriker funksjonaliteten og innholdet på et hvilket som helst SharePoint-nettsted.

SharePoint REST API: Hva er de?

REST API-er, som står for Representational State Transfer Application Programming Interfaces, er et sett med arkitektoniske prinsipper for utforming og utvikling av nettverkssystemer.

REST-arkitekturen fokuserer på ressursbegrepet. De er basert på en kommunikasjonsmodell der klienter sender forespørsler til servere om å utføre handlinger på spesifikke ressurser. Disse forespørslene tar vanligvis form av HTTP-metoder som GET, POST, PUT, PATCH og DELETE, som hver tilsvarer ulike operasjoner på ressursene.

I det spesifikke tilfellet med SharePoint kan ressursene som REST API fungerer på, være

• Elementene i en liste
• Dokumentene i et bibliotek
• Et nettsted, i sin helhet

Klienter kan deretter sende HTTP-forespørsler for å utføre handlinger på ressursene, for eksempel å hente ut bestemt informasjon eller gjøre endringer. Et eksempel er å sende en GET-forespørsel for å få informasjon om et dokument i et SharePoint-bibliotek; et annet eksempel kan være en POST-forespørsel, som ofte brukes til å legge til elementer i en liste.

Denne fleksibiliteten gjør REST API-er til et kraftig verktøy for å integrere og automatisere interaksjoner med SharePoint, og gjør det mulig for utviklere å bygge applikasjoner som enkelt kan samhandle med plattformens data og funksjonalitet.

Andre aspekter som kjennetegner SharePoints REST API-er, er blant annet

1. Brukervennlighet, slik at de kan arbeide effektivt med strukturerte og ustrukturerte data.
2. Sikkerhet, ettersom autentisering håndteres gjennom OAuth og tilgangstokener. Dette betyr at bare autoriserte brukere og applikasjoner kan samhandle med ressurser.
3. Kontekstuavhengighet, siden REST-forespørsler kan gjøres fra alle miljøer som støtter HTTP-anrop, inkludert nettlesere og mobilapplikasjoner.
4. Skalerbarhet, slik at et stort antall samtidige forespørsler kan håndteres uten å overbelaste serveren.

Hva er forskjellen mellom API og REST API i SharePoint?

Som vi har sett, er API-er sett med definisjoner og protokoller som gjør det mulig for ulike programvarer å kommunisere med hverandre. Det finnes ulike typer, inkludert biblioteks-API-er, operativsystem-API-er eller webtjeneste-API-er, som kan utformes ved hjelp av ulike arkitektoniske stiler og protokoller, for eksempel SOAP, GraphQL og REST.

REST API-er representerer en type API som følger de arkitektoniske prinsippene i REST (Representational State Transfer). Denne stilen kjennetegnes av en tilstandsløs kommunikasjonsmodell, der hver klientforespørsel til serveren inneholder all informasjonen som er nødvendig for å utføre den forespurte operasjonen. REST API-er bruker HTTP-metoder (GET, POST, PUT, PATCH, DELETE) for å utføre operasjoner på ressurser, identifisert med unike URL-er.

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

Selv når det gjelder SharePoint, er REST API-er bare én av mange måter du kan samhandle med eksterne plattformer og datakilder på. Det er nyttig å bruke REST API-er til å lage SharePoint-webdeler når det er behov for enkel og fleksibel kommunikasjon med relaterte datakilder.

REST API-er gjør det faktisk mulig å bygge dynamiske, interaktive webdeler som kan kommunisere med en rekke interne og eksterne datakilder uten at det går på bekostning av ytelse eller kodeenkelhet.

Andre typer API-er kan brukes i andre sammenhenger. SOAP-API-er egner seg for eksempel bedre for komplekse integrasjoner som krever mer kontroll over kommunikasjonen. På samme måte foretrekkes API-er av CSOM-typen av utviklere som jobber med en objektmodell på klientsiden, noe som gir en mer naturlig utviklingsopplevelse i applikasjoner.

Hvilke datakilder kan SharePoint koble seg til via API-er?

Gjennom API-et kan SharePoint koble seg til en lang rekke datakilder og programmer for å berike funksjonaliteten og innholdet på nettsteder som intranettet.

Bare når det gjelder intranettet, kan webdeler utnytte SharePoints API for å koble seg til følgende datakilder.

1. SharePoint-lister og -biblioteker

Webdeler kan håndtere strukturerte data som kunngjøringer, kontakter, hendelser og aktiviteter. De gjør det også enkelt å vise og redigere innhold i SharePoint-arkiver, for eksempel forretningsdokumenter eller mediefiler.

2. Eksterne databaser

Webdeler kobles til SQL Server-databaser, slik at intranettbrukere kan få direkte tilgang til arkivert informasjon uten å måtte bytte miljø. I tillegg gjør API-er det også mulig å koble webdeler til databasestyringssystemer, for eksempel Oracle, slik at man får en sentralisert oversikt over bedriftens data.

3. Microsoft 365-applikasjoner

Informasjon fra de andre produktene som utgjør den digitale arbeidsplassen Microsoft 365 (som SharePoint er en del av), kan integreres i SharePoints webdeler via API-er. Disse produktene inkluderer:

• Outlook, for å integrere e-post, kalender og kontakter.
• OneDrive, for å forenkle håndteringen av personlige og delte filer.
• Teams, for å integrere chat, kanaler og andre samarbeidsfunksjoner.
• Planner, for å oppdatere prosjektaktiviteter og koordinere teamarbeid.

4. Skytjenester

SharePoint-nettdeler kan kommunisere med Microsoft Azure-tjenester, inkludert Azure Blob Storage, Azure Functions og Azure SQL Database. I tillegg kan de rapportere på Power BI-rapporter og -instrumentbord.

5. ERP/CRM

Webdeler kan hente data fra systemer som Microsoft Dynamics 365 og Salesforce. Informasjon om kunder, salg og supportaktiviteter blir dermed søkbar på intranettet, noe som støtter brukernes arbeid.

Salgsteamet kan for eksempel se den siste kundekommunikasjonen som er håndtert av supportteamet, og få innsikt som er nyttig for å styre forretningsforhandlingene. På samme måte kan supportteamet få tilgang til salgsdetaljer for å analysere kundeproblemer og foreslå tilpassede løsninger.

6. Verktøy for forretningsintelligens

I tillegg til Power BI kan SharePoint-webdeler kobles til Tableau og Qlik via API. Dette er noen av de mest populære og utbredte verktøyene for dataanalyse i bedrifter, og integrasjon med SharePoint gir sentralisert tilgang til informasjon på intranettet og effektiviserer dermed beslutningsprosessene.

7. Sosiale medier og andre kommunikasjonskanaler

Webdeler kan integreres med bedriftens sosiale profiler, for eksempel LinkedIn eller Twitter, for å vise de siste publiserte innleggene på intranettet eller fremheve det viktigste innholdet for bedriften. I tillegg til sosiale medier kan også innhold i RSS-format (f.eks. nyheter fra et nettbasert fagblad) importeres til SharePoint.

Hos intranet.ai har vi bygget videre på nettopp denne bruken av SharePoint API for å lage webdelene "Innlegg i sosiale medier" og "RSS-feed", som kundene våre enkelt kan berike innholdet i intranettet vi har bygget sammen.

SharePoint API og Microsoft Graph API:
er det en sammenheng?

Microsoft Graph er en utviklerplattform som gir en enhetlig gateway for tilgang til Microsoft 365-data og -tjenester, inkludert Azure Active Directory, Outlook, OneDrive, Teams, Excel, Planner og SharePoint.

Den gir dermed tilgang til Microsofts mange tjenester fra ett enkelt inngangspunkt, noe som forenkler applikasjonsutvikling og -administrasjon for utviklere. Graph støtter også et bredt spekter av operasjoner, blant annet

• interaksjon med filer og dokumenter i OneDrive
• e-post- og kalenderhåndtering i Outlook
• samarbeid og kommunikasjon i Microsoft Teams
• administrasjon av brukeridentiteter i Azure Active Directory

Det er altså et nært forhold mellom Microsoft 365-produkt-API-er og Microsoft Graph-API-er, og SharePoint er intet unntak.

Integreringen av SharePoint API-er i Microsoft Graph-økosystemet gjør det mulig for utviklere å få tilgang til SharePoint-data og -funksjonalitet via de samme endepunktene og autentiseringstokenene som brukes for andre Microsoft 365-tjenester. I praksis gir Microsoft Graph API-ene et enhetlig grensesnitt for samhandling med SharePoint-ressurser, noe som gjør interoperabilitet mellom SharePoint og andre Microsoft 365-tjenester enklere.

Med Microsoft Graph er det for eksempel mulig å hente informasjon på et SharePoint-nettsted, få tilgang til dokumenter som er lagret i et bibliotek, eller administrere tilgangstillatelser til bedriftsfiler. På en enkel måte, gjennom HTTP-kall.

Resultatet er en robust, integrert plattform som forenkler utviklingsprosessen og gjør det mulig for bedrifter å utnytte det fulle potensialet i dataene og applikasjonene sine.

Hva er SharePoint API-er, og hva brukes de til?

SharePoint API-er er sett med definisjoner og protokoller som tillater kommunikasjon mellom SharePoint og andre applikasjoner eller eksterne datakilder. Disse API-ene muliggjør opprettelse, tilpasning og vedlikehold av webdeler som utgjør nettsteder som bedriftsintranettet, og sikrer integrasjon og automatiske innholdsoppdateringer.

Hva er SharePoint REST API-er, og hva brukes de til?

SharePoint REST API-er er et sett med arkitektoniske prinsipper for design og utvikling av nettverkssystemer. De tillater tilgang til og manipulering av SharePoint-ressurser gjennom enkle HTTP-anrop, og utfører CRUD-operasjoner (Create, Read, Update, Delete) på elementer som lister, dokumenter og nettsteder.

Hva er forskjellen mellom API-er og REST API-er i SharePoint?

API-er er sett med definisjoner og protokoller for kommunikasjon mellom forskjellige programvarer, mens REST API-er representerer en type API som følger de arkitektoniske prinsippene for REST (Representational State Transfer). REST API-er bruker HTTP-metoder for å utføre operasjoner på ressurser, identifisert av unike URL-er. Ikke alle API-er er REST API-er, men alle REST API-er er API-er.

Hvilke datakilder kan SharePoint koble til via API-er?

SharePoint kan koble til et bredt spekter av datakilder via API-er, inkludert SharePoint-lister og -biblioteker, eksterne databaser (som SQL Server og Oracle), Microsoft 365-applikasjoner (Outlook, OneDrive, Teams, Planner), skytjenester (Microsoft Azure, Power BI), ERP/CRM-systemer (Dynamics 365, Salesforce), forretningsintelligensverktøy (Tableau, Qlik) og kommunikasjonskanaler som sosiale medier og RSS-feeder.

Er det en relasjon mellom SharePoint API-er og Microsoft Graph API-er?

Ja, Microsoft Graph er en plattform som tilbyr en enhetlig gateway for tilgang til data og tjenester på tvers av Microsoft 365, inkludert SharePoint. Integreringen av SharePoint API-er i Microsoft Graph gjør det mulig for utviklere å få tilgang til SharePoint-funksjonaliteter ved å bruke de samme endepunktene og autentiseringstokener som brukes for andre Microsoft 365-tjenester, noe som forenkler interoperabiliteten mellom SharePoint og andre Microsoft-tjenester.