Get Many¶
Get user documents with different options.
Request¶
POST https://test-uni.cloudplan.biz/api/user/get_many
{
"user_ids": [...] //(list of strings, optional) return exactly these user_ids
"include_images": false //(bool, optional) include profile b64 encoded profile include_images
"email": ... //(string, optional) return exactly one user with this email address
}
Reply¶
{
"result": true/false,
"user": [..] //list of user documents
}
Example 0 - get with IDs¶
REQUEST
{
"user_ids":["56A23EB6998F303B134C1C0A723447B0","56A23D90E7EC5FC6555CF21E9702AB20"]
}
REPLY
{
"result": true,
"user": [
{
"username": "Frank",
"name": "bruegmann",
"email": "f.bruegmann@cloudplan.net",
"firstname": "frank",
"user_id": "56A23D90E7EC5FC6555CF21E9702AB20",
"reachability": "online",
"status_mode": "online",
"public": "public",
"image_id": "5EA28F38DB930F67D1332909215CDEA1",
"supervisor": []
},
{
"username": "Heye",
"name": "Everts",
"email": "h.everts@cloudplan.net",
"firstname": "Heye",
"user_id": "56A23EB6998F303B134C1C0A723447B0",
"reachability": "online",
"status_mode": "online",
"public": "public",
"image_id": "5DA97E2880405A4CC1BBB892BDCE99E6",
"supervisor": false
}
]
}
Example 1 - get by email¶
REQUEST
{
"email":"h.everts@cloudplan.net"
}
REPLY
{
"result": true,
"user": [
{
"username": "Heye",
"name": "Everts",
"email": "h.everts@cloudplan.net",
"firstname": "Heye",
"user_id": "56A23EB6998F303B134C1C0A723447B0",
"reachability": "online",
"status_mode": "online",
"public": "public",
"image_id": "5DA97E2880405A4CC1BBB892BDCE99E6",
"supervisor": false
}
]
}
Example 2 - get all for organisation¶
REQUEST
{}
REPLY
{
"result": true,
"user": [
{
"username": "",
"name": "",
"email": "testuser8@cloudplan.net",
"firstname": "",
"user_id": "56A24FC24A86E627412FA99BDA54E057",
"reachability": "offline",
"status_mode": "status_mode",
"public": "public",
"image_id": "",
"supervisor": false
},
...
...
SOME DOCUMENTS ARE REMOVED HERE TO KEEP THE
DOCUMENTATION SHORTER
...
...
{
"username": "",
"name": "",
"email": "niels556@bitesser.de",
"firstname": "",
"user_id": "5F5244074938ECA4A20B97A4086CADDC",
"reachability": "offline",
"status_mode": "status_mode",
"public": "public",
"image_id": "",
"supervisor": false
}
]
}
Error Codes¶
none