Créer un compte API dans Apple School Manager
Les API Apple School Manager et Apple Business Manager permettent de modifier les attributions de gestion et de consulter les informations des appareils. Vous pouvez aussi utiliser le point d’accès de l’appareil pour permettre aux apps de créer des rapports personnalisés ou d’exporter les données des appareils.
Présentation
L’API Apple School and Business Manager permet de modifier les attributions de gestion et de consulter les informations des appareils. Vous pouvez aussi utiliser le point d’accès de l’appareil pour permettre aux apps de créer des rapports personnalisés ou d’exporter les données des appareils. L’API est compatible avec OAuth 2, qui permet aux apps de fournir un jeu d’identifiants pour s’authentifier, et de recevoir un jeton d’accès afin de transmettre des requêtes authentifiées à l’API.
Avant d’utiliser ces API, vous devez créer un compte API dans Apple School Manager. Seuls les utilisateurs disposant du rôle Administrateur ou Gestionnaire de site peuvent créer un compte API.
Accès aux données
Lorsque le compte API est correctement configuré, il peut autoriser une app à accéder aux informations suivantes :
Catégorie | Fonctionnalité | Description |
|---|---|---|
Appareils | Obtenir la liste des appareils appartenant à l’organisation | Permet d’obtenir une liste des appareils d’une organisation donnée, enregistrés via Inscription automatisée des appareils. |
Appareils | Obtenir les informations de l’appareil | Permet d’obtenir des informations sur un appareil appartenant à une organisation, comme le modèle, le numéro de commande ou de pièce, etc. |
Services de gestion des appareils | Obtenir la liste des services de gestion des appareils | Permet d’obtenir une liste des services de gestion des appareils d’une organisation donnée. |
Services de gestion des appareils | Obtenir le numéro de série des appareils pour un service de gestion des appareils | Permet d’obtenir une liste des numéros de série des appareils affectés à un service de gestion des appareils. |
Services de gestion des appareils | Obtenir l’ID attribué à l’appareil pour le service de gestion des appareils | Permet d’obtenir les informations d’identification attribuées à un appareil affecté à un service de gestion des appareils. |
Services de gestion des appareils | Obtenir les informations de l’appareil pour le service de gestion des appareils | Permet d’obtenir les informations de service associées à un appareil affecté à un service de gestion des appareils. |
Services de gestion des appareils | Obtenir les informations d’activité de l’appareil | Permet d’obtenir des informations sur l’activité d’un appareil appartenant à l’organisation générée par une action de gestion de l’appareil, comme une attribution ou un retrait. |
Services de gestion des appareils | Attribuer ou retirer des appareils à un service de gestion des appareils | Permet d’attribuer ou de retirer des appareils à un service de gestion des appareils. |
Générer une clé privée
Afin de sécuriser la connexion à Apple School Manager, vous devez générer une clé privée. Vous n’avez pas besoin de répéter l’opération. Le fichier de cette clé porte l’extension .pem.
Créer un compte API et télécharger la clé privée
Dans Apple School Manager
, connectez‑vous avec un compte utilisateur disposant du rôle Administrateur ou Gestionnaire de site.Sélectionnez votre nom au bas de la barre latérale, sélectionnez Préférences
, puis sélectionnez API.Sélectionnez Commencer, saisissez un nom de compte et sélectionnez Créer.
Effectuez l’une des actions suivantes :
Pour générer la clé, sélectionnez Générer une clé privée.
Le fichier est téléchargé automatiquement à l’emplacement défini dans les réglages de votre navigateur, ou à l’emplacement que vous indiquez en l’absence de réglage prédéfini.
Sélectionnez Plus tard pour générer la clé privée ultérieurement.
Pour consulter les informations nécessaires afin de créer la connexion, sélectionnez Gérer.
Consultez la documentation Apple Developer pour savoir comment créer la connexion.