Envoyer des demandes
Suivez ces directives lorsque vous créez des demandes d'envoi à l'aide de l'API REST de domaines d'identité.
Structure d'URL
Accéder à l'API REST des domaines d'identité via une URL, qui inclut l'adresse REST, la ressource à laquelle accéder et tous les paramètres de requête à inclure dans une demande. Obtenez la structure complète des URL de l'API REST des domaines d'identité auprès de l'administrateur Oracle Cloud ou de l'administrateur de domaine d'identité.
Adresse de base
L'adresse de base de l'API REST de domaines d'identité est la suivante :
https://<domainURL>/Où : domainURL représente l'URL propre au domaine. Pour obtenir cette URL à l'aide de la console des domaines d'identité, reportez-vous à Recherche d'une URL de domaine d'identité.
Vous pouvez également obtenir cette URL auprès de l'administrateur Oracle Cloud ou de l'administrateur de domaine d'identité.
Adresses de ressource
Lorsque vous créez une ressource ou que vous effectuez une recherche de membres d'un type de ressource, vous ajoutez le nom de la ressource. Par exemple, lorsque vous envoyez une demande POST pour créer un utilisateur, vous utilisez l'adresse :
https://<domainURL>/admin/v1/UsersRessources spécifiques dans une adresse
Pour accéder à une ressource spécifique, ajoutez la valeur de l'attribut id de cette ressource à l'adresse de ressource. Par exemple, si vous avez créé un utilisateur et que la réponse à votre demande POST inclut la valeur ocid ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx dans le corps de la réponse, vous devez utiliser l'adresse suivante pour accéder à cette ressource utilisateur spécifique dans les demandes GET, PATCH ou PUT suivantes :
https://<domainURL>/admin/v1/Users/ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxMéthodes prises en charge
Les méthodes prises en charge dépendent de l'adresse.
| Méthode HTTP | Description |
|---|---|
GET
|
Rechercher des ressources ou rechercher une ressource spécifique par ID. |
HEAD |
Vérifiez l'existence de la ressource et/ou sa modification. Ne renvoie pas de corps de réponse. Lecture seule. |
POST
|
Créez, modifiez, réinitialisez, importez, authentifiez, planifiez ou créez une demande de recherche pour les ressources de domaine d'identité. |
PUT
|
Remplacez (mise à jour complète) une ressource de domaine d'identité existante, activez ou désactivez une ressource de domaine d'identité, etc. |
PATCH
|
Modification (mise à jour partielle) des ressources de domaine d'identité. |
DELETE
|
Supprimez ou annulez des ressources de domaine d'identité. |
OPTIONS |
Extrayez les opérations autorisées pour l'adresse. |
En-têtes pris en charge
L'API REST des domaines d'identité prend en charge les en-têtes suivants qui peuvent être transmis dans la section d'en-tête de la demande ou de la réponse HTTP.
| En-tête | Description | Exemple |
|---|---|---|
Content-Type
|
Type de support du corps de la demande. Requis pour les demandes POST et PUT. |
Content-Type: application/scim+json Content-Type: application/json
|
Authorization
|
Jeton d'accès OAuth utilisé pour accéder aux ressources protégées Ou les signatures de demande dans l'en-tête d'autorisation |
Les jetons d'accès sont des chaînes très longues. Cet exemple a été tronqué : Bearer VkdVAZrb_fw......eyJ4NXQjUzI1Ni |