Аутентифицируйте API провайдера

API провайдера управляет каталогом и ценами аккаунта провайдера. Создайте его учетные данные в Настройках провайдера. Эти учетные данные отличаются от ключей API для вывода и токенов, созданных для отдельного устройства.

Создать доступ#

1. Выберите рабочее пространство, которому принадлежит провайдер, в Консоли.
2. Откройте настройки провайдера и включите Удаленный доступ.
3. Создайте именованный токен доступа провайдера и сохраните секретный ключ безопасно.
4. Используйте UUID провайдера как имя пользователя HTTP Basic и токен как его пароль.

curl --fail-with-body --request GET \
  "https://api.shareai.now/api/v1/console/provider" \
  -u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN"

import json
import os
import urllib.request
import base64

credentials = os.environ["PROVIDER_UUID"] + ":" + os.environ["PROVIDER_ACCESS_TOKEN"]
headers = {"Authorization": "Basic " + base64.b64encode(credentials.encode()).decode()}
request = urllib.request.Request('https://api.shareai.now/api/v1/console/provider', headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/console/provider";
const credentials = `${process.env.PROVIDER_UUID}:${process.env.PROVIDER_ACCESS_TOKEN}`;
const headers: Record = {
  Authorization: `Basic ${Buffer.from(credentials).toString("base64")}`,
};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Названные области#

Области проверяются для маршрута и метода HTTP. Текущий выданный токен провайдера отображает его настроенные области; токен никогда не предоставляет право собственности на другого провайдера. Учитывайте включенное состояние и статус токена при диагностике ответа 403.

Управление устройствами — это еще один уровень#

Запуск или остановка устройства требует токена, созданного для этой связи с устройством. Включение удаленного доступа провайдера является предварительным условием, но токен каталога провайдера сам по себе не является учетными данными для управления устройством. Продолжайте с Аутентификация API устройства.

Отозвать доступ#

Отозвать токен, когда автоматизация перестает его использовать. Удаление или отзыв токена одной интеграции позволяет завершить эту интеграцию без замены несвязанных токенов. Отключение удаленного доступа отключает путь удаленного доступа этого провайдера.