SDKs

AskAIs ایک پروٹوکول-فرسٹ طریقہ اختیار کرتا ہے: ایک OpenAPI 3.1 تفصیل، ایک WebSocket پروٹوکول، اور HMAC سے دستخط شدہ webhooks۔ آپ API کو کسی بھی زبان سے کال کر سکتے ہیں اور اپنا UI خود رینڈر کر سکتے ہیں۔ آج ہم صرف ایک پیک شدہ UI SDK شائع کرتے ہیں، یعنی نیٹیو Flutter وجٹ۔

شائع شدہ SDK: Flutter وجٹ

آج ہم جو واحد SDK فراہم کرتے ہیں وہ sdks/flutter-widget/ میں موجود ہے۔ یہ ایک مکمل اور تھیم بدلنے کے قابل چیٹ UI ہے جو آپ کی جانب سے REST API اور WebSocket سے رابطہ کرتا ہے۔ اسے مقامی پیکیج کے طور پر اپنی pubspec.yaml میں شامل کریں:

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

iOS اور Android

iOS یا Android کے لیے کوئی الگ نیٹیو SDK نہیں ہے۔ دو معاون راستے ہیں:

• WebView (تجویز کردہ)، ویب وجٹ کو /api/widget-embed سے لوڈ کریں۔ یہ مکمل خصوصیات والا وجٹ ہے اور خودکار طور پر اپ ڈیٹ ہوتا ہے، اس لیے آپ کو نئی چیٹ خصوصیات حاصل کرنے کے لیے کبھی ایپ کی نئی ریلیز شائع نہیں کرنی پڑتی۔
• REST API، API کو براہِ راست کال کریں اور اپنا نیٹیو UI خود رینڈر کریں۔

SwiftUI یا Jetpack Compose میں کوئی تیار شدہ چیٹ ویو نہیں ہے۔ آپ یا تو WebView کو ایمبیڈ کرتے ہیں یا API کے اوپر UI خود بناتے ہیں۔

کوئی بھی دوسری زبان: REST API کو کال کریں

ہم Python، Go، Rust، C#، Java، PHP، Ruby یا اسی طرح کی زبانوں کے لیے پہلے سے بنے ہوئے کلائنٹس فراہم نہیں کرتے، اور React Native، Unity یا Unreal کے لیے کوئی سرکاری SDK نہیں ہے۔ اس کے بجائے OpenAPI 3.1 تفصیل کے ساتھ ایک عوامی REST API موجود ہے، جسے آپ سادہ HTTP کے ذریعے کال کر سکتے ہیں یا اپنا کلائنٹ خود تیار کر سکتے ہیں:

• OpenAPI: GET /api/v1/openapi.json
• WebSocket: ایونٹ JSON کے لیے Web widget دستاویزات دیکھیں

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 (Twitter) کی جگہ تیار ہے۔
• پلیٹ فارم پر میزبان AI: کوئی API کلید درکار نہیں، ٹوکن کے حساب سے بلنگ، خودکار ری چارج اور انسانی فال بیک کے ساتھ، یا اپنی کلید استعمال کریں۔
• AI ٹریننگ سینٹر: اپنی سائٹ کو کرال کریں، PDF، Word یا DOCX فائلیں اپ لوڈ کریں، CSV سے سوال و جواب کے جوڑے شامل کریں، اور لانچ سے پہلے Playground میں مشق کریں۔
• 13 زبانوں کا مدد مرکز، خود کار مضامین اور FAQ کے لیے۔
• مکمل وائٹ لیبل، ہر گاہک کو نظر آنے والی سطح پر۔
• بلاک روکنے والی ملٹی ڈومین ترسیل، وجٹ کے لیے۔

فوری مثالیں

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" }'