SHAREAI کے ساتھ تعمیر کریں
ایک اپائنٹمنٹ ایپ بنائیں جو صارفین کو ShareAI سے جوڑتی ہے، مفید AI ایجنڈے تیار کرتی ہے اور انہیں ان کے AI اخراجات پر کنٹرول دیتی ہے۔
وہ تجربہ جو آپ تعمیر کریں گے
JamZY · اپائنٹمنٹسایک اپائنٹمنٹ منتخب کریں۔ ShareAI کو جوڑیں۔ منصوبہ کے ساتھ پہنچیں۔
آپ کا نفاذ
تین ٹھوس نتائج: صارف کو جوڑیں، ان کی اپائنٹمنٹ تیار کریں، اور انضمام کو تصدیق کے لیے تیار کریں۔
ایک صارف اپنے ShareAI اکاؤنٹ کا انتخاب کرتا ہے، آپ کی ایپ کی منظوری دیتا ہے اور JamZY پر واپس آتا ہے۔
سائن ان کریں، سیشن کو ریفریش کریں اور کامیابی سے منقطع کریں۔
ایک اپائنٹمنٹ مقصد کو ایجنڈا اور سوالات میں تبدیل کریں ایک سوچے سمجھے AI درخواست کے ذریعے۔
ایک مسودہ تیار کریں؛ اپائنٹمنٹ کو محفوظ کرنا کوئی AI کال نہیں کرتا۔
اختیاری AI فیس کی وضاحت کریں اور پلیٹ فارم چیکس جمع کریں جو آپ کے جائزہ جمع کرانے کی ضرورت ہے۔
ہر شامل پلیٹ فارم اور درخواست کردہ دائرہ کار کے ریکارڈ شدہ چیکس ہیں۔
اسے اپنے ایڈیٹر میں لے جائیں
مکمل گائیڈ کو نفاذ کے مقصد، مطلوبہ ان پٹس اور قبولیت چیکس کے ساتھ کاپی کریں۔ کوڈ مثالیں، ٹیبلز اور دستاویزات کے لنکس کو ایک ساتھ رکھیں۔
آپ کے پروجیکٹ کے لیے تیار، اس فارمیٹ میں جس کی آپ کو ضرورت ہے۔
تازہ ترین
آپ ایک ایسا کنیکشن بنائیں گے جو آپ کے گاہک سمجھ سکیں: ان کا ShareAI اکاؤنٹ، ایک اختیاری AI تیاری ڈرافٹ، اور ان کے اپائنٹمنٹ کی طرف ایک واضح راستہ۔
جہاں آپ کام کریں گے آپ کی مکمل مثال
اپنی ایپلیکیشن کو ShareAI Builder سے کنیکٹ کریں، اندراج سے لے کر ایک ٹیسٹ شدہ انٹیگریشن تک جو جائزے کے لیے تیار ہو۔ یہ واک تھرو JamZY استعمال کرتا ہے، ایک چھوٹی Node.js اپائنٹمنٹ ایپلیکیشن، ہر مرحلہ دکھانے کے لیے: ایپ رجسٹر کریں، اس کے ویب پلیٹ فارم کو کنفیگر کریں، گاہک کے ShareAI اکاؤنٹ کو کنیکٹ کریں اور ایک مجاز AI درخواست بھیجیں۔ یہی مراحل اپنی پروڈکٹ پر لاگو کریں۔
| صلاحیت | گاہک کس چیز پر اتفاق کرتا ہے | JamZY کیا ظاہر کرتا ہے |
|---|---|---|
| ShareAI کے ساتھ لاگ ان کریں | ایک اکاؤنٹ کنیکشن اور وہ شناختی معلومات جو آپ کی ایپ درخواست کرتی ہے۔ | ایک نجی گاہک کی شناخت مستند یوزر معلومات سے۔ |
| ShareAI کے ساتھ ادائیگی کریں · AI استعمال | گاہک کے منتخب کردہ ذاتی یا تنظیمی اکاؤنٹ کا استعمال مجاز انفرنس کے لیے۔ | ایک اپائنٹمنٹ تیاری ڈرافٹ جو اس اکاؤنٹ کے اہل کریڈٹس سے فنڈ کیا گیا ہو۔ |
| Builder مارک اپ | اضافی AI استعمال کی فیس جو قبول شدہ ایپلیکیشن معاہدے میں شامل ہو۔ | اختیاری استعمال کی مونیٹائزیشن، منظوری اور معاہدے کی اشاعت کے بعد۔ |
| پروڈکٹ کی ادائیگیاں | ایک مخصوص خریداری جو ایک علیحدہ ShareAI چیک آؤٹ میں پیش کی گئی ہو۔ | ایک توسیع جو وضاحت کرتی ہے ادائیگی واک تھرو۔ اپائنٹمنٹ ڈیمو چیک آؤٹ کو نافذ نہیں کرتا۔ |
ایک ShareAI اکاؤنٹ، ذاتی یا تنظیمی اکاؤنٹ استعمال کرنے کی اجازت جو ایپ کا مالک ہوگا، ایک عوامی HTTPS کال بیک، ایک لوگو، اور کام کرنے والے پرائیویسی، شرائط اور اکاؤنٹ ڈیلیشن صفحات رکھیں۔ مثال چلانے کے لیے، Node.js 22 یا جدید تر اور اپنی ایپلیکیشن کے لیے ایک HTTPS ایڈریس استعمال کریں۔
اسکرین شاٹس مثال کے طور پر ایپلیکیشن کی تفصیلات استعمال کرتے ہیں۔ ShareAI اس گائیڈ میں دیے گئے ایڈریس پروڈکشن ایڈریس ہیں۔ تیاری کی تخلیق ایک حقیقی AI درخواست پیدا کرتی ہے اور کریڈٹس خرچ کر سکتی ہے؛ ڈیمو اپائنٹمنٹ کو منتخب یا محفوظ کرنا ایسا نہیں کرتا۔ تصدیقی چیک آپ کے اپنے کامیاب انٹیگریشن ٹیسٹس کے ذریعے مکمل کیے جاتے ہیں۔
آپ اکاؤنٹ لاگ ان، AI استعمال، اختیاری اضافی چارج اور تصدیق شدہ پروڈکٹ خریداری میں فرق کر سکتے ہیں۔ اس گائیڈ کو پڑھنے کے لیے کسی ادائیگی کی درخواست کی ضرورت نہیں ہے۔
آپ وہ Builder شناخت بنائیں گے جو آپ کی ایپلیکیشن اور اس کے کسٹمر تعلقات کی مالک ہوگی۔
جہاں آپ کام کریں گے Console → بلڈر پروگرام
Builder Program مطلوبہ مالک کے لیے کھلتا ہے اور نیا ایپ پیش کرتا ہے۔ اندراج کا فیصلہ، درخواست کا جائزہ، عوامی معلومات کا جائزہ اور Monetization Gateway منظوری الگ مراحل ہیں۔
آپ JamZY کو اس کا اپنا ایپلیکیشن ریکارڈ دیں گے، تاکہ اس کی شناخت، رسائی اور تجارتی شرائط ایک ساتھ رہیں۔
جہاں آپ کام کریں گے بلڈر پروگرام → پروڈکٹ → نیا ایپ
ایپلیکیشن پروفائل کے لیے ایک قابل رسائی عوامی ویب سائٹ استعمال کریں۔ ایک نجی یا صرف مقامی ویب سائٹ توثیق میں ناکام ہو سکتی ہے، چاہے آپ کا ڈویلپمنٹ کال بیک درست طریقے سے رجسٹرڈ ہو۔ نئی ایپلیکیشن ایک ڈرافٹ کے طور پر شروع ہوتی ہے۔ آپ اسے عوامی کیے بغیر ترمیم جاری رکھ سکتے ہیں۔ اس کا ایپلیکیشن شناخت کنندہ OAuth کلائنٹ ID یا سبسکرپشن ID سے مختلف ہے۔
JamZY مطلوبہ مالک کے لیے پروڈکٹ کے تحت ظاہر ہوتا ہے۔ ہر ڈیوائس پلیٹ فارم کے لیے ایک اضافی ایپلیکیشن نہ بنائیں۔
آپ کو OAuth کے اختیارات ملیں گے جو اس بات پر منحصر ہیں کہ آپ کی ایپ کہاں چلتی ہے اور اس کے اسناد کو کون کنٹرول کرتا ہے۔
جہاں آپ کام کریں گے نیا ایپ → ایپلیکیشن سیٹ اپ
اگر آپ JamZY ڈپلائمنٹ خود چلاتے ہیں، تو وہ قیمت کا ماڈل منتخب کریں جو آپ کی پیشکش سے میل کھاتا ہو، SaaS، وینڈر ہوسٹڈ کلاؤڈ ایپ، صارف اپنی کھپت کے لیے خود ادائیگی کرتا ہے، اور ShareAI AI درخواستوں کے لیے۔ یہ مثال کے جوابات ہیں، ہر پروڈکٹ کے لیے ضروری نہیں۔
| جہاں ایپ چلتی ہے | OAuth انتخاب | جہاں اسناد موجود ہیں |
|---|---|---|
| آپ کا ہوسٹڈ بیک اینڈ | ویب سرور کلائنٹ کلائنٹ سیکریٹ استعمال کر سکتا ہے۔ PKCE اب بھی لاگو ہوتا ہے۔ | سیکریٹ اور ٹوکن آپ کے سرور پر رہتے ہیں۔ |
| براؤزر ایپلیکیشن / SPA | عوامی ویب کلائنٹ PKCE کے ساتھ۔ | کوئی ایمبیڈڈ کلائنٹ سیکریٹ نہیں۔ مناسب براؤزر یا بیک اینڈ سیشن ڈیزائن استعمال کریں۔ |
| سیلف ہوسٹڈ یا ہائبرڈ تقسیم | آن بورڈنگ پالیسی کے تحت PKCE کے ساتھ عوامی کلائنٹ۔ | صارف کی تنصیبات پر مشترکہ وینڈر سیکریٹ تقسیم نہ کریں۔ |
| ونڈوز، macOS، لینکس، اینڈرائیڈ یا iOS | ہر فعال پلیٹ فارم کے لیے ایک عوامی کلائنٹ۔ | PKCE اور پلیٹ فارم کے مطابق محفوظ اسٹوریج؛ کوئی بنڈل شدہ سیکریٹ نہیں۔ |
ڈاؤن لوڈ کے قابل JamZY نمونہ جان بوجھ کر PKCE کے ساتھ عوامی ویب کلائنٹ استعمال کرتا ہے، حالانکہ اس میں ایک چھوٹا بیک اینڈ ہے۔ سرور ٹوکن کو براؤزر اسٹوریج سے باہر رکھتا ہے۔ وینڈر ہوسٹڈ جواب سرور کلائنٹ کی اجازت دیتا ہے؛ یہ آپ کو ایک منتخب کرنے پر مجبور نہیں کرتا۔
آپ محفوظ جوابات کو ایپلیکیشن معلومات → ایپلیکیشن سیٹ اپ کے تحت دوبارہ دیکھ سکتے ہیں۔ ڈپلائمنٹ میں تبدیلیاں غیر مطابقت پذیر کلائنٹ سیکریٹس کو ہٹا سکتی ہیں اور دوبارہ تصدیق کی ضرورت ہو سکتی ہے۔ محفوظ کرنے سے پہلے اس اثر کا جائزہ لیں۔
محفوظ شدہ ڈپلائمنٹ آپ کی حقیقی آرکیٹیکچر کی وضاحت کرتا ہے۔ کلائنٹ سیکریٹ آپشن اس جواب کی پیروی کرتا ہے؛ ایک غیر فعال آپشن پالیسی کی وضاحت ہے، گمشدہ اسناد نہیں۔
آپ صارفین کو وہ پروڈکٹ تفصیلات اور پالیسیاں دیں گے جن کی انہیں کنیکٹ کرنے کا فیصلہ کرنے سے پہلے ضرورت ہے۔
جہاں آپ کام کریں گے ایپلیکیشن معلومات
ڈیش بورڈ کے بعد ایپلیکیشن معلومات کھولیں۔ مخصوص سیکشنز پر کام کریں: تفصیلات، ایپلیکیشن سیٹ اپ، پریزنٹیشن، برانڈنگ، گیلری اور جائزہ۔ پروڈکٹ کو ایک مفید وضاحت، ایک درست ویب سائٹ اور صارف ورک فلو کے واضح اسکرین شاٹس دیں۔
اپنی ایپ کی شناخت استعمال کریں۔ ShareAI برانڈنگ انٹیگریشن بٹن اور وضاحتی مواد پر ہونی چاہیے؛ یہ آپ کے پروڈکٹ لوگو کی جگہ نہیں لینی چاہیے۔ پرائیویسی، شرائط اور حذف کرنے کے لنکس کو بغیر سائن ان کیے قابل رسائی رکھیں۔
جب فلوٹنگ سیو ایکشن ظاہر ہو تو تبدیلیاں محفوظ کریں۔ عوامی معلومات کی تجویز کا اپنا جائزہ ہے؛ منظور شدہ تجویز میں ترمیم خاموشی سے لائیو عوامی پریزنٹیشن کو تبدیل نہیں کرتی۔
ایک وزیٹر سمجھ سکتا ہے کہ JamZY کیا کرتا ہے، کون اسے چلاتا ہے، اور حذف کرنے کی درخواست کیسے کی جائے۔ عوامی تفصیلات اور کال بیک کنفیگریشن ایک ہی پروڈکٹ کا حوالہ دیتے ہیں۔
آپ وہ رسائی طلب کریں گے جو آپ کی ملاقات کے تجربے میں واقعی استعمال ہوتی ہے اور اس کے بلنگ مقصد کو واضح کریں گے۔
جہاں آپ کام کریں گے ایپلیکیشن → استعمال کے کیسز
استعمال کے کیسز میں، اکاؤنٹ کنکشن کے لیے ShareAI لاگ ان کو فعال کریں اور Pay with ShareAI کسٹمر فنڈڈ فلو کے لیے جسے آپ سپورٹ کرنا چاہتے ہیں۔ صرف اس وقت Monetization Gateway رسائی کی درخواست کریں جب آپ کی پروڈکٹ AI استعمال پر اضافی فیس حاصل کرے گی۔ کنسول میں دکھائی گئی منظوری کی حیثیت پر عمل کریں۔
| اسکوپ | آپ اسے کیوں طلب کریں گے |
|---|---|
openid | کلائنٹ-اسکوپڈ شناخت کا استعمال کرتے ہوئے اکاؤنٹ کو کنیکٹ کریں۔ |
profile / email | پروفائل یا ای میل کلیمز صرف اس وقت طلب کریں جب آپ کی پروڈکٹ کو ان کی ضرورت ہو۔ |
inference | ایپلیکیشن کنفیگریشن کے ذریعے اجازت دی گئی AI انفرنس اینڈپوائنٹس کو کال کریں۔ |
monetization_gateway | سرچارجڈ انفرنس کے لیے کسٹمر کے ذریعہ قبول شدہ AI بلنگ معاہدے کا استعمال کریں۔ |
payments | کسٹمر کی ادائیگی کی درخواستیں بنائیں اور ان کا معائنہ کریں۔ ہر خریداری کو اب بھی تصدیق کی ضرورت ہے۔ |
JamZY درخواستیں openid profile inference monetization_gatewayیہ درخواست نہیں کرتا payments اور چیک آؤٹ کے ذریعے پروڈکٹ فروخت نہیں کرتا۔ کنسول میں کسی صلاحیت کو فعال کرنا موجودہ رسائی ٹوکن کو نہیں دیتا: کسٹمر کو دائرہ کار اور شرائط کی اجازت دینی ہوگی۔
صلاحیتیں، کنفیگر کردہ دائرہ کار اور اجازت کی درخواست متفق ہیں۔ اختیاری رسائی طلب کرنے سے گریز کریں جسے آپ کی ایپ کبھی استعمال نہیں کرتی یا تصدیق نہیں کر سکتی۔
آپ براؤزر پر مبنی JamZY تجربے کے لیے ایک ویب کلائنٹ بنائیں گے، صحیح تصدیقی طریقہ کے ساتھ۔
جہاں آپ کام کریں گے OAuth سیٹنگز → ویب
مختلف پلیٹ فارمز کے مختلف اسناد اور کال بیک قواعد ہوتے ہیں۔ یہ الگ الگ پروڈکٹس نہیں ہیں: سبسکرپشنز اور کسٹمر مینجمنٹ ایپلیکیشن کے لیے جمع کیے جاتے ہیں۔ ایپلیکیشن ٹیسٹرز پلیٹ فارمز کے درمیان شیئر کیے جاتے ہیں، زیادہ سے زیادہ پانچ جگہوں کے ساتھ بشمول زیر التواء دعوت نامے؛ مالک ٹیسٹر کی جگہ استعمال نہیں کرتا۔
بالکل ایک ویب پلیٹ فارم موجود ہے۔ مقامی پلیٹ فارمز جنہیں آپ نے کنفیگر نہیں کیا وہ آپ کے لانچ کو بلاک نہیں کرتے۔
آپ صارفین کو اجازت کے بعد اپنی ایپلیکیشن پر واپس لے جائیں گے، ایک درست کال بیک استعمال کرتے ہوئے جو آپ کے پاس ہے۔
جہاں آپ کام کریں گے ویب → کنفیگریشن
ویب → کنفیگریشن میں، درست HTTPS کال بیک رجسٹر کریں جو آپ کی ایپلیکیشن ہینڈل کرتی ہے۔ یہ گائیڈ استعمال کرتی ہے https://jamzy.example/oauth/callback بطور مثال۔ تبدیل کریں jamzy.example HTTPS ڈومین کے ساتھ جہاں آپ اپنی JamZY کی کاپی ڈیپلائے کرتے ہیں، اور وہی کال بیک اپنی ایپلیکیشن کنفیگریشن میں استعمال کریں۔
رضامندی اسکرین کا نام، شرائط، پرائیویسی اور حذف کرنے کی معلومات فراہم کریں۔ صرف وہی اسکوپس فعال کریں جن کی آپ کو ضرورت ہے، پھر محفوظ کریں۔ اسکیم، ہوسٹ، پاتھ اور متعلقہ کوئری تفصیلات اجازت کی درخواست اور کوڈ ایکسچینج سے مطابقت رکھنی چاہئیں۔ وائلڈ کارڈ یا URL فریگمنٹ استعمال نہ کریں۔
| پلیٹ فارم | کال بیک کو نافذ کریں |
|---|---|
| ویب | آپ کی ایپلیکیشن پر عین HTTPS پتہ۔ |
| اینڈرائیڈ | ایک ریورس-ڈومین ایپ اسکیم جو ایپلیکیشن آئی ڈی سے میل کھاتی ہو، یا ایک تصدیق شدہ HTTPS ایپ لنک جس میں پیکیج اور SHA-256 سائننگ فنگر پرنٹ شامل ہو۔ |
| iOS | ایک میل کھاتی ایپ اسکیم، یا ایک تصدیق شدہ HTTPS یونیورسل لنک جس میں بنڈل آئی ڈی اور ایپل ایپ آئی ڈی پری فکس شامل ہو۔ |
| ونڈوز / میک او ایس / لینکس | ایک اجازت شدہ عین HTTPS کال بیک، ایک میل کھاتی ریورس-ڈومین ایپلیکیشن اسکیم، یا 127.0.0.1 / [::1] پر ایک سپورٹڈ لوپ بیک ری ڈائریکٹ۔ لوپ بیک پورٹ مختلف ہو سکتا ہے۔ |
انسٹال شدہ ایپس سسٹم براؤزر میں اجازت دیتی ہیں اور رجسٹرڈ کال بیک کے ذریعے واپس آتی ہیں۔ دعوی کردہ HTTPS ایپ لنکس کے لیے، مطلوبہ ایسوسی ایشن فائل شائع کریں اور کنسول میں ایسوسی ایشن کی تصدیق چلائیں۔ ایک فارم میں قابل قبول نظر آنے والا کال بیک اس بات کا ثبوت نہیں ہے کہ آپ کی انسٹال شدہ ایپ اسے وصول کرتی ہے۔
اجازت کے فلو کے ذریعے کال بیک کھولنا آپ کی ایپ پر واپس آتا ہے۔ ایک بے ترتیب کوڈ یا غیر مطابقت پذیر اسٹیٹ مسترد کر دیا جاتا ہے۔
آپ کے پاس اپائنٹمنٹ انٹرفیس اور اس کا ShareAI کنکشن آپ کی اپنی ایپلیکیشن شناختوں کے ساتھ چل رہا ہوگا۔
جہاں آپ کام کریں گے آپ کی ایپلیکیشن → ماحول کی تشکیل
JamZY ایک اپائنٹمنٹ ایپلیکیشن ہے جس میں ایک اختیاری AI تیاری اسسٹنٹ شامل ہے۔ اس کا شیڈیولر صرف براؤزر پر مبنی ڈیمو ہے: اس میں کوئی کیلنڈر فراہم کنندہ، ای میل ڈیلیوری یا اپائنٹمنٹ ادائیگی شامل نہیں ہے۔ ShareAI اجازت اور AI API انٹیگریشن حقیقی ترتیب شدہ اپ اسٹریم استعمال کرتے ہیں۔
ڈاؤن لوڈ کریں JamZY حوالہ ذریعہ۔ اس میں نوڈ سرور، براؤزر UI، ٹیسٹس اور ایک سیٹ اپ README شامل ہے؛ کوئی سرٹیفکیٹس، راز، انحصار یا سیشنز شامل نہیں ہیں۔ انہیں چلانے سے پہلے فائلوں کا جائزہ لیں۔ نوڈ پروسیس کو ایک HTTPS ریورس پراکسی کے پیچھے رکھیں جو عوامی اصل کو محفوظ رکھے۔
# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs
# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjsاپنی ایپلیکیشن بنائیں کنسول.شیئرای.اب۔ اس کا پروڈکشن کلائنٹ آئی ڈی استعمال کریں https://auth.shareai.now اور https://api.shareai.now/api/v1۔ jamzy.example پتہ آپ کی ایپ کے لیے ایک پلیس ہولڈر ہے، کوئی ہوسٹڈ ڈیمو نہیں۔ اپنی ایپ کو HTTPS پر سرور کریں تاکہ اس کا محفوظ سیشن کوکی کام کرے۔
JamZY موازنہ کے لیے ایک API-کلید کنکشن بھی پیش کرتا ہے۔ یہ واک تھرو والیٹ/OAuth بٹن استعمال کرتا ہے۔ ایک API کلید کسٹمر کے JamZY OAuth معاہدے کو قائم نہیں کرتی اور کسٹمر اجازت فلو کے متبادل کے طور پر استعمال نہیں کی جا سکتی۔
ایپ HTTPS کے ذریعے لوڈ ہوتی ہے۔ اس کی عوامی اصل، رجسٹرڈ کال بیک اور کلائنٹ آئی ڈی آپ کی رجسٹریشن سے میل کھاتے ہیں۔ کوئی ٹوکن یا راز صفحہ کے ماخذ یا لوکل اسٹوریج میں ظاہر نہیں ہوتا۔
آپ کسٹمر کو ان کا ShareAI اکاؤنٹ منتخب کرنے دیں گے اور اس رسائی کی منظوری دیں گے جس کی آپ کی ایپ کو ضرورت ہے۔
جہاں آپ کام کریں گے JamZY → اپنے ShareAI والیٹ کے ساتھ ادائیگی کریں
JamZY سے، اپنے ShareAI والیٹ کے ساتھ ادائیگی کریں منتخب کریں۔ ایپ ShareAI اجازت صفحہ کھولتی ہے۔ کسٹمر سائن ان کرتا ہے، ایک ذاتی یا تنظیمی اکاؤنٹ منتخب کرتا ہے، ایپ اور درخواست کردہ رسائی کو چیک کرتا ہے، اور قابل اطلاق سبسکرپشن شرائط کو قبول کرتا ہے۔
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
client_id: clientId, response_type: 'code', redirect_uri: callback,
scope: 'openid profile inference monetization_gateway', state,
code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.مقامی صارف ریکارڈ کو تصدیق شدہ، client-scoped sub اور اس کے issuer/client سیاق و سباق کے ذریعے کلید کریں۔ ذاتی اور تنظیمی اجازتیں مختلف ادائیگی کرنے والے اکاؤنٹس منتخب کر سکتی ہیں۔ ایک صارف ID عالمی صارف ID، ای میل پتہ یا داخلی تنظیمی ڈیٹا بیس ID نہیں ہے۔ پلیٹ فارمز کے درمیان شناختوں کو ڈسپلے ناموں کے ملاپ سے ضم نہ کریں۔
منسوخی، غیر مطابقت پذیر حالت، دوبارہ استعمال شدہ کوڈ اور ختم شدہ اجازت محفوظ طریقے سے ناکام ہو جاتی ہیں۔ عام فلو ایک تصدیق شدہ اکاؤنٹ واپس کرتا ہے بغیر اس کے ٹوکنز کو ظاہر کیے۔
آپ ٹوکنز کی میعاد ختم ہونے کے دوران مجاز درخواستوں کو کام کرتے رہنے دیں گے، جبکہ صارف کو منسلک ہونے کا ایک قابل اعتماد طریقہ فراہم کریں گے۔
جہاں آپ کام کریں گے آپ کی ایپلیکیشن → سیشن اور ٹوکن ہینڈلنگ
| اسناد | مقصد | اسے کیسے ہینڈل کریں |
|---|---|---|
| اجازت کوڈ | اجازت صفحہ سے ایک بار کا حوالہ۔ | ایک بار تبدیل کریں، مماثل verifier اور کال بیک کا استعمال کرتے ہوئے۔ یہ API ٹوکن نہیں ہے۔ |
| رسائی ٹوکن | قبول شدہ گرانٹ اور اسکوپس کے اندر API کالز کو مجاز بناتا ہے۔ | بھیجیں جیسا کہ Authorization: Bearer …۔ میعاد ختم ہونے اور اینڈ پوائنٹ اجازت کی غلطیوں کا احترام کریں۔ |
| ریفریش ٹوکن | گرانٹ کے درست رہنے کے دوران دوبارہ سائن ان کیے بغیر متبادل رسائی ٹوکنز حاصل کرتا ہے۔ | محفوظ طریقے سے اسٹور کریں۔ ریفریش آپریشنز کو سیریلائز کریں اور گھومنے والی اسناد کو ایٹمی طور پر تبدیل کریں۔ |
| ID ٹوکن | کلائنٹ کے لیے ایک OpenID Connect شناختی تصدیق۔ | اگر آپ اسے استعمال کرتے ہیں، تو دستخط، issuer، audience، میعاد ختم ہونے اور nonce کو جیسا کہ قابل اطلاق ہو، درست کریں۔ اسے ایک استنباط Bearer ٹوکن کے طور پر استعمال نہ کریں۔ |
| کلائنٹ سیکریٹ | ایک مجاز خفیہ سرور کلائنٹ کی تصدیق کرتا ہے۔ | سرور پر اسٹور کریں۔ یہ تمام ٹوکنز سے مختلف ہے اور کبھی بھی عوامی کلائنٹ میں شامل نہیں ہوتا۔ |
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
--data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"واپس کردہ expires_in کی بجائے ایک مدت ایجاد کرنے کے استعمال کریں۔ اگر ریفریش ایک متبادل ریفریش ٹوکن واپس کرتا ہے، تو اسے نئے رسائی ٹوکن کے ساتھ ایک اپ ڈیٹ کے طور پر محفوظ کریں۔ فی سیشن ایک ریفریش کی اجازت دیں تاکہ ہم وقتی درخواستیں گھومنے والے ٹوکن کو دوبارہ استعمال نہ کریں۔ ایک غیر درست یا منسوخ شدہ ریفریش گرانٹ کو دوبارہ کنکشن کی ضرورت ہوتی ہے؛ غیر معینہ مدت کے لیے لوپ نہ کریں۔
ریفریشنگ کسی اسکوپ کو شامل نہیں کر سکتی یا خاموشی سے نئے Monetization Gateway معاہدے کو قبول نہیں کر سکتی۔ نئی اجازتوں یا شرائط کے لیے کسٹمر کو دوبارہ اجازت کے ذریعے بھیجیں۔ JamZY صرف ایک گھنٹے کے ڈیمو سیشن کے لیے سرور میموری میں اسناد کو ذخیرہ کرتا ہے، غیر تصدیق شدہ ID ٹوکن پر بھروسہ کرنے کے بجائے صارف کی معلومات کی تصدیق کرتا ہے، اور ایک محفوظ، HttpOnly، SameSite کوکی استعمال کرتا ہے۔ پروڈکشن سروس کو اپنی پائیدار، محفوظ سیشن ڈیزائن کی ضرورت ہوتی ہے۔
منقطع ہونے پر، جہاں قابل اطلاق ہو ریفریش/ایکسس اسناد کو منسوخ کریں اور ایپلیکیشن سیشن کو صاف کریں۔ صرف براؤزر کوکی کو صاف کرنا ShareAI گرانٹ کو منسوخ نہیں کرتا یا کسی ادا شدہ سبسکرپشن کو ختم نہیں کرتا۔ کوڈز، ٹوکنز، راز یا ذاتی پرامپٹ مواد کو لاگ کرنے سے گریز کریں۔
میعاد ختم ہونے پر ایک کنٹرولڈ ریفریش کو متحرک کرتا ہے؛ نئے ٹوکن پرانے ٹوکنز کی جگہ لے لیتے ہیں۔ منقطع ہونے پر ایپلیکیشن سیشن کو صاف کرتا ہے اور کسی بھی منسوخی کی ناکامی کی اطلاع دیتا ہے۔
آپ ایک ملاقات کے مقصد کو ایجنڈا اور مفید سوالات میں تبدیل کریں گے، ایک واضح کسٹمر فنڈڈ AI درخواست کے ساتھ۔
جہاں آپ کام کریں گے دستیاب ماڈلز → JamZY → تیار ہو کر آئیں
ایپلیکیشن میں دستیاب ماڈلز کھولیں۔ وہ ماڈلز اور فراہم کنندگان منتخب کریں جو آپ کی پروڈکٹ پیش کرے گی اور کنفیگریشن محفوظ کریں۔ اگر کیٹلاگ لوڈ نہیں ہو سکتا، تو آگے بڑھنے سے پہلے اپ اسٹریم دستیابی کی خرابی کو حل کریں؛ بار بار OAuth کلائنٹس کو تبدیل کرنا اسے ٹھیک نہیں کرے گا۔
JamZY اپنا کیٹلاگ صرف کنکشن کے بعد لوڈ کرتا ہے۔ ایک اجازت شدہ ٹیکسٹ ماڈل منتخب کریں، ایک مختصر ملاقات کا مقصد درج کریں اور جان بوجھ کر تیاری پیدا کرنے کا انتخاب کریں۔ منتخب کردہ اکاؤنٹ کو اہل کریڈٹس اور کسی بھی مطلوبہ قبول شدہ AI بلنگ شرائط کی ضرورت ہے۔ تاریخ کا انتخاب، ملاقات کا جائزہ لینا اور اسے محفوظ کرنا انفرینس درخواست نہیں بھیجتا۔
curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'ایک حقیقی شیڈولنگ پروڈکٹ کو سرور-سائیڈ بکنگ اسٹور، دستیابی چیک، ٹائم زون ہینڈلنگ، منسوخی کی پالیسی اور کیلنڈر یا نوٹیفکیشن انٹیگریشن کی ضرورت ہوتی ہے۔ یہ ShareAI اجازت سے الگ ہیں۔ AI آؤٹ پٹ کو ایک تجویز کے طور پر رکھیں؛ کسی بھی مستقبل کی بکنگ کارروائی کو اپنی ایپلیکیشن کے قواعد کے ذریعے تصدیق کریں۔
اجازت شدہ کیٹلاگ کے ذریعے واپس کیے گئے ماڈل سلگ کا استعمال کریں۔ اصل جواب کنٹریکٹ کو ہینڈل کریں: JamZY ShareAI کی نیٹو سپورٹ کرتا ہے۔ message.content لفافہ اور OpenAI-اسٹائل choices[0].message.content. HTTP 200 ایک نامکمل یا nested ایرر جواب کے ساتھ کامیاب جواب نہیں ہے۔
خرچ کی حد یا ناکافی کریڈٹ جواب پر، ایک مفید وضاحت اور فراہم کردہ کسٹمر بلنگ لنک دکھائیں۔ منتخب کردہ اکاؤنٹ کو محفوظ رکھیں۔ اس کی حد کو نظرانداز نہ کریں، خاموشی سے پےئر کو تبدیل نہ کریں یا چارج شدہ آپریشن کو لوپ میں دوبارہ کوشش نہ کریں۔
تیاری پیدا کریں ایک قابل استعمال ایجنڈا اور سوالات واپس کرتا ہے۔ درخواست مجاز کسٹمر اور ایپلیکیشن، منتخب کردہ ماڈل اور قبول شدہ شرائط سے منسوب ہے۔ AI ڈرافٹ اپائنٹمنٹ بک یا تبدیل نہیں کر سکتا۔
آپ اپنی اضافی AI فیس کو سبسکرپشن آفر میں وضاحت کریں گے اور وہ شرائط شائع کریں گے جنہیں کسٹمر قبول کر سکتے ہیں۔
جہاں آپ کام کریں گے ایپلیکیشن → سبسکرپشنز
اگر یہ پہلے سے متعلقہ انتظامی پالیسی کے ذریعہ منظور نہیں ہے تو ایپ کے استعمال کے کیسز کے ذریعے Monetization Gateway رسائی کی درخواست کریں۔ سوالنامہ مکمل کریں اور اس کی حیثیت پر عمل کریں۔ منظوری کنفیگریشن کو فعال کرتی ہے؛ کسٹمر کی اجازت اور بلنگ رضامندی الگ رہتی ہیں۔
صرف مثال: ایک 20% Builder مارک اپ پر €1.00 اہل نیٹ ورک لاگت کا اضافہ کرتا ہے €0.20۔ معیاری قیمتوں پر، ShareAI کا 5% فیس صرف اس €0.20 مارک اپ پر لاگو ہوتی ہے، کسی بھی بل ایبل ایونٹ انجیکشن سے پہلے۔ اصل حساب کے لیے لائیو تخمینہ کار اور قبول شدہ معاہدے کا استعمال کریں۔ اس فلو میں سبسکرپشن پیشکش ایک AI بلنگ معاہدہ ہے؛ اکاؤنٹ کنکشن اکیلے ایک مقررہ بار بار قیمت کو ڈیبٹ نہیں کرتا۔
surcharge سیٹ کریں۔ShareAI رضامندی اسکرین قبول شدہ شرائط کے لیے مستند ہے۔ JamZY کا عوامی کلائنٹ صارف کی معلومات سے قبول شدہ بلنگ پلان کا اندازہ نہیں لگا سکتا، اس لیے اس کا کنکشن پینل فعال سبسکرپشن کا دعویٰ نہیں کرتا یا ملاقات کے لیے قیمت ایجاد نہیں کرتا۔
پیشکش فیس کی وضاحت کرتی ہے؛ معاہدہ صارف کے ذریعہ قبول کیا جا سکتا ہے۔ آپ سمجھتے ہیں کہ کون سے صارفین پرانے شرائط پر رہتے ہیں اور کیوں۔
آپ حقیقی اینڈپوائنٹ اور اسکوپ چیک جمع کریں گے جو آپ کی درخواست کو جائزہ کے لیے جمع کرانے کے لیے ضروری ہیں۔
جہاں آپ کام کریں گے OAuth سیٹنگز → ٹیسٹرز اور تصدیق
OAuth سیٹنگز کھولیں → ٹیسٹرز اور پانچ ایپلیکیشن وسیع ٹیسٹرز کو مدعو کریں۔ زیر التواء دعوتیں ایک جگہ استعمال کرتی ہیں لیکن رسائی نہیں دیتی ہیں؛ وصول کنندہ کو قبول کرنا ہوگا۔ مالک رسائی اور مدعو ٹیسٹر رسائی عوامی پروڈکشن رسائی سے مختلف ہیں۔
ہر پلیٹ فارم کے لیے جسے آپ شائع کرنے کا ارادہ رکھتے ہیں، تصدیق کھولیں۔ مطلوبہ اینڈپوائنٹس اور ہر ترتیب شدہ اسکوپ کے لیے حقیقی کامیاب کالز مکمل کریں۔ دریافت اور سائننگ کیز چیک کریں؛ اجازت/کال بیک، کوڈ ایکسچینج، ریفریش، مستند صارف معلومات اور منسوخی کی جانچ کریں۔ خفیہ کلائنٹس کو قابل اطلاق انٹروسپیکشن کی بھی جانچ کرنی ہوگی۔ مقامی دعوی کردہ HTTPS لنکس کو ایسوسی ایشن تصدیق کی ضرورت ہوتی ہے۔
ایک پروفائل/ای میل اسکوپ کو اس کے اصل واپس کیے گئے دعووں کی ضرورت ہوتی ہے؛ ای میل کی ضرورت ہو تو ذاتی ٹیسٹ اکاؤنٹ استعمال کریں۔ inference اور monetization_gateway اسکوپس کو مکمل شدہ مجاز AI درخواست کی ضرورت ہوتی ہے۔ ادائیگیاں کامیاب اسکوپڈ پیمنٹ API کال کی ضرورت ہوتی ہیں۔ ایک عمومی کامیاب HTTP جواب، براؤزر اسکرین شاٹ یا دستی چیک لسٹ کنسول کے ریکارڈ شدہ چیکز کی جگہ نہیں لے سکتے۔
آپ کے پاس ایک نامکمل پلیٹ فارم کے لیے تین انتخاب ہیں: اسے مکمل کریں اور تصدیق کریں، اسے اشاعت سے خارج کریں تاکہ یہ صرف مالک/ٹیسٹر تک محدود رہے، یا اسے ہٹا دیں۔ کسی پلیٹ فارم کو شامل نہ کریں جس کے کال بیکس یا اسکوپس آپ نے استعمال نہیں کیے ہیں۔ کنفیگریشن میں تبدیلیاں چیک کو کالعدم کر سکتی ہیں، اس لیے اپنے آخری تبدیلیوں کے بعد ریکارڈ شدہ حیثیت کو تازہ کریں۔
ہر شامل پلیٹ فارم مکمل ترتیب، اینڈپوائنٹ اور اسکوپ چیک کے طور پر دکھاتا ہے۔ گائیڈ کی ذاتی چیک لسٹ صرف ایک پڑھنے میں مدد ہے۔
آپ جان لیں گے کہ جائزہ کے لیے کیا تیار ہے، اشاعت کیسے کام کرتی ہے اور بعد میں صارف رسائی کو کہاں فالو کریں۔
جہاں آپ کام کریں گے ایپلیکیشن → ڈیش بورڈ
لانچ کے بعد کسی اہل کسٹمر کے ساتھ پورے فلو کو دوبارہ آزمائیں: کنیکٹ کریں، اکاؤنٹ اور رضامندی کا معائنہ کریں، ایک مختصر ملاقات کی تیاری کا مسودہ تیار کریں، محفوظ طریقے سے ریفریش کریں، بلنگ کی ناکامی کو ہینڈل کریں، پھر ڈس کنیکٹ کریں۔ لائیو یوزر تجربے کی تصدیق کریں بجائے اس کے کہ یہ فرض کریں کہ کامیاب سیو ثابت کرتا ہے کہ یہ کام کرتا ہے۔
کال بیک کا عدم مطابقت: رجسٹرڈ URL اور دونوں درخواست کی قدروں کا بالکل موازنہ کریں۔ غیر مجاز ٹیسٹر: دعوت نامہ قبولیت اور منتخب کردہ اکاؤنٹ کی تصدیق کریں۔ دائرہ کار یا معاہدہ غائب: صرف فعال رسائی کی درخواست کریں اور اسے قبول کرنے کے لیے دوبارہ جڑیں۔ کوئی ماڈل نہیں: دستیاب ماڈلز اور فراہم کنندہ کی پابندیوں کا جائزہ لیں۔ ریفریش ناکامی: ناکام مقامی سیشن کو صاف کریں اور دوبارہ جڑیں۔ جائزہ بلاک کیا گیا: پلیٹ فارم چیک کا جائزہ لیں بجائے کہ ایک اور OAuth کلائنٹ بنائیں۔
ایپ مطلوبہ کسٹمر کے لیے کام کرتی ہے، ریکارڈ شدہ چیک اس کی اشاعت کی حالت کی حمایت کرتے ہیں، اور کسٹمر اجازت کو کنٹرول یا منسوخ کر سکتا ہے۔
پروگرام میں اندراج کے مالک کے طور پر ذاتی یا تنظیمی اکاؤنٹ منتخب کریں، درخواست دینے سے پہلے۔ تنظیمیں تصدیق سے پہلے درخواست جمع کرا سکتی ہیں، لیکن صرف عملے کی منظوری سے رسائی فعال نہیں ہوتی۔ کنسول میں آن بورڈنگ چیک لسٹ سے تنظیمی ای میل اور کمپنی کی تصدیق مکمل کریں۔ ایک منظور شدہ تنظیم تصدیق مکمل ہونے تک "Pending verification" رہتی ہے۔ Builder، Provider اور Creator پروگرامز اس اصول کی پیروی کرتے ہیں۔
Monetization Gateway قیمتیں دیکھیں · دریافت کریں ShareAI for Startups · اسکوپس اور اجازت نامے
آپ کی عوامی شرائط و ضوابط، پرائیویسی پالیسی اور حذف کرنے کی ہدایات درخواست سے مطابقت رکھنی چاہئیں اور بغیر سائن ان کے قابل رسائی رہنی چاہئیں۔ ShareAI پروگرام قبولیت، Monetization Gateway منظوری، کسٹمر کی OAuth اجازت اور قبول شدہ بلنگ معاہدہ الگ فیصلے ہیں۔ ریفریش اجازتیں شامل نہیں کر سکتا یا نئے تجارتی شرائط قبول نہیں کر سکتا۔
موجودہ انضمام کے لیے پرانی surcharge اسکوپ قبول کی جاتی ہے۔ نئے مثالیں monetization_gateway استعمال کرتی ہیں۔ موجودہ وائر فیلڈز جیسے surcharge_bps اور surcharge_percentage کو بغیر تبدیلی کے رکھیں۔
Monetization Gateway قیمتیں دیکھیں · دریافت کریں ShareAI for Startups · اسکوپس اور اجازت نامے
معیاری چارجز 5% Builder مارک اپ کے ہیں۔ AI نیٹ ورک لاگت کے €2.00 اور 10% مارک اپ کے لیے، صارف €2.20 ادا کرتا ہے۔ ShareAI €0.01 €0.20 مارک اپ کا وصول کرتا ہے؛ Builder کے پاس Event Ingestion سے پہلے €0.19 ہوتا ہے۔
پہلے 1,000 طے شدہ پروڈکشن Monetization Gateway درخواستیں ہر کیلنڈر مہینے (UTC) میں مفت ہیں، جو Builder اکاؤنٹ کے درمیان شیئر کی جاتی ہیں۔ اضافی درخواستوں کی قیمت €0.04 فی 1,000 ہے، اہل رعایتوں سے پہلے۔ ایک طے شدہ درخواست ایک ایونٹ تخلیق کرتی ہے۔
Pay with ShareAI بذات خود، صرف inference تک رسائی، عام اکاؤنٹ API کیز اور اسٹیجنگ یا ٹیسٹنگ ٹریفک Monetization Gateway Event Ingestion کو شامل نہیں کرتے۔
ShareAI for Startups منظور شدہ ایپلیکیشن پر اصل ShareAI فیس کے لیے مشترکہ ماہانہ الاؤنس فراہم کرتا ہے۔ موجودہ لانچ، گروتھ اور مومینٹم درجے €1,000, €5,000 اور €10,000 فی مہینہ فہرست کرتے ہیں۔ یہی بجٹ ShareAI کے فیصد فیس کو Builder مارک اپ اور بل ایبل ایونٹ انجیسیشن کے ساتھ کور کرتا ہے۔ یہ مجموعی مارک اپ الاؤنس، الگ مفت ایونٹ کوٹہ یا مفت AI inference نہیں ہے۔ اکاؤنٹ کے پہلے 1,000 مفت ایونٹس اسے استعمال نہیں کرتے۔
باقی ماندہ ایونٹ انجیسیشن فیس درخواست کے نئے Builder آمدنی سے ادا کی جاتی ہیں، پھر دستیاب Builder AI آمدنی اور غیر محدود AI کریڈٹس۔ کسٹمر AI چارجز اور پروڈکٹ payments الگ رہتے ہیں۔
ShareAI ایپلیکیشن مخصوص فیس یا فیس سپورٹ کو ایک مقررہ مدت کے لیے یا تبدیلی تک منظور کر سکتا ہے۔ کنسول میں ایپلیکیشن کی موجودہ قیمتوں اور اسپیشل پروگرامز کا جائزہ لیں تاکہ اس کے منظور شدہ شرائط، درستگی اور استعمال شدہ الاؤنس کو دیکھ سکیں۔ درجے کی تبدیلی یا قیمتوں کی اووررائیڈ ایپلیکیشن کے ماہانہ استعمال کو ری سیٹ نہیں کرتی۔
لانچ ShareAI کے ساتھ لاگ ان کو اختیاری رکھتا ہے۔ گروتھ اور مومینٹم اسے ضروری بناتے ہیں؛ مومینٹم کو ایپلیکیشن فوٹر میں آفیشل ShareAI for Startups بیج بھی ضروری ہے۔ ShareAI بیج کو ہفتہ وار چیک کرتا ہے۔ ضروریات کو بائی پاس کرنے کی تصدیق شدہ کوششیں ڈی موشن، اسٹارٹ اپ پروگرام سے ہٹانے یا مارکیٹ پلیس سے واپسی کا باعث بن سکتی ہیں، قبول شدہ پروگرام شرائط کے تحت۔
انٹرپرائز ریٹس ShareAI ٹیم کے ذریعے Builder اکاؤنٹ کے لیے ایک ذاتی پیشکش پر اتفاق کے بعد ترتیب دیے جاتے ہیں۔ تفویض کردہ فیصد اور ایونٹ ریٹ مستقبل کی درخواستوں پر لاگو ہوتے ہیں۔
Monetization Gateway قیمتیں دیکھیں · دریافت کریں ShareAI for Startups · اسکوپس اور اجازت نامے