پرووائیڈر API کو مستند کریں

پرووائیڈر API پرووائیڈر اکاؤنٹ کے کیٹلاگ اور قیمتوں کا انتظام کرتا ہے۔ اس کی اسناد پرووائیڈر سیٹنگز میں بنائیں۔ یہ اسناد انفرنس API کلیدوں اور انفرادی ڈیوائس کے لیے بنائے گئے ٹوکنز سے الگ ہیں۔

ایکسیس بنائیں#

1. Console میں اس ورک اسپیس کو منتخب کریں جو پرووائیڈر کی مالک ہے۔
2. پرووائیڈر کی سیٹنگز کھولیں اور فعال کریں ریموٹ ایکسیس.
3. ایک نامزد پرووائیڈر ایکسیس ٹوکن بنائیں اور سیکریٹ کو محفوظ طریقے سے محفوظ کریں۔
4. HTTP بیسک یوزر نیم کے طور پر پرووائیڈر UUID اور پاس ورڈ کے طور پر ٹوکن استعمال کریں۔

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 تصدیق کے ساتھ.

ایکسیس منسوخ کریں#

جب کسی آٹومیشن کو ٹوکن کی ضرورت نہ ہو تو اسے منسوخ کریں۔ کسی انضمام کے ٹوکن کو حذف یا منسوخ کرنے سے آپ اس انضمام کو ریٹائر کر سکتے ہیں بغیر غیر متعلقہ ٹوکنز کو تبدیل کیے۔ ریموٹ ایکسیس کو بند کرنا اس پرووائیڈر کے ریموٹ ایکسیس راستے کو غیر فعال کر دیتا ہے۔