Skip to navigation

تغییرات نسخه‌ها

تا وقتی v1 در مرحله پیش‌انتشار است، شکل API هنوز ممکن است تغییر کند. بنر پیش‌انتشار همین را می‌گوید. هر تغییر اینجا ثبت می‌شود، تا دقیقاً ببینید چه چیزی جابه‌جا شده و تصمیم بگیرید آیا روی یکپارچه‌سازی شما اثر دارد یا نه.

۲۰۲۶-۰۹-۱۴: انتشار v1

اولین نسخه عمومی قرارداد. هرچه در ادامه آمده، تعهد اولیه است.

اندپوینت‌ها: ربات‌ها، کانال‌ها، قانون‌های خودکارسازی، رسانه، مصرف، و یک اندپوینت فقط‌خواندنی برای تنظیمات وب‌هوک.

رویدادهای وب‌هوک: message، message.generating، chat، reaction، is_typing.

تصمیم‌هایی که باید به آن‌ها توجه کرد، چون هر کدام چیزی را که می‌سازید تغییر می‌دهد:

تصمیمچرا
هیچ اندپوینتی برای نوشتن وب‌هوک وجود نداردکلید دزدیده‌شده نباید بتواند جریان رویدادهای شما را منحرف کند
توکن احراز هویت وب‌هوک را خودتان تعیین می‌کنیداین توکن فقط از اندپوینت خود شما محافظت می‌کند، پس منتظر ما ماندن فقط دردسر بود
محدودیت نرخ درخواست، درخواست‌ها را در صف می‌گذارد و هرگز دور نمی‌ریزدپاسخ خودکاری که دور ریخته شود، یعنی از دست رفتن گفتگو با مشتری
context_reset به معنای حذف نیستاگر آن را حذف فرض کنید، متن گفتگویی را دور می‌ریزید که ما هنوز نگه‌اش داشته‌ایم
follows_business: null به‌صورت باز (fail open) تفسیر می‌شودnull یعنی «Meta تأیید نکرد»، نه «دنبال نمی‌کند»
404 و نه 403 برای منابع دیگران403 وجود آن شناسه را تأیید می‌کرد

تغییرات چطور اعلام می‌شوند

تغییراز چه راهی باخبر می‌شوید
فیلد، رویداد یا اندپوینت جدیدهمین صفحه. ناسازگار نیست، پس هرچه را نمی‌شناسید نادیده بگیرید
حذف یا تغییر نام یک فیلدمدیر حساب شما، از قبل
فعال‌شدن یک مسیربنر پیش‌انتشار از آن صفحه برداشته می‌شود

برای قواعد کامل اینکه چه تغییری ناسازگار حساب می‌شود، نسخه‌بندی و پایداری را ببینید.