v6 Timeline Services¶
These services provide access to information about the timeline functionality.
v6 Recipe Types¶
Example GET /v6/timeline/recipe-types API call
Request: GET http://.../v6/timeline/recipe-types/
Response: 200 OK
{ "count": 1, "results": [ { "recipe_type_id": 1, "name": "recipe-type-name", "title": "Recipe Type Title", "revision_num": 1, "results": [{ "date": "2015-03-11T00:00:00Z", "count": 457 }] } ] }
| Timeline Recipe Types List | |||
|---|---|---|---|
| Returns a list of recipe types that were started between the given dates | |||
| GET /v6/timeline/recipe-types/ | |||
| Query Parameters | |||
| started | ISO-8601 Datetime | Required | The start of the time range to query. Supports the ISO-8601 date/time format, (ex: 2015-01-01T00:00:00Z). Supports the ISO-8601 duration format, (ex: PT3H0M0S). |
| ended | ISO-8601 Datetime | Optional | End of the time range to query, defaults to the current time. Supports the ISO-8601 date/time format, (ex: 2015-01-01T00:00:00Z). Supports the ISO-8601 duration format, (ex: PT3H0M0S). |
| id | Integer | Optional | Return timeline information matching only the given id(s). Duplicate for multiple. |
| name | String | Optional | Return timeline information matching only the given name(s). Duplicate for multiple. |
| rev | Integer | Optional | Return timeline information matching only the given revision(s). Duplicate for multiple. |
| Successful Response | |||
| Status | 200 OK | ||
| Content Type | application/json | ||
| JSON Fields | |||
| count | Integer | The total number of results that match the query parameters. | |
| results | Array | List of result JSON objects that match the query parameters. | |
| .recipe_type_id | Integer | The unique identifier of the recipe type. | |
| .name | String | The name (key) of the recipe type. | |
| .title | String | The title of the recipe type. | |
| .revision_num | Integer | The revision number of the recipe type. | |
| .results | Array | Lists the dates and counts of recipe types. | |
| .date | ISO-8601 Datetime | The date of the count. | |
| .count | Integer | Number of recipe types that were started on that date. | |
v6 Job Types¶
Example GET /v6/timeline/job-types API call
Request: GET http://.../v6/timeline/job-types/
Response: 200 OK
{ "count": 1, "results": [ { "job_type_id": 1, "name": "job-type-name", "version": "1.0.0", "title": "Job Type Title", "revision_num": 1, "results": [{ "date": "2015-03-11T00:00:00Z", "count": 338 }] } ] }
| Timeline Job Types List | |||
|---|---|---|---|
| Returns a list of job types that were started between the given dates | |||
| GET /v6/timeline/job-types/ | |||
| Query Parameters | |||
| started | ISO-8601 Datetime | Required | The start of the time range to query. Supports the ISO-8601 date/time format, (ex: 2015-01-01T00:00:00Z). Supports the ISO-8601 duration format, (ex: PT3H0M0S). |
| ended | ISO-8601 Datetime | Optional | End of the time range to query, defaults to the current time. Supports the ISO-8601 date/time format, (ex: 2015-01-01T00:00:00Z). Supports the ISO-8601 duration format, (ex: PT3H0M0S). |
| id | Integer | Optional | Return timeline information matching only the given id(s). Duplicate for multiple. |
| name | String | Optional | Return timeline information matching only the given name(s). Duplicate for multiple. |
| version | String | Optional | Return timeline information matching only the given version(s). Duplicate for multiple. |
| Successful Response | |||
| Status | 200 OK | ||
| Content Type | application/json | ||
| JSON Fields | |||
| count | Integer | The total number of results that match the query parameters. | |
| results | Array | List of result JSON objects that match the query parameters. | |
| .job_type_id | Integer | The unique identifier of the job type. | |
| .name | String | The name (key) of the job type. | |
| .version | String | The job type version. | |
| .title | String | The title of the job type. | |
| .revision_num | Integer | The revision number of the job type. | |
| .results | Array | Lists the dates and counts of job types. | |
| .date | ISO-8601 Datetime | The date of the count. | |
| .count | Integer | Number of job types that were started on that date. | |