حزمة SDK للغة TypeScript

استخدم حزمة SDK من المستودع للقراءات محددة الأنواع، وعمليات الكتابة المؤكدة، ورفع الوسائط المحلية.

@influence/sdk هي حاليا حزمة خاصة داخل المستودع، وليست حزمة منشورة للتثبيت عبر npm. تنطبق هذه الأمثلة على المشاريع التي تتوفر فيها هذه الحزمة ضمن مساحة عمل المشروع. لإنشاء عميل مستقل، استخدم واجهة API عبر HTTP.

حدد الأصل الموثوق صراحة، واقرأ المفتاح من متغيرات بيئة العملية المخصصة للأسرار:

import { InfluenceClient } from "@influence/sdk/client";

const accessToken = process.env.PUBLISH_API_TOKEN;
if (!accessToken) throw new Error("PUBLISH_API_TOKEN");

const client = new InfluenceClient({
  baseUrl: "https://influence.so",
  accessToken,
});

const catalog = await client.listTools();
const accounts = await client.callTool("accountList", {});
console.log(catalog.tools, accounts.output);

استخدم listTools() لاستكشاف الأدوات وcallTool(name, input) للأدوات التي يحدد الفهرس أنها لا تحتاج إلى تأكيد، بما فيها عمليات متابعة الرفع المصرح بها. تتطلب الإجراءات التي تحتاج إلى تأكيد استخدام prepareTool(name, input) ثم confirmTool(name, input, confirmationCapability, { idempotencyKey }). احتفظ بالمدخلات نفسها وبقيمة التأكيد نفسها وبالمفتاح نفسه بعد أي استجابة غير مؤكدة. تتحقق حزمة SDK من صحة الطلبات والاستجابات، وتطرح الخطأ InfluenceSdkError عند إخفاقات HTTP أو إخفاقات الأدوات.

تقبل uploadMedia(file, { clientKey, name, contentType, sizeBytes }) كائنا من نوع Blob، وتتولى نقل البيانات متعدد الأجزاء مع التأكيد المطلوب. أعد المحاولة بالملف نفسه وقيمة clientKey نفسها. تابع قراءة mediaUploadGet حتى يصبح عنصر الوسائط النهائي جاهزا؛ فالرفع الذي لا يزال قيد المعالجة غير جاهز للنشر. التزم بقواعد مراجعة النشر وإعادة المحاولة المنفصلة.