Autentica la API de Proveedor

La API del Proveedor gestiona el catálogo y los precios de la cuenta del proveedor. Crea sus credenciales en Configuración del Proveedor. Estas credenciales son independientes de las claves API de inferencia y de los tokens creados para un dispositivo individual.

Crear acceso#

1. Selecciona en la Consola el espacio de trabajo que posee el proveedor.
2. Abre la configuración del proveedor y habilita Acceso Remoto.
3. Crea un token de acceso nombrado para el proveedor y guarda el secreto de forma segura.
4. Usa el UUID del proveedor como el nombre de usuario HTTP Basic y el token como su contraseña.

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

Alcances nombrados#

Los alcances se verifican para la ruta y el método HTTP. El token de proveedor emitido actualmente expone sus alcances configurados; un token nunca otorga propiedad de un proveedor diferente. Ten en cuenta el estado habilitado y el estado del token al diagnosticar una respuesta 403.

El control de dispositivos es otra capa#

Iniciar o detener un dispositivo requiere un token creado para esa relación de dispositivo. Habilitar el Acceso Remoto del Proveedor es un requisito previo, pero un token de catálogo de proveedor por sí solo no es una credencial de control de dispositivos. Continúa con Autenticación de la API de Dispositivos.

Revocar acceso#

Revoca un token cuando una automatización ya no lo necesite. Eliminar o revocar el token de una integración permite retirar esa integración sin reemplazar tokens no relacionados. Desactivar el Acceso Remoto deshabilita la ruta de acceso remoto de este proveedor.