Ressources utilisateur de RAD Server
Remonter à API administrative de RAD Server
La base de données EMS stocke les données relatives aux utilisateurs enregistrés de votre application. Vous pouvez accéder à ces informations en utilisant la ressource Utilisateurs recensée.
- Remarque : Utilisez les composants TEMSClientAPI, TBackendUsers ou TBackendAuth pour s'inscrire, se connecter, récupérer, mettre à jour ou supprimer des informations sur les utilisateurs EMS de votre base de données EMS.
Sommaire
- 1 Points de terminaison de la ressource Utilisateurs
- 2 Point de terminaison GetUsers
- 3 Point de terminaison GetUser
- 4 Point de terminaison GetFields
- 5 Point de terminaison GetUserGroups
- 6 Point de terminaison SignupUser
- 7 Point de terminaison LoginUser
- 8 Point de terminaison AddUser
- 9 Point de terminaison UpdateUser
- 10 Point de terminaison DeleteUser
- 11 Champs Utilisateurs EMS
- 12 Voir aussi
Points de terminaison de la ressource Utilisateurs
La ressource Utilisateurs expose les points de terminaison de ressource EMS suivants :
Méthode du point de terminaison | Suffixe de la ressource | Type de requête HTTP | Usage |
---|---|---|---|
GetUsers |
-- |
HTTP GET |
Récupérer toutes les données d'une ressource Utilisateurs. |
GetUser |
|
HTTP GET |
Récupérer toutes les données d'un utilisateur. |
GetUserFields |
|
HTTP GET |
Récupérer tous les noms de champs des utilisateurs EMS (dont les champs personnalisés). |
GetUserGroups |
|
HTTP GET |
Pour récupérer les groupes EMS auxquels appartient l'utilisateur EMS. |
SignupUser |
-- |
HTTP POST |
S'inscrit sur le serveur EMS avec un utilisateur EMS approprié. |
LoginUser |
-- |
HTTP POST |
Se connecte au serveur EMS avec un utilisateur EMS spécifique. |
AddUser |
-- |
HTTP POST |
Ajouter un nouvel utilisateur à la base de données EMS. |
UpdateUser |
|
HTTP PUT |
Mettre à jour un utilisateur à partir de la ressource Utilisateurs. |
DeleteUser |
|
HTTP DELETE |
Supprimer un élément d'une ressource. |
- Remarque : _id correspond à l'identificateur d'utilisateur EMS dans la base de données EMS (UserID).
Point de terminaison GetUsers
Renvoie la liste des données des utilisateurs EMS.
En cas de réussite, la réponse du serveur EMS fournit la liste de tous les utilisateurs EMS, avec des détails sur chaque utilisateur.
- username
- _id (UserID)
- _meta (les champs creator, created et updated)
- Champs personnalisés (facultatif)
Utilisez la méthode QueryUsers, le composant TBackendUsers ou TBackendQuery et la ressource Utilisateurs pour récupérer la liste des utilisateurs EMS.
Exemple de réponse
Voici un exemple de réponse :
[
{
"username": "test",
"_id": "24EDA495-90FC-4BC4-9626-C87783357948",
"_meta": {
"creator": "24EDA495-90FC-4BC4-9626-C87783357948",
"created": "2014-08-20T11:08:55.000Z"
},
"description": "Created by EMS setup. Password is \"test\"."
},
{
"username": "testuser",
"_id": "AB4900CC-CD7A-4890-B20D-9A3E65B450C7",
"_meta": {
"creator": "24EDA495-90FC-4BC4-9626-C87783357948",
"created": "2014-08-20T11:08:55.000Z",
"updated": "2014-08-20T11:08:59.000Z"
}
}
]
Point de terminaison GetUser
Renvoie les données d'un utilisateur EMS spécifique (identifié par id
).
Votre requête doit fournir le champ suivant :
- _id (UserID)
En cas de réussite, la réponse du serveur EMS fournit les utilisateurs EMS avec les détails suivants :
- username
- _id (UserID)
- _meta (les champs creator, created et updated)
- Champs personnalisés (facultatif)
Utilisez la méthode RetrieveUser, le composant TBackendUsers ou TBackendQuery et un utilisateur spécifique pour récupérer ses données.
Exemple de réponse
Voici un exemple de réponse à la requête d'utilisateur "82C6E6C0-A4BC-44B8-9434-A07DCE364CD4" :
{
"username": "test",
"_id": "82C6E6C0-A4BC-44B8-9434-A07DCE364CD4",
"_meta": {
"creator": "82C6E6C0-A4BC-44B8-9434-A07DCE364CD4",
"created": "2014-08-20T09:51:10.000Z"
},
"description": "Created by EMS setup. Password is \"test\"."
}
Point de terminaison GetFields
Récupère tous les noms de champs des Utilisateurs EMS (dont les champs personnalisés).
En cas de réussite, la réponse du serveur EMS fournit les utilisateurs EMS avec, au minimum, les détails suivants :
- username
- _id (UserID)
- _meta (les champs creator, created et updated)
- Champs personnalisés (facultatif)
Utilisez la méthode RetrieveUsersFields pour récupérer tous les noms de champs.
Exemple de réponse
Voici un exemple de réponse :
[
{
"name":"username"
},
{
"name":"_id"
},
{
"name":"_meta",
"fields":[
{
"name":"creator"
},
{
"name":"created"
},
{
"name":"updated"
}
]
},
{
"name":"description",
"custom":true
}
]
Point de terminaison GetUserGroups
Récupère les groupes EMS auxquels l'utilisateur EMS (identifié par id
) appartient.
Votre requête doit fournir le champ suivant :
- _id (UserID)
En cas de réussite, la réponse du serveur EMS fournit la liste de tous les utilisateurs EMS, avec des détails sur chaque utilisateur.
Utilisez la méthode RetrieveUserGroups pour récupérer la liste des groupes EMS auxquels l'utilisateur appartient.
Exemple de réponse
Voici un exemple de réponse à la requête d'utilisateur "82C6E6C0-A4BC-44B8-9434-A07DCE364CD4" :
[
"testgroup",
"Admins"
]
Point de terminaison SignupUser
S'inscrit sur le serveur EMS avec un utilisateur EMS approprié.
Votre requête doit fournir les champs suivants :
- username
- password
Utilisez la méthode SignupUser de TEMSClientAPI ou la méthode Signup du composant TBackendAuth pour inscrire un nouvel utilisateur EMS dans le serveur EMS.
Point de terminaison LoginUser
Se connecte au serveur EMS avec un utilisateur EMS spécifique.
Votre requête doit fournir les champs suivants :
- username
- password
Utilisez la méthode LoginUser de TEMSClientAPI ou la méthode Login du composant TBackendAuth pour connecter un utilisateur EMS existant au serveur EMS.
Point de terminaison AddUser
Ajoute un nouvel utilisateur EMS à la base de données EMS.
Votre requête doit fournir les champs suivants :
- username
- password
Utilisez la méthode AddUser ou la méthode CreateUserAPI du composant TBackendUsers pour ajouter de nouveaux utilisateurs EMS.
Point de terminaison UpdateUser
Met à jour les informations stockées dans la base de données EMS relatives à un utilisateur EMS spécifique (identifié par id
).
Votre requête doit fournir les champs suivants :
- _id (UserID)
- Champs personnalisés à mettre à jour
Utilisez la méthode UpdateUser ou la méthode UpdateUserDetails du composant TBackendAuth pour mettre à jour les champs personnalisés relatifs à un utilisateur EMS existant.
Point de terminaison DeleteUser
Supprime l'utilisateur EMS spécifié par id
.
Votre requête doit fournir le champ suivant :
- _id (UserID)
Utilisez la méthode DeleteUser ou la méthode DeleteUser du composant TBackendUsers pour supprimer un utilisateur EMS.
Champs Utilisateurs EMS
La ressource Utilisateurs de la requête EMS et les réponses peuvent inclure toute combinaison des champs suivants :
Elément | Exemple | Description |
---|---|---|
"username"
|
"testuser"
|
Nom d'utilisateur EMS dans la base de données EMS |
"_id"
|
"AB4900CC-CD7A-4890-B20D-9A3E65B450C7"
|
Identificateur unique (UserID) d'un utilisateur EMS dans la base de données EMS |
"meta"
|
{
"creator": "24EDA495-90FC-4BC4-9626-C87783357948",
"created": "2014-08-20T11:08:55.000Z",
"updated": "2014-08-20T11:08:59.000Z"
}
|
|
Champs personnalisés |
"myCustomField": "My Custom Field description"
|
Informations supplémentaires stockées pour l'utilisateur EMS. |