کاوش مشخصات OpenAPI
مشخصات محلی OpenAPI 3.0 با JSON یا YAML را ببینید و بدون ارسال درخواست نمونهٔ curl، JavaScript و Python آماده کنید.
فایل محلی OpenAPI با JSON یا YAML انتخاب کنید. عملیات را ببینید و بدون تماس با API توصیفشده، نمونهٔ کد آماده کنید.
بخشی از OpenAPI 3.0.x پشتیبانی میشود: ارجاع محلی، طرحوارهٔ پایهٔ شیء/آرایه/مقدار ساده، فیلد الزامی، allOf، oneOf، anyOf، nullable، مقادیر شمارشی و حدود رایج. Swagger 2 و OpenAPI 3.1+ رد میشوند. محدودیتها: ۲ مگابایت، ۵۰۰ عملیات، ۳۰٬۰۰۰ مقدار، ۵۰ سطح منبع و سه ثانیه برای هر وظیفه. نام مستعار YAML و برچسب سفارشی غیرفعالاند.
روش استفاده
OpenAPI 3.0.x با JSON/YAML را باز یا جایگذاری کنید. با جستوجو و برچسب فیلتر کنید و عملیات، پارامترها، طرحوارهٔ بدنه، پاسخها، احراز هویت و نکتهها را ببینید. سرور اعلامشده یا نشانی مطلق HTTP/HTTPS با جاینگهدارهای عوضشده انتخاب کنید. مقادیر و بدنه را تغییر دهید، رسانهٔ اعلامشده را برگزینید و برای اعتبارسنجی مقادیر پشتیبانیشده نمونه بسازید. خطاها و پنهانسازی را بازبینی و curl، JavaScript fetch، Python requests یا خلاصهٔ اصلی عملیات را کپی/دریافت کنید. صفحه درخواست API نمیفرستد و کد اجرا نمیکند.
مثال
مشخصات نمونهٔ خیالی را امتحان کنید. GET انتخاب و پارامترهای مسیر/پرسوجو را بازبینی و مقادیر نمونه را عوض کنید. همهٔ زبانها را بسازید و نشانی و جاینگهدار اطلاعات ورود را ببینید. برای عملیات دارای بدنه، رسانهٔ اعلامشده را عوض کنید تا مثال تازه شود. مقدار الزامی را خالی بگذارید تا خطای ترجمهشده را ببینید. سرور .invalid و نمونهها برای بررسیاند؛ چیزی ارسال نمیشود.
درباره این ابزار
فایلها روی دستگاه میمانند. بخشی محدود از OpenAPI 3.0.x پشتیبانی و Swagger 2 و OpenAPI 3.1+ رد میشود. محدودیتها: ۲ مگابایت UTF-8، ۵۰۰ عملیات، ۳۰٬۰۰۰ مقدار، ۵۰ سطح منبع و سه ثانیه برای هر وظیفه. نام مستعار YAML و برچسب سفارشی غیرفعالاند. فقط ارجاع محلی با حد چرخه/عمق حل میشود و دوردست بارگذاری نمیشود. شیء/آرایه/مقدار ساده، فیلد الزامی، allOf/oneOf/anyOf، nullable، مقادیر شمارشی و حدود رایج بررسی میشوند. قیدهای پشتیبانینشده و نمونههای بازگشتی بازبینی دستی میخواهند؛ یادداشت قالب کاملاً اعتبارسنجی نمیشود. کد مسیر/سربرگ ساده، پرسوجوی form یا deepObject تخت، کوکی ساده و بدنهٔ JSON، text/plain، URL-encoded یا multipart ساده را پشتیبانی میکند. تودرتویی، matrix/label، allowReserved، رمزگذاری سفارشی و رسانهٔ ناسازگار صریحاً خطا میدهد. بدنه تا ۵۰۰ کیلوبایت و پارامتر تا ۱۰٬۰۰۰ نویسه است. اطلاعات ورود درخواست یا ذخیره نمیشود. جاینگهدار اطلاعات/فایل و نخستین گزینهٔ امنیتی به کار میرود. پنهانسازی اسرار رایج، کوکی و نام کلید API اعلامشده را پوشش میدهد؛ سایر حساسیتها را پیش از اشتراک ببینید. جاینگهدار را عوض و کد را خودتان بررسی کنید. بررسی ساختار گواهی کامل انطباق یا آزمون سرور زنده نیست.