Registering as a candidate

After receiving the invitation link, a candidate can finish its own registration with 3 steps:

1. Requests the whoami/candidate/ endpoint
2. PATCH the returned resource_uri with his new password
3. PATCH the status advance to advance his status into confirmed

Example

Note

Fields that are not relevant to the example were removed to improve readability.

Asking for whoami/candidate/ endpoint

curl -k -H 'Authorization: ActivationKey d5f3663ee4897696ad8b3ef90178ec11' https://qa.interview-suite.com:14001/api/v3/whoami/candidate/

{
  "resource_uri": "https://qa.interview-suite.com:14001/api/v3/companies/1/projects/13/candidates/54/",
  "status": "invited",
  (...)
}

Patching the password

curl -k -X PATCH -d '{"password": "1234"}' -H "Content-Type: application/json" -H 'Authorization: ActivationKey d5f3663ee4897696ad8b3ef90178ec11' https://qa.interview-suite.com:14001/api/v3/companies/1/projects/13/candidates/54/

{
  "resource_uri": "https://qa.interview-suite.com:14001/api/v3/companies/1/projects/13/candidates/62/",
  "status": "invited",
  (...)
}

Patching the status advance

curl -k -X PATCH -H 'Authorization: ActivationKey d5f3663ee4897696ad8b3ef90178ec11' https://qa.interview-suite.com:14001/api/v3/companies/1/projects/13/candidates/62/status/advance/
{
  "resource_uri": "https://qa.interview-suite.com:14001/api/v3/companies/1/projects/13/candidates/62/",
  "status": "confirmed",
  (...)
}

At this point, the candidate is confirmed and can use the standard Authentication method to obtain a valid token that he can use to get the list of questions and to publish his answers.