Envoyer des demandes
Suivez ces directives lorsque vous créez des demandes d'envoi à l'aide de l'API REST des domaines d'identité.
Structure d'URL
Accédez à l'API REST des domaines d'identité via une URL, qui inclut l'adresse REST, la ressource à laquelle vous souhaitez accéder et tous les paramètres de requête à inclure dans une demande. Obtenez la structure d'URL complète pour 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 des 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 recherchez des 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/Users
Ressources spécifiques dans une adresse
Pour accéder à une ressource spécifique, vous 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
incluait 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..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Méthodes prises en charge
Les méthodes prises en charge dépendent de l'adresse.
Méthode HTTP | Description |
---|---|
GET
|
Recherchez des ressources ou recherchez une ressource spécifique par ID. |
HEAD |
Vérifiez l'existence et/ou la modification des ressources. Ne renvoie pas de corps de réponse. En lecture seule. |
POST
|
Créer, modifier, réinitialiser, importer, authentifier, programmer ou créer une demande de recherche pour les ressources de domaine d'identité. |
PUT
|
Remplacer (mettre à jour intégralement) une ressource de domaine d'identité existante, activer ou désactiver 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 média 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 |