Users
On DoYouBuzz Showcase, the user id matches the DoYouBuzz user id
If you need to direct a manager to a Showcase user's profile page, you should use this URL : https://showcase.doyoubuzz.com/a/user/{dybid}/profile
Get all users for your company
GET /users
URL parameters
Name |
Description |
Type |
filter |
Specify the kind of users you want to retrieve (user, candidate, admin of manager) |
u | c | a |m |
page |
Page number (results are paginated) |
Integer |
Example
GET /users
{
"users": [
{
"id": 1,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Will",
"lastname": "Adama",
"phone": "02 40 69 73 15",
"id_origin": "1"
},
{
"id": 2,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Laura",
"lastname": "Roslin",
"id_origin": "2"
},
{
"id": 3,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Brendan",
"lastname": "Constanza",
"kind": "user",
"id_origin": "187"
},
{
"id": 4,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Alex",
"lastname": "Quartararo",
"kind": "candidate",
"id_origin": "342"
},
{
"id": 5,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Margaret",
"lastname": "Edmonson",
"kind": "user",
"id_origin": "812"
},
{
"id": 6,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Kara",
"lastname": "Thrace",
"kind": "user",
"id_origin": "1664"
},
{
"id": 7,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Galen",
"lastname": "Tyrol",
"kind": "user",
"id_origin": "156"
},
{
"id": 8,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Samuel",
"lastname": "Anders",
"kind": "143"
},
{
"id": 9,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Billy",
"lastname": "Keikeya",
"kind": "user",
"id_origin": "111"
},
{
"id": 10,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Gaïus ",
"lastname": "Baltar",
"kind": "user",
"id_origin": "786"
},
{
"id": 11,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Tom ",
"lastname": "Zarek",
"kind": "candidate",
"id_origin": "435"
},
{
"id": 18,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Lee",
"lastname": "Adama",
"kind": "candidate",
"id_origin": "1664"
}
],
"total": 12
}
Search for a user
GET /users/search
The user search will search all the user's first name, last name and email address matching the given search term.
URL parameters
Name |
Description |
Type |
term |
Search term |
|
Example
GET /users/search?term=will
{
[
{
"username":"[email protected]",
"email":"[email protected]",
"id_origin":"124",
"firstname":"Will",
"lastname":"Adama",
"phone": "02 40 69 73 15",
"id":2
},
{
"username":"[email protected]",
"email":"[email protected]",
"id_origin":"147",
"firstname":"William",
"lastname":"Roslin",
"id":18
},
]
}
Get a single user information
GET /users/:id
URL parameters
Name |
Description |
Type |
isIdOrigin (optional). Default to 0. |
Set this parameter to "1" if the id your are sending is the ID on your system. It works only if you have setup a SSO in your Showcase account |
boolean |
Example
GET /users/6
{
"id": 6,
"username": "[email protected]",
"email": "[email protected]",
"firstname": "Kara",
"lastname": "Thrace",
"phone": "555 666 7777",
"kind": "user",
"id_origin": "1664"
}
Get a user's CV
GET /users/:id/cv
Example
GET /users/6/cv
[
{
"title": "Pilote de Viper",
"completion": 0.42,
"anonymized": false,
"main": true,
"id": 2679,
"public_url": "https://cv.battlestar-gallactica.cf/Piq5h6dBT7KPccWvsP5UBQ/-Xv63R1jNVGCE_osaJ9rATpbKFx4",
"private_url": "https://cv.battlestar-gallactica.cf/Piq5h6dBT7KPccWvsP5UBQ/-Xv63R1jNVGCE_osaJ9rATpbKFx4",
"created": "2013-03-07T11:08:42+0100",
"indexed": true,
"protected": false,
"updated": "2013-03-07T12:30:21+0100",
"language": "fr_FR"
},
{
"title": "Pilote de Viper",
"completion": 0.42,
"anonymized": true,
"main": false,
"id": 2680,
"public_url": "https://cv.battlestar-gallactica.cf/Piq5h6dBT7KPccWvsP5UBQ/-Xv63R1jNVGCE_osaJ9rATpbKFx4",
"private_url": "https://cv.battlestar-gallactica.cf/Piq5h6dBT7KPccWvsP5UBQ/-Xv63R1jNVGCE_osaJ9rATpbKFx4",
"created": "2013-03-07T11:24:17+0100",
"updated": "2013-03-07T14:48:35+0100",
"language": "fr_FR"
}
]
Get a user's tags
GET /users/:id/tags
Example
Logout a user
DELETE /users/:id/logout
If a user is connected on DoYouBuzz Showcase, this method will logout the user.
URL parameters
Name |
Description |
Type |
isIdOrigin (optional). Default to 0. |
Set this parameter to "1" if the id your are sending is the ID on your system. It works only if you have setup a SSO in your Showcase account |
boolean |
Example
DELETE /users/6/logout
{ success: true }
Associate tags on a user
PUT /users/:id/associateTags
Body parameters
Name |
Description |
Type |
tags |
Id of the tag to associate on the current user or array of ids |
integer | Array |
reset (optional) |
You can use this option to indicates you want to reset all the current tags associated to the user before applying the one sent in the request |
Boolean |
Example
Disassociate tags on a user
PUT /users/:id/tags
Name |
Description |
Type |
tags |
Id of the tag to disassociate on the current user |
integer | Array |
Example
Changer User Kind
PUT /users/:id/kind
Name |
Description |
Type |
kind |
New kind for the user |
string "user", "candidate", "other" |
Example
Request
PUT /users/777/kind
kind=candidate
Response
You get a 204 response code (request successful) if user's kind have been changed
Set User's manager
PUT /users/:id/manager
Name |
Description |
Type |
managerId |
New manager for the user |
integer |
Example
Request
PUT /users/66709/manager
managerId=36789
Response
You get a 204 response code (request successful) if user's manager has been changed
Get comment
GET
/users/:id/comment
Example
Update comment
POST ou PUT
/users/:id/comments
Required body parameter
Name |
Description |
Type |
comment |
The comment you want to set to the user |
string |
Example
Request example
POST /users/:id/comment
comment=Un employé model
Response example
{
"id": 1,
"text": "Un employé model",
"created": "2019-11-19T16:41:14+0100",
"updated": "2019-11-19T16:47:50+0100",
"user": {
"username": "[email protected]",
"email": "[email protected]",
"name": "Karl Agathon",
"kind": "candidate",
"id": 879,
"id_origin": null,
"firstname": "Karl",
"lastname": "Agathon",
"title": "Officier de contre-mesures électroniques",
"phone": null,
"occupation": null,
"url": "/app_dev.php/a/user/6",
"displayKind": "Candidat"
},
"author": null
}
Request example
GET/users/123/comment
Response example