حِزم SDK

يتبع AskAIs نهج البروتوكول أولاً: مواصفة OpenAPI 3.1 واحدة، وبروتوكول WebSocket واحد، وخطافات ويب موقّعة بـ HMAC. يمكنك استدعاء الـ API بأي لغة وعرض واجهتك الخاصة. اليوم ننشر حزمة واجهة واحدة مجهّزة فقط، وهي أداة Flutter الأصلية.

حزمة SDK المنشورة: أداة Flutter

حزمة SDK الوحيدة التي نوفّرها اليوم موجودة في sdks/flutter-widget/. وهي واجهة محادثة كاملة وقابلة لتغيير السمة، تتولى عنك التواصل مع الـ REST API و WebSocket. أضِفها إلى ملف pubspec.yaml كحزمة محلية:

# pubspec.yaml
dependencies:
  singchat_widget:
    path: ../sdks/flutter-widget

iOS و Android

لا توجد حزمة SDK أصلية منفصلة لـ iOS أو Android. هناك مساران مدعومان:

• WebView (موصى به)، حمّل أداة الويب من /api/widget-embed. إنها الأداة الكاملة الميزات وتُحدَّث تلقائيًا، لذا لن تحتاج أبدًا إلى إصدار نسخة جديدة من التطبيق لمجرد الحصول على ميزات محادثة جديدة.
• REST API، استدعِ الـ API مباشرة واعرض واجهتك الأصلية الخاصة.

لا توجد واجهات محادثة جاهزة في SwiftUI أو Jetpack Compose. فإما أن تضمّن WebView أو تبني الواجهة بنفسك فوق الـ API.

أي لغة أخرى: استدعاء الـ REST API

نحن لا نوفّر عملاء مبنيين مسبقًا لـ Python أو Go أو Rust أو C# أو Java أو PHP أو Ruby أو ما شابه، ولا توجد حزم SDK رسمية لـ React Native أو Unity أو Unreal. بدلاً من ذلك، هناك REST API عام مع مواصفة OpenAPI 3.1، يمكنك استدعاؤه عبر HTTP مباشر أو توليد عميلك الخاص:

• OpenAPI: GET /api/v1/openapi.json
• WebSocket: راجع وثائق أداة Web للاطلاع على JSON الأحداث

ولّد عميلاً للغة التي تريدها باستخدام openapi-generator:

# generate a client from the public spec
npx @openapitools/openapi-generator-cli generate \
  -i https://singchat.org/api/v1/openapi.json \
  -g python \
  -o ./singchat-client

ما يوفّره AskAIs

إلى جانب الأداة، هذه القدرات في المنتج متاحة اليوم:

• صندوق وارد موحّد عبر أداة الويب و Telegram و WhatsApp، مع خانة X (تويتر) جاهزة.
• ذكاء اصطناعي مُستضاف على المنصة: لا يتطلب مفتاح API، تُحتسب التكلفة بالـ token مع إعادة شحن تلقائية وتحويل إلى موظف بشري، أو استخدم مفتاحك الخاص.
• مركز تدريب الذكاء الاصطناعي: زحف موقعك، ورفع ملفات PDF أو Word أو DOCX، وإضافة أزواج أسئلة وأجوبة من ملف CSV، والتدرّب في Playground قبل الإطلاق.
• مركز مساعدة بـ 50 لغة لمقالات الخدمة الذاتية والأسئلة الشائعة.
• علامة بيضاء كاملة عبر كل واجهة يراها العميل.
• توصيل متعدد النطاقات مقاوم للحجب للأداة.

أمثلة سريعة

Flutter widget

import 'package:singchat_widget/singchat_widget.dart';

// mount the themeable chat UI
SingChatWidget(
  appId: 'ws_abc123',
  user: SingChatUser(
    externalId: 'user_42',
    email: 'ada@example.com',
  ),
)

iOS WebView

import WebKit

let webView = WKWebView(frame: view.bounds)
let url = URL(string: "https://singchat.org/api/widget-embed?appId=ws_abc123")!
webView.load(URLRequest(url: url))
view.addSubview(webView)

Android WebView

val webView = WebView(this)
webView.settings.javaScriptEnabled = true
webView.loadUrl("https://singchat.org/api/widget-embed?appId=ws_abc123")
setContentView(webView)

curl خام

# identify against the REST API (any language, no library)
curl https://singchat.org/api/v1/auth/identify \
  -H "Content-Type: application/json" \
  -d '{ "appId": "ws_abc123", "email": "ada@example.com" }'