پرسش‌های پرتکرار
پاسخ‌های کوتاه دربارهٔ کلیدها، ابزارک، پاسخ‌ها و راه‌اندازی.
یکی. کلید همراه اپ ساخته می‌شود و در تمام عمر اپ همان می‌ماند. برای کلید دوم، اپ دوم بسازید. کلیدهای API را ببینید.
در کنسول، صفحهٔ اپ، کارت «کلید API». هر وقت بخواهید می‌توانید از همان‌جا کپی‌اش کنید.
هنوز نه. اگر کلیدی لو رفت، با ما تماس بگیرید تا عوضش کنیم. امنیت را ببینید.
برای درخواست‌های سرور: در متغیر محیطی سرور یا یک ابزار نگهداری رمزها، و هیچ‌وقت در Git. برای ابزارک: کلید به هر حال عمومی است، پس متغیر سمت کاربر اشکالی ندارد؛ اما برایش یک اپ جدا بسازید.
بله: زبان، پوسته، رنگ اصلی، عنوان، زیرعنوان، پیام اول، متن دکمه، گوشه و فاصله. تنظیمات ابزارک را ببینید. CSS خودتان را نمی‌توانید اضافه کنید، چون گفت‌وگو داخل iframe اجرا می‌شود.
نه. هر گفت‌وگو تا وقتی صفحه باز است ادامه دارد. چیزی در مرورگر بازدیدکننده ذخیره نمی‌شود و بازدیدکننده‌ها گفت‌وگوهای هم را نمی‌بینند.
با یک گزینه نه. ابزارک همیشه از همهٔ اسناد آمادهٔ فضای کاری‌اش استفاده می‌کند. برای محدود کردنش، یک فضای کاری فقط با همان اسناد بسازید و ابزارک را به آن وصل کنید.
بله، برای هر ابزارک یکی. هر صفحه یک ابزارک نشان می‌دهد، پس در هر بخش سایتتان کد ابزارک جدایی با data-workspace-id متفاوت بگذارید.
هنوز نه؛ ابزارک رویداد یا callback ندارد. در حالت درون‌صفحه‌ای می‌توانید گفت‌وگو را با کد خودتان نشان دهید یا پنهان کنید. رویدادها و callbackها را ببینید.
عمداً. فقط از روی اسناد شما پاسخ می‌دهد تا پاسخی از خودش نسازد. اگر جواب سؤالی در اسناد نباشد، همین را می‌گوید.
هر پاسخ اسنادی را که به کار برده نام می‌برد و نشانه‌های شماره‌دار داخل متن، دقیقاً به همان بخش اشاره می‌کنند. ارجاع‌ها را ببینید.
متن‌های خود ابزارک فارسی و انگلیسی دارد (data-locale). پاسخ‌ها از روی اسناد شما نوشته می‌شوند، پس سؤال به زبان اسنادتان بهترین نتیجه را می‌دهد.
حسابی که مالک اپ است. هر پاسخ، مثل گفت‌وگو در کنسول، از اعتبار کم می‌شود. بازدیدکننده هیچ هزینه‌ای نمی‌دهد و پیامی دربارهٔ پرداخت نمی‌بیند.
برای ابزارک: ۲۰ سؤال در ساعت برای هر نشانی IP، ۵۰۰ سؤال در روز برای هر اپ، و ۶۰ بار بارگذاری در ساعت برای هر نشانی IP. REST API هنوز محدودیت تعداد درخواست ندارد. محدودیت‌ها و هزینه را ببینید.
دو اپ داشته باشید، هرکدام با کلید، فضای کاری و دامنه‌های مجاز خودش. شناسه‌ها را در متغیرهای محیطی بگذارید تا همان کد در هر دو کار کند.
بله. REST API زیر /v1 است. هر تغییری که کد شما را خراب کند، در نسخهٔ تازه می‌آید و این مستندات دربارهٔ /v1 است.