Opret en API-konto i Apple School Manager
I Apple School og Business Manager API'erne kan du redigere enhedernes administrationstildelinger og se enhedsoplysninger. Du kan også bruge en enheds slutpunkt til at give apps mulighed for at oprette brugerdefinerede rapporter eller eksportere enhedsdata.
Oversigt
I Apple School og Business Manager API'en kan du redigere enhedernes administrationstildelinger og se enhedsoplysninger. Du kan også bruge en enheds slutpunkt til at give apps mulighed for at oprette brugerdefinerede rapporter eller eksportere enhedsdata. API'en understøtter OAuth 2. Med OAuth 2 bruger apps et sæt legitimationsoplysninger, som udveksles med et adgangstoken, til at foretage godkendte anmodninger til API'en.
Før du kan bruge disse API'er, skal du oprette en API-konto i Apple School Manager. Det er kun brugere med rollen som administrator eller lokalitetsansvarlig, der kan oprette en API-konto.
Dataadgang
Når API-kontoen er korrekt konfigureret, kan den pågældende konto give en app adgang til følgende oplysninger:
Kategori | Funktion | Beskrivelse |
|---|---|---|
Enheder | Hent organisationsenheder | Hent en liste over enheder i en organisation, der tilmeldes ved hjælp af automatiseret enhedstilmelding. |
Enheder | Hent enhedsoplysninger | Hent oplysninger om en enhed i en organisation, f.eks. enhedsmodel, ordrenummer og varenummer. |
Tjenester til enhedsadministration | Hent tjenester til enhedsadministration | Hent en liste over tjenester til enhedsadministration i en organisation. |
Tjenester til enhedsadministration | Hent enhedsserienumre til en tjeneste til enhedsadministration | Hent en liste over enhedsserienumre, der er tildelt en tjeneste til enhedsadministration. |
Tjenester til enhedsadministration | Hent det tildelte id for tjenesten til enhedsadministration for en enhed | Hent oplysninger om det tildelte id for tjenesten til enhedsadministration for en enhed. |
Tjenester til enhedsadministration | Hent oplysninger om den tildelte tjeneste til enhedsadministration for en enhed | Hent oplysninger om den tildelte tjeneste til enhedsadministration for en enhed. |
Tjenester til enhedsadministration | Hent oplysninger om enhedsaktivitet | Hent oplysninger om en organisations enhedsaktivitet, som en enhedsadministrationshandling opretter, f.eks. tildeling eller ophævelse af tildeling. |
Tjenester til enhedsadministration | Tildel eller ophæv tildeling af enheder til en tjeneste til enhedsadministration | Tildel eller ophæv tildeling af enheder til en tjeneste til enhedsadministration. |
Dan en privat nøgle
Du skal danne en privat nøgle for at kunne opretholde en sikker forbindelse til Apple School Manager. Nøglens arkivnavn slutter på .pem, og du skal kun danne den én gang.
Opret en API-konto, og download den private nøgle
I Apple School Manager
skal du logge ind med en bruger, der har rollen som administrator eller lokalitetsansvarlig.Vælg dit navn nederst i indholdsoversigten, vælg Indstillinger
, og vælg derefter API.Vælg Kom i gang, indtast et navn til kontoen, og vælg derefter Opret.
Gør et af følgende:
Vælg Generate Private Key (Dan privat nøgle) for at danne nøglen.
Arkivet downloades automatisk til den lokalitet, du har angivet i browserindstillingerne. Hvis der ikke er angivet en lokalitet, spørger systemet, hvor arkivet skal gemmes.
Vælg Senere for at danne den private nøgle senere.
Vælg Administrer for at se de oplysninger, du skal bruge for at oprette forbindelse.
Gennemgå Apple Developer-dokumentationen for at se, hvordan du opretter forbindelse.