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 دستگاه.

لغو دسترسی#

یک توکن را زمانی که یک اتوماسیون دیگر به آن نیاز ندارد لغو کنید. حذف یا لغو توکن یک ادغام به شما اجازه می‌دهد آن ادغام را بدون جایگزینی توکن‌های غیرمرتبط بازنشسته کنید. خاموش کردن دسترسی از راه دور مسیر دسترسی از راه دور این ارائه‌دهنده را غیرفعال می‌کند.