Autentique a API do Provider

A API do Fornecedor gerencia o catálogo e os preços da conta do fornecedor. Crie suas credenciais em Configurações do Fornecedor. Essas credenciais são separadas das chaves de API de inferência e dos tokens criados para um dispositivo individual.

Criar acesso#

1. Selecione no Console o workspace que possui o fornecedor.
2. Abra as configurações do fornecedor e ative Acesso Remoto.
3. Crie um token de acesso nomeado para o fornecedor e guarde o segredo com segurança.
4. Use o UUID do fornecedor como o nome de usuário HTTP Basic e o token como sua senha.

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());

Escopos nomeados#

Os escopos são verificados para a rota e o método HTTP. O token de fornecedor atualmente emitido expõe seus escopos configurados; um token nunca concede propriedade de um fornecedor diferente. Tenha em mente o estado habilitado e o status do token ao diagnosticar uma resposta 403.

Controle de dispositivos é outra camada#

Iniciar ou parar um dispositivo requer um token criado para essa relação com o dispositivo. Ativar o Acesso Remoto do Fornecedor é um pré-requisito, mas um token de catálogo do fornecedor sozinho não é uma credencial de controle de dispositivo. Continue com Autenticação da API de Dispositivos.

Revogar acesso#

Revogue um token quando uma automação não precisar mais dele. Excluir ou revogar o token de uma integração permite aposentar essa integração sem substituir tokens não relacionados. Desativar o Acesso Remoto desativa o caminho de acesso remoto deste fornecedor.