ساختن با SHAREAI
ساخت یک برنامه قرار ملاقات که مشتریان را به ShareAI متصل می‌کند، برنامه‌های مفید هوش مصنوعی آماده می‌کند و کنترل هزینه‌های هوش مصنوعی را به دست آنها می‌دهد.
تجربه‌ای که خواهید ساخت
JamZY · قرار ملاقاتهایک قرار ملاقات انتخاب کنید. ShareAI را متصل کنید. با یک برنامه وارد شوید.
پیاده‌سازی شما
سه تحویل ملموس: اتصال مشتری، آماده‌سازی قرار ملاقات آنها، و آماده‌سازی یکپارچه‌سازی برای تأیید.
یک مشتری حساب ShareAI خود را انتخاب می‌کند، برنامه شما را تأیید می‌کند و به JamZY بازمی‌گردد.
ورود، تازه‌سازی جلسه و قطع ارتباط با موفقیت انجام شود.
تبدیل هدف قرار ملاقات به یک برنامه و سوالات از طریق درخواست هوش مصنوعی هدفمند.
ایجاد یک پیش‌نویس؛ ذخیره یک قرار ملاقات هیچ تماس هوش مصنوعی ایجاد نمی‌کند.
توضیح هزینه‌های اختیاری هوش مصنوعی و جمع‌آوری بررسی‌های پلتفرم که ارسال بررسی شما نیاز دارد.
هر پلتفرم شامل شده و دامنه درخواست‌شده دارای بررسی‌های ثبت‌شده است.
آن را به ویرایشگر خود ببرید
راهنمای کامل را با هدف پیاده‌سازی، ورودی‌های مورد نیاز و بررسی‌های پذیرش کپی کنید. مثال‌های کد، جداول و لینک‌های مستندات را با هم نگه دارید.
آماده برای پروژه شما، در فرمت مورد نیاز شما.
به‌روزرسانی‌شده
شما یک ارتباطی ایجاد خواهید کرد که مشتریان شما می‌توانند آن را درک کنند: حساب ShareAI آنها، یک پیش‌نویس آماده‌سازی اختیاری هوش مصنوعی، و یک مسیر واضح برای بازگشت به قرار ملاقات آنها.
جایی که شما کار خواهید کرد مثال تکمیل‌شده شما
برنامه خود را به ShareAI Builder متصل کنید، از ثبت‌نام تا یکپارچه‌سازی آزمایش‌شده آماده برای بررسی. این راهنما از JamZY، یک برنامه کوچک قرار ملاقات Node.js، برای نشان دادن هر مرحله استفاده می‌کند: ثبت برنامه، پیکربندی پلتفرم وب آن، اتصال حساب ShareAI مشتری و ارسال یک درخواست هوش مصنوعی مجاز. همین مراحل را برای محصول خود اعمال کنید.
| قابلیت | آنچه مشتری با آن موافقت می‌کند | آنچه JamZY نشان می‌دهد |
|---|---|---|
| ورود با ShareAI | اتصال حساب و اطلاعات هویتی که برنامه شما درخواست می‌کند. | یک هویت خصوصی مشتری از اطلاعات کاربر احراز هویت‌شده. |
| پرداخت با ShareAI · استفاده از هوش مصنوعی | استفاده از حساب شخصی یا سازمانی انتخاب‌شده مشتری برای استنتاج مجاز. | یک پیش‌نویس آماده‌سازی قرار ملاقات که توسط اعتبارهای واجد شرایط آن حساب تأمین مالی شده است. |
| Builder مارک‌آپ | هزینه اضافی استفاده از هوش مصنوعی در قرارداد برنامه پذیرفته‌شده. | کسب درآمد اختیاری از استفاده، پس از تأیید و انتشار قرارداد. |
| پرداخت‌های محصول | یک خرید خاص که در یک ShareAI پرداخت جداگانه ارائه شده است. | یک افزونه که در راهنمای پرداختتوضیح داده شده است. دمو قرار ملاقات پرداخت را اجرا نمی‌کند. |
داشتن یک حساب ShareAI، مجوز استفاده از حساب شخصی یا سازمانی که مالک برنامه خواهد بود، یک callback عمومی HTTPS، یک لوگو، و صفحات حریم خصوصی، شرایط و حذف حساب کاربری فعال. برای اجرای مثال، از Node.js 22 یا جدیدتر و یک آدرس HTTPS برای برنامه خود استفاده کنید.
تصاویر صفحه از جزئیات برنامه نمونه استفاده می‌کنند. ShareAI آدرس‌های موجود در این راهنما آدرس‌های تولیدی هستند. تولید آماده‌سازی یک درخواست واقعی AI ایجاد می‌کند و ممکن است اعتبار مصرف کند؛ انتخاب یا ذخیره یک قرار ملاقات نمایشی این کار را انجام نمی‌دهد. بررسی‌های تأیید توسط آزمایش‌های موفقیت‌آمیز یکپارچه‌سازی شما تکمیل می‌شوند.
می‌توانید ورود به حساب کاربری، مصرف AI، هزینه اضافی اختیاری و خرید تأییدشده محصول را تشخیص دهید. خواندن این راهنما نیازی به درخواست پولی ندارد.
شما هویت Builder را ایجاد خواهید کرد که مالک برنامه و روابط مشتریان شما است.
جایی که شما کار خواهید کرد کنسول → برنامه Builder
Builder Program برای مالک مورد نظر باز می‌شود و گزینه New app را ارائه می‌دهد. تصمیم‌گیری برای ثبت‌نام، بررسی درخواست، بررسی اطلاعات عمومی و تأیید Monetization Gateway مراحل جداگانه‌ای هستند.
شما به JamZY رکورد برنامه خاص خود را می‌دهید، بنابراین هویت، دسترسی و شرایط تجاری آن با هم باقی می‌مانند.
جایی که شما کار خواهید کرد برنامه Builder → محصول → برنامه جدید
از یک وب‌سایت عمومی قابل دسترس برای پروفایل برنامه استفاده کنید. یک وب‌سایت خصوصی یا فقط محلی ممکن است حتی زمانی که callback توسعه شما به درستی ثبت شده باشد، در اعتبارسنجی شکست بخورد. برنامه جدید به‌صورت پیش‌نویس شروع می‌شود. شما می‌توانید بدون عمومی کردن آن، ویرایش را ادامه دهید. شناسه برنامه با شناسه مشتری OAuth یا شناسه اشتراک متفاوت است.
JamZY تحت محصول برای مالک مورد نظر ظاهر می‌شود. برای هر پلتفرم دستگاه یک برنامه اضافی ایجاد نکنید.
گزینه‌های OAuth را دریافت خواهید کرد که با جایی که برنامه شما اجرا می‌شود و اینکه چه کسی اعتبارنامه‌های آن را کنترل می‌کند، سازگار است.
جایی که شما کار خواهید کرد برنامه جدید → تنظیمات برنامه
برای یک JamZY استقراری که خودتان مدیریت می‌کنید، مدل قیمت‌گذاری‌ای را انتخاب کنید که با پیشنهاد شما مطابقت دارد، SaaS، برنامه ابری میزبانی‌شده توسط فروشنده، مشتری هزینه مصرف خود را پرداخت می‌کند، و ShareAI برای درخواست‌های AI. این‌ها پاسخ‌های نمونه هستند، نه الزامی برای هر محصول.
| جایی که برنامه اجرا می‌شود | انتخاب OAuth | جایی که اطلاعات هویتی ذخیره می‌شوند |
|---|---|---|
| بک‌اند میزبانی‌شده شما | کلاینت سرور وب ممکن است از یک کلید مخفی کلاینت استفاده کند. PKCE همچنان اعمال می‌شود. | کلید مخفی و توکن‌ها در سرور شما باقی می‌مانند. |
| برنامه مرورگر / SPA | کلاینت وب عمومی با PKCE. | بدون کلید مخفی کلاینت جاسازی‌شده. از طراحی مناسب مرورگر یا جلسه بک‌اند استفاده کنید. |
| توزیع خودمیزبان یا ترکیبی | کلاینت عمومی با PKCE تحت سیاست ورود اولیه. | کلید مخفی فروشنده مشترک را به نصب‌های مشتری توزیع نکنید. |
| ویندوز، macOS، لینوکس، اندروید یا iOS | یک کلاینت عمومی برای هر پلتفرم فعال‌شده. | PKCE و ذخیره‌سازی امن مناسب پلتفرم؛ بدون کلید مخفی بسته‌بندی‌شده. |
نمونه قابل دانلود JamZY عمداً از یک کلاینت وب عمومی با PKCE استفاده می‌کند، حتی اگر یک بک‌اند کوچک داشته باشد. سرور توکن‌ها را از ذخیره‌سازی مرورگر دور نگه می‌دارد. یک پاسخ میزبانی‌شده توسط فروشنده اجازه استفاده از کلاینت سرور را می‌دهد؛ اما شما را مجبور به انتخاب آن نمی‌کند.
می‌توانید پاسخ‌های ذخیره‌شده را تحت اطلاعات برنامه → تنظیمات برنامه بازبینی کنید. تغییرات استقرار ممکن است کلیدهای مخفی کلاینت ناسازگار را حذف کرده و نیاز به تأیید مجدد داشته باشند. قبل از ذخیره، تأثیر آن را بررسی کنید.
استقرار ذخیره‌شده معماری واقعی شما را توصیف می‌کند. گزینه کلید مخفی کلاینت از آن پاسخ پیروی می‌کند؛ یک گزینه غیرفعال توضیحی از سیاست است، نه یک اطلاعات هویتی گم‌شده.
شما جزئیات محصول و سیاست‌هایی که مشتریان برای تصمیم‌گیری در مورد اتصال نیاز دارند را ارائه خواهید داد.
جایی که شما کار خواهید کرد اطلاعات برنامه
پس از داشبورد، اطلاعات برنامه را باز کنید. بخش‌های اختصاصی را مرور کنید: جزئیات، تنظیمات برنامه، ارائه، برندینگ، گالری و بازبینی. توضیح مفیدی برای محصول ارائه دهید، یک وب‌سایت دقیق و اسکرین‌شات‌های واضح از جریان کاری مشتری ارائه کنید.
از هویت برنامه خود استفاده کنید. برندینگ ShareAI باید روی دکمه یکپارچه‌سازی و مواد توضیحی باشد؛ نباید جایگزین لوگوی محصول شما شود. پیوندهای حریم خصوصی، شرایط و حذف باید بدون نیاز به ورود به سیستم قابل دسترسی باشند.
تغییرات را زمانی که عمل ذخیره شناور ظاهر می‌شود، ذخیره کنید. پیشنهاد اطلاعات عمومی بازبینی خود را دارد؛ ویرایش یک پیشنهاد تأییدشده به‌طور خاموش جایگزین ارائه عمومی زنده نمی‌شود.
یک بازدیدکننده می‌تواند بفهمد که JamZY چه کاری انجام می‌دهد، چه کسی آن را اجرا می‌کند و چگونه درخواست حذف کند. جزئیات عمومی و پیکربندی بازگشت به همان محصول اشاره دارند.
شما دسترسی‌هایی را که تجربه قرار ملاقات شما واقعاً استفاده می‌کند درخواست خواهید کرد و هدف صورتحساب آن را به وضوح مشخص خواهید کرد.
جایی که شما کار خواهید کرد برنامه → موارد استفاده
در موارد استفاده، Login with ShareAI را برای اتصال حساب و Pay with ShareAI را برای جریان تأمین مالی مشتری که قصد پشتیبانی از آن را دارید فعال کنید. دسترسی به Monetization Gateway را فقط در صورتی درخواست کنید که محصول شما هزینه اضافی برای استفاده از AI کسب کند. وضعیت تأیید را که در Console نمایش داده می‌شود دنبال کنید.
| دامنه | چرا ممکن است آن را درخواست کنید |
|---|---|
openid | یک حساب را با استفاده از هویت محدود به کلاینت آن متصل کنید. |
profile / email | درخواست ادعاهای پروفایل یا ایمیل را فقط در صورتی انجام دهید که محصول شما به آنها نیاز داشته باشد. |
inference | نقاط پایانی استنتاج AI پشتیبانی شده را زمانی که توسط تنظیمات برنامه مجاز است، فراخوانی کنید. |
monetization_gateway | از توافق‌نامه صورتحساب AI که توسط مشتری برای استنتاج با هزینه اضافی پذیرفته شده است استفاده کنید. |
payments | درخواست‌های پرداخت مشتری را ایجاد و بررسی کنید. هر خرید همچنان نیاز به تأیید دارد. |
درخواست‌های JamZY openid profile inference monetization_gateway. این درخواست نمی‌کند payments و از طریق پرداخت محصولی را نمی‌فروشد. فعال کردن یک قابلیت در Console آن را به یک توکن دسترسی موجود اعطا نمی‌کند: مشتری باید محدوده‌ها و شرایط را تأیید کند.
قابلیت‌ها، محدوده‌های پیکربندی شده و درخواست مجوز با یکدیگر مطابقت دارند. از درخواست دسترسی اختیاری که برنامه شما هرگز استفاده نمی‌کند یا نمی‌تواند تأیید کند، خودداری کنید.
شما یک کلاینت وب برای تجربه مبتنی بر مرورگر JamZY ایجاد خواهید کرد، با روش احراز هویت مناسب.
جایی که شما کار خواهید کرد تنظیمات OAuth → وب
پلتفرم‌های مختلف دارای اعتبارنامه‌ها و قوانین بازگشت متفاوتی هستند. آنها محصولات جداگانه‌ای نیستند: اشتراک‌ها و مدیریت مشتری برای برنامه تجمیع شده‌اند. آزمایش‌کنندگان برنامه در پلتفرم‌ها به اشتراک گذاشته می‌شوند، با حداکثر پنج مکان شامل دعوت‌نامه‌های در انتظار؛ مالک یک مکان آزمایش‌کننده را مصرف نمی‌کند.
دقیقاً یک پلتفرم وب وجود دارد. پلتفرم‌های بومی که پیکربندی نکرده‌اید، راه‌اندازی شما را مسدود نمی‌کنند.
شما مشتریان را پس از تأیید به برنامه خود بازمی‌گردانید، با استفاده از یک callback دقیق که مالک آن هستید.
جایی که شما کار خواهید کرد وب → پیکربندی
در وب → پیکربندی، callback دقیق HTTPS که برنامه شما مدیریت می‌کند را ثبت کنید. این راهنما از https://jamzy.example/oauth/callback به عنوان یک مثال استفاده می‌کند. جایگزین کنید jamzy.example با دامنه HTTPS که نسخه خود از JamZY را در آن مستقر می‌کنید، و از همان callback در پیکربندی برنامه خود استفاده کنید.
نام صفحه تأیید، شرایط، اطلاعات حریم خصوصی و حذف را ارائه دهید. فقط محدوده‌هایی که نیاز دارید را فعال کنید، سپس ذخیره کنید. طرح، میزبان، مسیر و جزئیات پرس‌وجوی قابل اعمال باید با درخواست تأیید و تبادل کد مطابقت داشته باشد. از wildcard یا fragment URL استفاده نکنید.
| پلتفرم ایجاد/چرخش دهید | بازگشتی برای پیاده‌سازی |
|---|---|
| وب | آدرس دقیق HTTPS در برنامه شما. |
| اندروید | یک طرح برنامه معکوس-دامنه که با شناسه برنامه مطابقت دارد، یا یک لینک HTTPS تأییدشده برنامه با بسته و اثر انگشت امضای SHA-256. |
| iOS | یک طرح برنامه مطابقت‌دهنده، یا یک لینک HTTPS یونیورسال تأییدشده با شناسه بسته و پیشوند شناسه برنامه Apple. |
| ویندوز / macOS / لینوکس | یک بازگشت دقیق HTTPS مجاز، یک طرح برنامه معکوس-دامنه مطابقت‌دهنده، یا یک بازگشت حلقه‌ای پشتیبانی‌شده روی 127.0.0.1 / [::1]. پورت حلقه‌ای می‌تواند متغیر باشد. |
برنامه‌های نصب‌شده در مرورگر سیستم مجاز می‌شوند و از طریق بازگشت ثبت‌شده بازمی‌گردند. برای لینک‌های HTTPS ادعاشده برنامه، فایل ارتباط موردنیاز را منتشر کنید و تأیید ارتباط را در کنسول اجرا کنید. بازگشتی که در یک فرم منطقی به نظر می‌رسد، اثباتی نیست که برنامه نصب‌شده شما آن را دریافت می‌کند.
باز کردن بازگشت از طریق جریان مجوز به برنامه شما بازمی‌گردد. یک کد تصادفی یا وضعیت ناسازگار رد می‌شود.
شما رابط قرار ملاقات و اتصال ShareAI آن را با شناسه‌های برنامه خودتان اجرا خواهید کرد.
جایی که شما کار خواهید کرد برنامه شما → پیکربندی محیط
JamZY یک برنامه قرار ملاقات با یک دستیار آماده‌سازی AI اختیاری است. زمان‌بندی‌کننده آن فقط یک نمایش مرورگر است: هیچ ارائه‌دهنده تقویم، ارسال ایمیل یا پرداخت قرار ملاقات وجود ندارد. ادغام مجوز ShareAI و API AI از بالادست واقعی پیکربندی‌شده استفاده می‌کند.
دانلود کنید مرجع منبع JamZY. این شامل سرور Node، رابط کاربری مرورگر، تست‌ها و یک README راه‌اندازی است؛ بدون گواهینامه‌ها، اسرار، وابستگی‌ها یا نشست‌ها. فایل‌ها را قبل از اجرای آنها بررسی کنید. فرآیند Node را پشت یک پروکسی معکوس 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برنامه خود را در کنسول.shareai.nowایجاد کنید. از شناسه مشتری تولیدی آن استفاده کنید با https://auth.shareai.now و https://api.shareai.now/api/v1. آدرس jamzy.example یک جایگزین برای برنامه شما است، نه یک نمایش میزبانی‌شده. برنامه خود را از طریق HTTPS ارائه دهید تا کوکی جلسه امن آن کار کند.
JamZY همچنین یک اتصال کلید API برای مقایسه ارائه می‌دهد. این راهنما از دکمه کیف پول/OAuth استفاده می‌کند. یک کلید API توافق OAuth مشتری JamZY را ایجاد نمی‌کند و جایگزینی برای جریان مجوز مشتری نیست.
برنامه از طریق HTTPS بارگذاری می‌شود. منبع عمومی آن، بازگشت ثبت‌شده و شناسه مشتری با ثبت‌نام شما مطابقت دارد. هیچ توکن یا رازی در منبع صفحه یا localStorage ظاهر نمی‌شود.
شما به مشتری اجازه می‌دهید حساب 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.رکورد مشتری محلی را با هویت احراز شده، محدود به کلاینت sub و زمینه صادرکننده/کلاینت آن کلید کنید. احراز هویت‌های شخصی و سازمانی می‌توانند حساب‌های پرداختی مختلفی را انتخاب کنند. یک شناسه مشتری، شناسه کاربر جهانی، آدرس ایمیل یا شناسه پایگاه داده داخلی سازمان نیست. هویت‌ها را در پلتفرم‌ها با تطبیق نام‌های نمایشی ادغام نکنید.
لغو، state نامطابق، کد بازپخش‌شده و احراز هویت منقضی به‌صورت ایمن شکست می‌خورند. جریان عادی یک حساب احراز شده را بدون افشای توکن‌های آن بازمی‌گرداند.
شما درخواست‌های مجاز را در حالی که توکن‌ها منقضی می‌شوند، فعال نگه می‌دارید و در عین حال راهی قابل‌اعتماد برای قطع ارتباط به مشتری ارائه می‌دهید.
جایی که شما کار خواهید کرد برنامه شما → مدیریت جلسه و توکن
| اعتبارنامه | هدف | نحوه مدیریت آن |
|---|---|---|
| کد احراز هویت | انتقال یک‌باره از صفحه احراز هویت. | یک‌بار مبادله کنید، با استفاده از verifier و callback مطابق. این یک توکن API نیست. |
| توکن دسترسی | تماس‌های API را در محدوده مجوز و دسترسی‌های پذیرفته‌شده مجاز می‌کند. | ارسال به‌عنوان Authorization: Bearer …. به انقضا و خطاهای مجوز نقطه پایانی احترام بگذارید. |
| توکن بازنشانی | توکن‌های دسترسی جایگزین را بدون ورود مجدد تا زمانی که مجوز معتبر است، دریافت می‌کند. | به‌صورت ایمن ذخیره کنید. عملیات بازنشانی را سریال‌سازی کرده و اعتبارنامه‌های چرخشی را به‌صورت اتمی جایگزین کنید. |
| توکن شناسه | یک تأیید هویت OpenID Connect برای کلاینت. | اگر از آن استفاده می‌کنید، امضا، صادرکننده، مخاطب، انقضا و 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 تأیید نشده، و از یک کوکی Secure، 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 را به عنوان یک پیشنهاد نگه دارید؛ هر اقدام رزرو آینده را از طریق قوانین برنامه خود تأیید کنید.
از یک مدل slug که توسط کاتالوگ مجاز بازگردانده شده استفاده کنید. قرارداد پاسخ واقعی را مدیریت کنید: JamZY از ShareAI بومی پشتیبانی می‌کند message.content پاکت و سبک OpenAI choices[0].message.content. HTTP 200 با یک پاسخ خطای ناقص یا تو در تو یک پاسخ موفقیت‌آمیز نیست.
در پاسخ محدودیت هزینه یا اعتبار ناکافی، توضیح مفیدی و لینک صورتحساب مشتری ارائه شده را نمایش دهید. حساب انتخاب شده را حفظ کنید. محدودیت آن را دور نزنید، پرداخت‌کننده را به‌طور مخفیانه تغییر ندهید یا یک عملیات شارژ شده را در یک حلقه دوباره امتحان نکنید.
بازگشت آماده‌سازی یک دستور کار و سوالات قابل استفاده تولید می‌کند. درخواست به مشتری و برنامه مجاز، با مدل انتخاب شده و شرایط پذیرفته شده نسبت داده می‌شود. پیش‌نویس 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، اسکرین‌شات مرورگر یا چک‌لیست دستی جایگزین بررسی‌های ثبت‌شده در Console نمی‌شود.
شما سه انتخاب برای یک پلتفرم ناتمام دارید: آن را کامل کنید و تأیید کنید، آن را از انتشار حذف کنید تا فقط مالک/آزمایش‌کننده باقی بماند، یا آن را حذف کنید. یک پلتفرم با بازگشت‌ها یا دامنه‌هایی که اجرا نکرده‌اید را شامل نکنید. تغییرات پیکربندی می‌توانند بررسی‌ها را باطل کنند، بنابراین وضعیت ثبت‌شده را پس از تغییرات نهایی خود تازه‌سازی کنید.
هر پلتفرم شامل‌شده بررسی‌های پیکربندی، نقطه پایانی و دامنه مورد نیاز را به عنوان کامل نشان می‌دهد. چک‌لیست شخصی راهنما فقط یک کمک خواندن است.
شما خواهید دانست که چه چیزی آماده بررسی است، چگونه انتشار کار می‌کند و کجا دسترسی مشتری را پس از آن دنبال کنید.
جایی که شما کار خواهید کرد برنامه → داشبورد
کل جریان را دوباره با یک مشتری واجد شرایط پس از راه‌اندازی امتحان کنید: اتصال، بررسی حساب و رضایت، ایجاد پیش‌نویس کوتاه آماده‌سازی قرار ملاقات، تازه‌سازی ایمن، مدیریت شکست صورتحساب، سپس قطع اتصال. تجربه کاربر زنده را تأیید کنید به جای اینکه فرض کنید ذخیره موفقیت‌آمیز ثابت می‌کند که کار می‌کند.
عدم تطابق Callback: URL ثبت‌شده و هر دو مقدار درخواست را دقیقاً مقایسه کنید. آزمایش‌کننده غیرمجاز: تأیید پذیرش دعوت و حساب انتخاب‌شده. محدوده یا قرارداد گم‌شده: فقط دسترسی فعال درخواست کنید و برای پذیرش دوباره متصل شوید. بدون مدل‌ها: مدل‌های موجود و محدودیت‌های ارائه‌دهنده را بررسی کنید. شکست در تازه‌سازی: جلسه محلی شکست‌خورده را پاک کنید و دوباره متصل شوید. بررسی مسدود شده: بررسی‌های پلتفرم را بررسی کنید به‌جای ایجاد یک کلاینت OAuth دیگر.
برنامه برای مشتری موردنظر کار می‌کند، بررسی‌های ثبت‌شده از وضعیت انتشار آن پشتیبانی می‌کنند، و مشتری می‌تواند مجوز را کنترل یا لغو کند.
حساب شخصی یا سازمانی را انتخاب کنید که مالک ثبت‌نام برنامه خواهد بود قبل از درخواست. سازمان‌ها می‌توانند درخواست را قبل از تأیید ارسال کنند، اما تأیید کارکنان به تنهایی دسترسی را فعال نمی‌کند. تأیید ایمیل سازمان و شرکت را از چک‌لیست شروع در Console تکمیل کنید. یک سازمان تأیید شده تا زمانی که هر دو بررسی کامل نشوند، در حالت انتظار تأیید باقی می‌ماند. 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 مارک‌آپ. برای €2.00 هزینه شبکه AI و یک 10% مارک‌آپ، مشتری €2.20 پرداخت می‌کند. ShareAI دریافت می‌کند €0.01 از €0.20 مارک‌آپ؛ Builder دارای €0.19 قبل از دریافت رویداد است.
اولین 1,000 درخواست‌های تولیدی تسویه‌شده Monetization Gateway هر ماه تقویمی (UTC) رایگان هستند و در حساب Builder به اشتراک گذاشته می‌شوند. درخواست‌های اضافی هزینه €0.04 به ازای هر 1,000 قبل از تخفیف‌های واجد شرایط دارند. یک درخواست تسویه‌شده یک رویداد ایجاد می‌کند.
Pay with ShareAI به تنهایی، دسترسی فقط به inference، کلیدهای API حساب عادی و ترافیک مرحله‌بندی یا آزمایشی هزینه دریافت رویداد Monetization Gateway را شامل نمی‌شوند.
ShareAI for Startups یک بودجه ماهانه مشترک برای هزینه‌های واقعی ShareAI در یک اپلیکیشن تأییدشده ارائه می‌دهد. سطوح فعلی Launch، Growth و Momentum به ترتیب €1,000، €5,000 و €10,000 در ماه را فهرست می‌کنند. همان بودجه هزینه درصدی ShareAI روی Builder مارک‌آپ و Event Ingestion قابل‌صورتحساب را با هم پوشش می‌دهد. این بودجه مارک‌آپ ناخالص، سهمیه رویداد رایگان جداگانه یا AI رایگان inference نیست. اولین 1,000 رویداد رایگان حساب آن را مصرف نمی‌کند.
هزینه‌های باقی‌مانده‌ی Event Ingestion از درآمد جدید درخواست Builder پرداخت می‌شوند، سپس از درآمدهای AI موجود Builder و اعتبارهای AI نامحدود. هزینه‌های AI مشتری و محصول payments جدا باقی می‌مانند.
ShareAI می‌تواند هزینه‌های خاص اپلیکیشن یا پشتیبانی هزینه را برای یک دوره ثابت یا تا زمان تغییر تأیید کند. شرایط تأییدشده، اعتبار و بودجه مصرف‌شده اپلیکیشن را در Console بررسی کنید. تغییر سطح یا بازنویسی قیمت، استفاده ماهانه اپلیکیشن را بازنشانی نمی‌کند.
Launch ورود با ShareAI را اختیاری نگه می‌دارد. Growth و Momentum آن را الزامی می‌کنند؛ Momentum همچنین نشان رسمی ShareAI for Startups را در فوتر اپلیکیشن نیاز دارد. ShareAI نشان را به‌صورت هفتگی بررسی می‌کند. تلاش‌های تأییدشده برای دور زدن الزامات می‌تواند منجر به کاهش سطح، حذف از برنامه Startup یا خروج از Marketplace تحت شرایط پذیرفته‌شده برنامه شود.
نرخ‌های سازمانی توسط تیم ShareAI برای حساب Builder پس از توافق بر پیشنهاد شخصی‌سازی‌شده تنظیم می‌شوند. درصد اختصاص داده‌شده و نرخ رویداد برای درخواست‌های آینده اعمال می‌شوند.
مشاهده قیمت‌گذاری Monetization Gateway · کاوش کنید ShareAI for Startups · محدوده‌ها و مجوزها