Atalhos da Apple

Introdução

Neste tutorial vamos criar um Atalho da Apple para ligar e desligar um relé conectado a um ESP8266, ESP32 ou Raspberry Pi usando a API Sinric Pro.

Pré-requisitos:

Complete o Tutorial - Ligar e desligar um Relé para aprender como conectar seu ESP ou Pi ao Sinric Pro.

Passo 1: Criar uma nova Chave API no Sinric Pro

Faça login no Portal Sinric, selecione Credentials e clique em New API Key, clique em save e Copy a Chave API recém-criada

gif

Você pode usar o curl para enviar uma requisição de teste para este endpoint da API.

curl --location --request POST 'https://apple.sinric.pro/v1/shortcuts/actions' \
--header 'Content-Type: application/json' \
--data-raw '{ "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setPowerState", "value": { "state" : "On"} }'

Passo 2: Criar Atalho da Apple

Crie um novo atalho e adicione a ação Get Contents of URL.
No campo URL, digite a URL: https://apple.sinric.pro/v1/shortcuts/actions
Toque no campo Method e selecione POST.
Toque no campo Body e adicione o corpo da sua requisição POST.

Chave	Tipo de Entrada	Texto
api_key	Text	Sua chave API de cima.
device_id	Text	Seu ID do dispositivo do Portal Sinric Pro.
action	Text	Ação a executar. defina como `setPowerState`. Veja abaixo para mais exemplos.
value	Dictionary	Digite `state` como chave e valor `On` ou `Off`.

Toque no botão play abaixo para testar a requisição!

Sinric Pro Apple shortcut

Agora você pode controlar seu ESP8266, ESP32 ou Raspberry Pi via Atalho da Apple da tela inicial.

Mais exemplos

Ligar ou Desligar:

{ "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setPowerState", "value": { "state" : "On"} }

Portão da garagem abrir/fechar:

{ "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setMode", "value": { "mode" : "Open"} }

Persianas abrir/fechar:

{ "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setRangeValue", "value": { "rangeValue" : 100} }

Alterar nível de potência:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setPowerLevel", "value": { "powerLevel": 50 } }

Alterar brilho:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setBrightness", "value": { "brightness": 50 } }

Acionar campainha:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "DoorbellPress", "value": {  "state": "pressed" } }

Definir temperatura alvo:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "targetTemperature", "value": {  "temperature": 18 } }

Alterar cor:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setColor", "value": {  "color": { "b": 0, "g": 0, "r": 0 } } }

Alterar temperatura da cor:

    { "api_key": "SUA_CHAVE_API_DE_CIMA", "device_id": "SEU_ID_DO_DISPOSITIVO", "action": "setColorTemperature", "value": {"colorTemperature":2700} }