Bruk offentlig API for å automatisere brukerintegrering og synkronisering med din datakilde, og koble Motimate til andre kule tjenester.
Komplett API-dokumentasjon er tilgjengelig her: Motimate OpenAPI-dokumentasjon.
Offentlig API er et sett med tjenester som kan brukes til å oppdatere og administrere data i Motimate. Det er dokumentert på en standard måte kalt OpenAPI, og gir utviklere programmatisk tilgang til vår programvare som en tjeneste. Dette APIet har bredere støtte enn det du kan gjøre med SCIM og CSV, men du trenger en integrasjonstjeneste eller programvare-robot for å bruke det.
Data Modeller
Offentlig API gir modeller for å automatisere brukerprovisjonering og Pulse-poster. Den har disse datamodellene:
-
Brukermodell: Du kan bruke denne til å lese, skrive og oppdatere informasjon om brukerkontoer. Dette kan inkludere kontaktinformasjon, tilgangsroller og gruppeoppdrag for moti-funksjoner. Hvis en bruker har en eller flere stillinger, kan dette også settes på dette slutpunktet.
-
Gruppemodell: Dette lar deg lese, skrive og tildele brukergrupper. Disse gruppene kan også være strukturert i en trestruktur for å matche organisasjonen din og forenkle læringsoppgaver.
Viktig: Gruppenivået er for tiden definert ved hjelp av attributtet kind. Verdien av kind kan variere fra organisasjon til organisasjon. Den kan også enkelt endres av organisasjonsadministratoren din. Når du setter opp API-integrasjon, er det lurt å definere en permanent liste over kind-navn for gruppene dine for å unngå potensielle feil i API-integrasjonen hvis kind-navn endrer seg.
-
Posisjonsmodell: Denne modellen lar deg lese og skrive stillinger som brukerkontoer kan tilordnes.
-
Innlegg: Du kan bruke dette til å opprette innlegg og publisere dem på Pulse. Dette kan gjøres i kombinasjon med filtjenestene for opplasting av bilder.
-
Filer: Denne tjenesten brukes til å laste opp bilder for Pulse Innlegg. Størrelsesgrensen for bilder er 40 MB, videoer er 100 MB og dokumenter 100 MB.
- Innsikter: Denne tjenesten brukes til å generere og få en kobling til en tilpasset rapport. Rapportskabelonen må opprettes på forhånd i Motimate-plattformen ved hjelp av funksjonen 'Generer rapporter' under 'Innsikter'.
Det er også to støttetjenester som du trenger for å bruke data-modellene ovenfor:
-
OAuth Token-endepunkt brukes til å opprette tilgangstoken. Få tak i klient-IDen og klientens hemmelighet ved å kontakte support@motimateapp.com
- Me-endepunktet brukes til å bekrefte tilgangstokenet. Dette er nyttig hvis du har en nøkkellager for å oppbevare tilgangstokenet ditt, og du vil bekrefte at det fungerer uten å kalle noen transaksjonelle samtaler.