API Automação-IOT¶
A Automaçao-IOT utiliza um conjunto de rotinas padronizadas de programação denominado de API que serve de acesso para a plataforma IOT baseado na WEB. Através da API que estabelecemos comunicação de entrada e/ou saída com os Dispositivos e/ou Recursos.
Outras Plaformas¶
A API da Automação_IOT, possibilita a conexão de outras plataformas a base de dados IOT. Vamos implementar o exemplo utilizado no SDK do ESP8266, de forma genérica para ser aplicado ao seu projeto em outras plataformas.
Get Device¶
Obtém informações sobre um determinado Dispositivo. Este EndPoint retorna dados informacionais do Dispositivo, tal como id, dono, nome e descrição do dispositivo
GET api/device/{PUBLIC_KEY}
Requisição
GET api/device/B07CFA0A9204228A30C68FB346C407E7 HTTP/1.1
Authorization: Bearer B8CE671CFE226CC190D5478E8E5A3CD7FB59D87F872278E59E4E6847B5E4B2F1
Host: https://automacao-iot.com.br/api
Resposta
{
"success": true,
"payload": {
"id_device": 12,
"id_user": 12,
"name": "ESP8266",
"icon_name": "fa-microchip",
"description": "ESP8266",
"ip": "10.1.1.11",
"timezone": "America\/Sao_Paulo",
"latitude": "-35.2837000",
"longitude": "-47.5343000",
"public_key": "B07CFA0A9204228A30C68FB346C407E7",
"api_requests_usage": 30653,
"api_network_usage": 4060992,
"api_network_income_usage": 4060875,
"api_network_outgoing_usage": 117,
"lifetime": 15,
"lifetime_updated_at": "2018-06-05 17:30:46",
"created_at": "2018-06-04 19:09:39",
"updated_at": "2018-06-04 19:09:39",
"private": 0,
"active": 1,
"is_alive": false,
"is_dead": true,
"last_sys_call": null
},
"message": ""
}
Get Resource Last Feeds¶
Recupera o último Registro de Feeds do Recurso.
GET/api/device/{PUBLIC_KEY}/resource/{ID_RESOURCE}/feeds/last
Requisição
GET api/device/B07CFA0A9204228A30C68FB346C407E7/resource/6/feeds/last HTTP/1.1
Authorization: Bearer B8CE671CFE226CC190D5478E8E5A3CD7FB59D87F872278E59E4E6847B5E4B2F1
Host: https://automacao-iot.com.br/api
Resposta
{
"success": true,
"payload": {
"id_resource_feed": 14603,
"id_resource": 6,
"raw_data": "0",
"created_at": "2018-06-05 17:13:06"
},
"message": ""
}
Create Resource Feeds¶
Insere um novo Registro de Feeds no recurso do Dispositivo.
POST /api/device/{PUBLIC_KEY}/resources/feeds
Requisição
POST api/device/B07CFA0A9204228A30C68FB346C407E7/resources/feeds HTTP/1.1
Authorization: Bearer B8CE671CFE226CC190D5478E8E5A3CD7FB59D87F872278E59E4E6847B5E4B2F1
Host: https://automacao-iot.com.br/api
Body:
[
{
"id_resource": 6,
"input": 1
}
]
Resposta
{
"success": true,
"payload": {
"success": [{
"raw_data": true,
"id_resource": 6,
"created_at": "2018-06-07 12:33:01",
"id_resource_feed": 14604
}],
"failed": []
},
"message": ""
}