Body
Media type: application/json
Type:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Activations endpoint",
"description": "Add a new activation to the activations list",
"type": "object",
"additionalPropertes": false,
"required": [
"activation",
"action"
],
"properties": {
"activation":{
"$ref": "activation-schema.json"
},
"action:":{
"$ref": "map-entries-schema.json"
}
}
}
Example:
{
"activation":{
"mode": "activate_scheduled_absolute",
"requested_time": "1544448739:0"
},
"action":{
"OutA":{
"0":{
"input": "input1",
"channel_index": 2
},
"3":{
"input": "input1",
"channel_index": 1
}
}
}
}
HTTP status code 200
A 200 response is returned when a request for an immediate activation is accepted.
Body
Media type: application/json
Type:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Activations endpoint",
"description": "Activation response",
"type": "object",
"additionalPropertes": false,
"maxProperties": 1,
"patternProperties": {
"^[a-zA-Z0-9\\-_]+$": {
"type": "object",
"additionalPropertes": false,
"required": [
"activation",
"action"
],
"properties": {
"activation":{
"$ref": "activation-response-schema.json"
},
"action:":{
"$ref": "map-entries-schema.json"
}
}
}
}
}
Example:
{
"3": {
"activation":{
"mode": "activate_scheduled_absolute",
"requested_time": "1544448739:0",
"activation_time": "1544448739:0"
},
"action":{
"OutA":{
"0":{
"input": "input1",
"channel_index": 2
},
"3":{
"input": "input1",
"channel_index": 1
}
}
}
}
}
HTTP status code 202
A 202 response is returned when a request for a scheduled activation is accepted, to indicate that while the request itself was acceptable it has not yet been acted upon by the API.
Body
Media type: application/json
Type:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Activations endpoint",
"description": "Activation response",
"type": "object",
"additionalPropertes": false,
"maxProperties": 1,
"patternProperties": {
"^[a-zA-Z0-9\\-_]+$": {
"type": "object",
"additionalPropertes": false,
"required": [
"activation",
"action"
],
"properties": {
"activation":{
"$ref": "activation-response-schema.json"
},
"action:":{
"$ref": "map-entries-schema.json"
}
}
}
}
}
Example:
{
"3": {
"activation":{
"mode": "activate_scheduled_absolute",
"requested_time": "1544448739:0",
"activation_time": "1544448739:0"
},
"action":{
"OutA":{
"0":{
"input": "input1",
"channel_index": 2
},
"3":{
"input": "input1",
"channel_index": 1
}
}
}
}
}
HTTP status code 400
A 400 response is returned, for example, when the request did not meet the schema.
Body
Media type: application/json
Type:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"description": "Describes the standard error response which is returned with HTTP codes 400 and above",
"title": "Error response",
"required": [
"code",
"error",
"debug"
],
"properties": {
"code": {
"description": "HTTP error code",
"type": "integer",
"minimum": 400,
"maximum": 599
},
"error": {
"description": "Human readable message which is suitable for user interface display, and helpful to the user",
"type": "string"
},
"debug": {
"description": "Debug information which may assist a programmer working with the API",
"type": ["null", "string"]
}
}
}
Example:
{
"code": 400,
"error": "Could not match the request to the schema",
"debug": null
}
HTTP status code 423
A 423 response is returned when a conflicting activation has been scheduled.
Body
Media type: application/json
Type:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"description": "Describes the standard error response which is returned with HTTP codes 400 and above",
"title": "Error response",
"required": [
"code",
"error",
"debug"
],
"properties": {
"code": {
"description": "HTTP error code",
"type": "integer",
"minimum": 400,
"maximum": 599
},
"error": {
"description": "Human readable message which is suitable for user interface display, and helpful to the user",
"type": "string"
},
"debug": {
"description": "Debug information which may assist a programmer working with the API",
"type": ["null", "string"]
}
}
}
Example:
{
"code": 423,
"error": "Output 'OutA' is locked by another activation. No changes will be made.",
"debug": null
}