This is an old revision of the document!


/api/applicants/ID/trackers/ID

HEAD, GET

Use the HEAD verb to test if the applicant in question has this tracker. A request with the GET verb returns some additional information about the tracker association (date assigned etc.).

Note that this will not return the tracker itself, but rather represents the relationships between the applicant and the tracker. Follow the tracker URI in the response to retrieve further information about the tracker in question.

Syntax

GET /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Response headers

Content-Type: application/json
Content-Length: 1234

Response codes

200 OK The tracker is set
404 Not Found The tracker does not exist
404 Not Found The tracker was not set to this applicant

Response example

{
  "assigned": "2014-06-29T18:11:15+00:00",
  "tracker": "/api/applicants/trackers/1"
}

PUT

Set a tracker to the applicant in question. This requires that the tracker already exists. Use POST /api/applicants/trackers to create a tracker first, then this API call will allow you to PUT the tracker (identified by it's code) to any number of applicants.

In other words, this will not create a new tracker, but create a relationship (association) between an existing tracker and an applicant.

Syntax

PUT /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Response headers

Content-Type: text/plain
Content-Length: 0

Response codes

204 No Content Tracker was successfully set
404 Not Found The tracker does not exist

DELETE

Remove the tracker from the applicant in question. Note that this does not delete the tracker itself, only removing it's association with the applicant in question.

Syntax

HEAD /api/applicants/123/trackers/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Response headers

Content-Type: text/plain
Content-Length: 0

Response codes

204 No Content Tracker was successfully deleted
404 Not Found The tracker does not exist
404 Not Found The tracker was not set to this applicant