
SAP Field Service Management présente plusieurs interfaces de programmation d'applications (API) qui offrent de nombreuses façons d'accéder aux données et fonctionnalités de SAP Field Service Management à partir de systèmes externes. Ces API sont utilisées par Field Service Management ou peuvent être exploitées pour prendre en charge des intégrations et améliorations personnalisées.
Les API FSM fournies incluent les éléments suivants :
- API de requête : pour interroger les données stockées dans SAP Field Service Management Cloud.
- API de données : fournit un accès complet aux données stockées dans SAP Field Service Management Cloud.
- API en masse : extension de l'API de données v4 utilisée pour créer/mettre à jour et supprimer des ressources en masse.
- API service : pour créer, gérer et traiter les appels et activités de service dans FSM.
- API de reporting : fournit des fonctionnalités de reporting exposées sous la forme d'un ensemble de services Web, basés sur un moteur Jasper Reports.
- API Meilleur technicien correspondant : pour trouver automatiquement le meilleur technicien correspondant à une activité.
- API de réservation des rendez-vous : pour vous aider à trouver les techniciens et les heures de rendez-vous appropriés pour les activités.
- API de réoptimisation : pour replanifier de manière asynchrone les tâches affectées de manière autonome et optimisée.
- API Crowd Partner : pour inviter des sous-traitants à rejoindre la plateforme SAP Field Service Management Crowd.
- API Crowd Technician : pour créer et gérer les techniciens du réseau qui acceptent les missions et effectuent le travail dans le cadre de la plateforme SAP Field Service Management Crowd.
- API de répartition des partenaires du réseau : pour effectuer des demandes d'une application tierce vers SAP Field Service Management, pour gérer les activités affectées à un partenaire de réseau.
- API d'accès : pour permettre aux applications d'obtenir un accès limité à SAP Field Service Management.
- API utilisateur : pour créer et gérer des enregistrements utilisateur et des droits d'accès utilisateur pour les applications SAP Field Service Management.
- API SCIM : basée sur le système de gestion des identités inter-domaines (SCIM), qui est une norme ouverte pour automatiser l'échange de données utilisateur entre différents domaines d'identité utilisateur.
Toutes les API FSM utilisent le protocole HTTP et appliquent le paradigme REST (Representative ational State Transfer). Une compréhension de base de ces concepts est nécessaire pour les utiliser.
Pour utiliser les API, il est recommandé d'utiliser un outil spécialisé qui fournit une assistance pour les tests d'API, comme Postman ou Insomnia. Alternativement, un outil de ligne de commande pourrait être utilisé.
Toutes les interactions sont basées sur des demandes envoyées depuis le système client qui sont ensuite traitées par le système serveur (FSM dans ce cas). Après le traitement de la requête, le serveur envoie une réponse avec le résultat, par exemple le contenu de la ressource qui a été interrogée.
Les requêtes et les réponses contiennent des ressources qui sont échangées entre le serveur et le client. Une ressource est une information qui représente une entité dans le contexte de l'API spécifique. Le client peut interroger le serveur pour une ressource, mais également envoyer des ressources afin de les créer ou de les mettre à jour côté serveur. Dans les deux cas, le serveur inclura les ressources traitées dans sa réponse.
La clé pour interagir correctement avec les API Cloud FSM réside dans la composition des requêtes HTTP valides qui peuvent être traitées par l'API spécifique. La structure d'une requête HTTP se compose de trois parties distinctes :
- Ligne de demande
- Zones d'en-tête
- Corps du message
Bien que le corps du message soit spécifique à chaque API, les champs de ligne de demande et d'en-tête partagent un certain nombre de caractéristiques communes dans la plupart des API FSM.
