Differences

This shows you the differences between two versions of the page.

--- api:api_applicants_trackers [2014/06/25 16:14] – Lauri
+++ api:api_applicants_trackers [2024/07/30 11:50] (current) – external edit 127.0.0.1
@@ Line 15: / Line 15: @@
   Content-Type: application/json
   Content-Length: 1234
+==== Response example ====
+  {
+    "1": {
+        "created": "2014-06-25T11:09:37+00:00",
+        "code": "FAIR",
+        "notes": "Some notes",
+        "reduction": null
+    },
+    "3": {
+        "created": "2014-06-25T16:47:24+00:00",
+        "code": "INTERNET",
+        "notes": "Some notes",
+        "reduction": {
+            "reduction": "Percent",
+            "percent": 20
+        }
+    },
+  }
 ===== POST =====
-Add a new tracker using any text (2 to 16 characters) as the tracker code. If a tracker with this code exists, a ''409 Conflict'' will be returned. You are expected to use the ''PUT'' verb to add **existing** flags to applicants, see [[api:api_applicants_123_trackers_agent|/api/applicants/123/trackers/AGENT]]
+Add a new tracker using any text (2 to 16 characters) as the tracker code. The URI for the tracker created is returned in the ''Location'' header.
-In any case, the URI for the tracker created (or the tracker conflicting) is returned in the ''Location'' header.
+If a tracker with this code exists, a ''409 Conflict'' will be returned, along with the URI of the offending tracker in the ''Location'' header.
-**This method simply creates a new tracker, but does not assign it to any applicants.** You can later ''PUT'' the tracker to any number of applicants using ''PUT'' [[api:api_applicants_trackers_agent|/api/applicants/trackers/AGENT]].
+**This method simply creates a new tracker, but does not assign it to any applicants.** You can later ''PUT'' the tracker to any number of applicants using ''PUT'' [[api:api_applicants_id_trackers_id|/api/applicants/ID/trackers/ID]].
 ==== Syntax ====
@@ Line 33: / Line 54: @@
 ==== Parameters ====
-| ''name'' | **Required** | This is the unique tracker code, should be easily recognisable. 2 to 16 characters. |
+^ Name ^  ^ Description ^
+| ''code'' | **Required** | This is the unique tracker code, should be easily recognisable. 2 to 16 characters. |
 | ''notes'' | **Required** | This text will be used to additionally explain the meaning of the tracker code. 2 to 200 characters. |