.\" This file is auto-generated from the parser declaration in httpie/cli/definition.py by extras/scripts/generate_man_pages.py. .TH https 1 "2024-07-10" "HTTPie 3.2.4" "HTTPie Manual" .SH "نام (NAME)" https \- کلاینت HTTP خط فرمانی مدرن و کاربرپسند برای عصر APIها .SH "خلاصه دستور (SYNOPSIS)" https [METHOD] URL [REQUEST_ITEM ...] .SH "توضیحات (DESCRIPTION)" HTTPie: کلاینت HTTP خط فرمانی مدرن و کاربرپسند برای عصر APIها. .SH "آرگومان‌های ترتیبی (Positional arguments)" این آرگومان‌ها پس از هر پرچمی و به ترتیبی که در اینجا فهرست شده‌اند می‌آیند. تنها وارد کردن URL الزامی است. .IP "\fB\,METHOD\/\fR" متد HTTP مورد استفاده برای درخواست (GET، POST، PUT، DELETE، ...). این آرگومان می‌تواند نادیده گرفته شود؛ در این صورت اگر داده‌ای برای ارسال وجود داشته باشد HTTPie از POST استفاده خواهد کرد، در غیر این صورت از GET: $ http example.org # => GET $ http example.org hello=world # => POST .IP "\fB\,URL\/\fR" آدرس URL درخواست. در صورتی که URL فاقد طرحواره (scheme) باشد، پیش‌فرض آن \[aq]http://\[aq] است. (می‌توانید با این گزینه آن را بازنویسی کنید: \fB\,--default-scheme\/\fR=http/https) همچنین می‌توانید از کوته‌نوشت برای localhost استفاده کنید $ http :3000 # => http://localhost:3000 $ http :/foo # => http://localhost/foo .IP "\fB\,REQUEST_ITEM\/\fR" جفت‌های کلید-مقدار اختیاری برای گنجانده شدن در درخواست. جداکنندهٔ استفاده‌شده نوع را تعیین می‌کند: \[aq]:\[aq] سرآیندهای HTTP: Referer:https://httpie.io Cookie:foo=bar User-Agent:bacon/1.0 \[aq]==\[aq] پارامترهای URL برای افزوده شدن به URI درخواست: search==httpie \[aq]=\[aq] فیلدهای داده برای سریال‌سازی به یک شیء JSON (با \fB\,--json\/\fR، \fB\,-j\/\fR) یا داده‌های فرم (با \fB\,--form\/\fR، \fB\,-f\/\fR): name=HTTPie language=Python description=\[aq]CLI HTTP client\[aq] \[aq]:=\[aq] فیلدهای دادهٔ غیررشته‌ای JSON (تنها با \fB\,--json\/\fR، \fB\,-j\/\fR): awesome:=true amount:=42 colors:=\[aq][\[dq]red\[dq], \[dq]green\[dq], \[dq]blue\[dq]]\[aq] \[aq]@\[aq] فیلدهای فایل فرم (تنها با \fB\,--form\/\fR یا \fB\,--multipart\/\fR): cv@\(ti/Documents/CV.pdf cv@\[aq]\(ti/Documents/CV.pdf;type=application/pdf\[aq] \[aq]=@\[aq] یک فیلد داده مانند \[aq]=\[aq]، اما یک مسیر فایل دریافت می‌کند و محتوای آن را درج می‌نماید: essay=@Documents/essay.txt \[aq]:=@\[aq] یک فیلد خام JSON مانند \[aq]:=\[aq]، اما یک مسیر فایل دریافت می‌کند و محتوای آن را درج می‌نماید: package:=@./package.json می‌توانید از یک بک‌اسلش برای گریز دادن (escape) جداکننده‌ای که با نام فیلد تداخل دارد استفاده کنید: field-name-with\e:colon=value .PP .SH "انواع محتوای از پیش تعریف‌شده (Predefined content types)" .IP "\fB\,--json\/\fR, \fB\,-j\/\fR" (پیش‌فرض) آیتم‌های داده از خط فرمان به عنوان یک شیء JSON سریال‌سازی می‌شوند. سرآیندهای Content-Type و Accept روی application/json تنظیم می‌شوند (در صورت عدم تعیین). .IP "\fB\,--form\/\fR, \fB\,-f\/\fR" آیتم‌های داده از خط فرمان به عنوان فیلدهای فرم سریال‌سازی می‌شوند. سرآیند Content-Type روی application/x-www-form-urlencoded تنظیم می‌شود (در صورت عدم تعیین). وجود هرگونه فیلد فایل منجر به یک درخواست multipart/form-data خواهد شد. .IP "\fB\,--multipart\/\fR" مشابه \fB\,--form\/\fR، اما همیشه یک درخواست multipart/form-data ارسال می‌کند (یعنی حتی بدون فایل‌ها). .IP "\fB\,--boundary\/\fR" تعیین یک رشته مرزبندی سفارشی برای درخواست‌های multipart/form-data. تنها همراه با \fB\,--form\/\fR اثرگذار است. .IP "\fB\,--raw\/\fR" این گزینه به شما اجازه می‌دهد داده‌های خام درخواست را بدون پردازش اضافی ارسال کنید (برخلاف نحو ساختاریافتهٔ آیتم‌های درخواست): $ http \fB\,--raw\/\fR=\[aq]data\[aq] pie.dev/post می‌توانید با هدایت داده از طریق stdin نیز به همین نتیجه برسید: $ echo data | http pie.dev/post یا ترتیبی دهید که HTTPie داده‌های خام را از یک فایل بارگذاری کند: $ http pie.dev/post @data.txt .PP.SH "گزینه‌های پردازش محتوا (CONTENT PROCESSING OPTIONS)" .IP "\fB\,--compress\/\fR, \fB\,-x\/\fR" محتوا با الگوریتم Deflate فشرده‌سازی (کدگذاری) می‌شود. سرآیند Content-Encoding بر روی deflate تنظیم می‌گردد. اگر به نظر برسد که نسبت فشرده‌سازی منفی است، از فشرده‌سازی صرف‌نظر می‌شود. با تکرار این آرگومان می‌توان فشرده‌سازی را اجباری کرد. .PP .SH "پردازش خروجی (OUTPUT PROCESSING)" .IP "\fB\,--pretty\/\fR" پردازش خروجی را کنترل می‌کند. مقدار می‌تواند \[dq]none\[dq] برای زیباسازی نکردن خروجی (پیش‌فرض برای خروجی تغییرمسیرداده‌شده)، \[dq]all\[dq] برای اعمال هم‌زمان رنگ‌ها و قالب‌بندی (پیش‌فرض برای خروجی ترمینال)، \[dq]colors\[dq] یا \[dq]format\[dq] باشد. .IP "\fB\,--style\/\fR, \fB\,-s\/\fR \fI\,STYLE\/\fR" سبک رنگ‌آمیزی خروجی (پیش‌فرض \[dq]auto\[dq] است). می‌تواند یکی از موارد زیر باشد: auto, pie, pie-dark, pie-light, solarized برای مشاهده تمام سبک‌های موجود در سیستم خود، این دستور را امتحان کنید: $ http \fB\,--style\/\fR سبک \[dq]auto\[dq] از سبک‌های رنگ ANSI ترمینال شما پیروی می‌کند. برای اینکه سبک‌های غیر از auto به درستی کار کنند، لطفاً مطمئن شوید که متغیر محیطی $TERM روی \[dq]xterm-256color\[dq] یا مشابه آن تنظیم شده باشد (برای نمونه، از طریق `export TERM=xterm-256color\[aq] در \(ti/.bashrc خود). .IP "\fB\,--unsorted\/\fR" غیرفعال کردن تمام مرتب‌سازی‌ها هنگام قالب‌بندی خروجی. این گزینه یک میان‌بر است برای: \fB\,--format-options\/\fR=headers.sort:false,json.sort_keys:false .IP "\fB\,--sorted\/\fR" فعال‌سازی مجدد تمام گزینه‌های مرتب‌سازی هنگام قالب‌بندی خروجی. این گزینه یک میان‌بر است برای: \fB\,--format-options\/\fR=headers.sort:true,json.sort_keys:true .IP "\fB\,--response-charset\/\fR \fI\,ENCODING\/\fR" بازنویسی انکودینگ پاسخ برای اهداف نمایش در ترمینال، برای نمونه: \fB\,--response-charset\/\fR=utf8 \fB\,--response-charset\/\fR=big5 .IP "\fB\,--response-mime\/\fR \fI\,MIME_TYPE\/\fR" بازنویسی نوع چندرسانه‌ای (MIME type) پاسخ برای رنگ‌آمیزی و قالب‌بندی در ترمینال، برای نمونه: \fB\,--response-mime\/\fR=application/json \fB\,--response-mime\/\fR=text/xml .IP "\fB\,--format-options\/\fR" قالب‌بندی خروجی را کنترل می‌کند. تنها زمانی مرتبط است که قالب‌بندی از طریق \fB\,--pretty\/\fR=all یا \fB\,--pretty\/\fR=format (صریح یا ضمنی) فعال شده باشد. موارد زیر گزینه‌های پیش‌فرض هستند: headers.sort:true json.format:true json.indent:4 json.sort_keys:true xml.format:true xml.indent:2 می‌توانید از این گزینه چندین بار استفاده کنید و همچنین چند گزینه را به‌طور هم‌زمان با کاما از هم جدا نمایید. برای نمونه، دستور زیر تنظیمات را طوری تغییر می‌دهد که مرتب‌سازی کلیدهای JSON غیرفعال شده و اندازه تورفتگی روی ۲ تنظیم شود: \fB\,--format-options\/\fR json.sort_keys:false,json.indent:2 این تنظیمی است که معمولاً در فایل پیکربندی خود قرار می‌دهید. .PP .SH "گزینه‌های خروجی (OUTPUT OPTIONS)" .IP "\fB\,--print\/\fR, \fB\,-p\/\fR \fI\,WHAT\/\fR" رشته‌ای که مشخص می‌کند خروجی باید شامل چه مواردی باشد: \[aq]H\[aq] سرآیندهای درخواست \[aq]B\[aq] بدنه درخواست \[aq]h\[aq] سرآیندهای پاسخ \[aq]b\[aq] بدنه پاسخ \[aq]m\[aq] فراداده‌های پاسخ اگر خروجی استاندارد تغییرمسیر داده نشده باشد، رفتار پیش‌فرض \[aq]hb\[aq] است (یعنی سرآیندها و بدنه پاسخ چاپ می‌شوند). اگر خروجی به برنامه دیگری پایپ شود یا درون یک فایل هدایت گردد، به‌طور پیش‌فرض تنها بدنه پاسخ چاپ می‌شود. .IP "\fB\,--headers\/\fR, \fB\,-h\/\fR" تنها سرآیندهای پاسخ چاپ شوند. میان‌بری برای \fB\,--print\/\fR=h. .IP "\fB\,--meta\/\fR, \fB\,-m\/\fR" تنها فراداده‌های پاسخ چاپ شوند. میان‌بری برای \fB\,--print\/\fR=m. .IP "\fB\,--body\/\fR, \fB\,-b\/\fR" تنها بدنه پاسخ چاپ شود. میان‌بری برای \fB\,--print\/\fR=b. .IP "\fB\,--verbose\/\fR, \fB\,-v\/\fR" خروجی با جزئیات بیشتر (پُرگو). در سطح یک (با یک بار درج `\fB\,-v\/\fR`/`\fB\,--verbose\/\fR`)، کل درخواست و همچنین پاسخ چاپ می‌شود. همچنین تمام درخواست‌ها/پاسخ‌های واسط (مانند تغییرمسیرها) نیز چاپ می‌شوند. برای سطح دو و بالاتر، علاوه بر این موارد، فراداده‌های پاسخ نیز چاپ خواهند شد. سطح یک میان‌بری است برای: \fB\,--all\/\fR \fB\,--print\/\fR=BHbh سطح دو میان‌بری است برای: \fB\,--all\/\fR \fB\,--print\/\fR=BHbhm .IP "\fB\,--all\/\fR" به‌طور پیش‌فرض، تنها درخواست/پاسخ نهایی نمایش داده می‌شود. از این پرچم برای نمایش تمام درخواست‌ها/پاسخ‌های واسط نیز استفاده کنید. درخواست‌های واسط شامل تغییرمسیرهای دنبال‌شده (با \fB\,--follow\/\fR)، اولین درخواست غیرمجاز هنگام استفاده از احراز هویت دایجِست (\fB\,--auth\/\fR=digest)، و غیره هستند. .IP "\fB\,--stream\/\fR, \fB\,-S\/\fR" همیشه بدنه پاسخ به‌صورت خط‌به‌خط استریم (جریان‌سازی) شود، یعنی رفتاری مانند `tail \fB\,-f\/\fR\[aq] داشته باشد. بدون \fB\,--stream\/\fR و همراه با \fB\,--pretty\/\fR (چه صریح تنظیم شده باشد چه ضمنی)، ابزار HTTPie پیش از ارائه خروجی داده‌های پردازش‌شده، کل پاسخ را واکشی می‌کند. این گزینه را زمانی تنظیم کنید که می‌خواهید یک پاسخ طولانی‌مدت زیباسازی‌شده را به‌طور مداوم نمایش دهید، مانند پاسخ‌های دریافتی از Twitter streaming API. این گزینه بدون \fB\,--pretty\/\fR نیز سودمند است: تضمین می‌کند که خروجی در فواصل زمانی بیشتر و در قطعات کوچک‌تری تخلیه (flush) شود. .IP "\fB\,--output\/\fR, \fB\,-o\/\fR \fI\,FILE\/\fR" ذخیره خروجی در FILE به جای stdout. اگر \fB\,--download\/\fR نیز تنظیم شده باشد، تنها بدنه پاسخ در FILE ذخیره می‌شود. سایر بخش‌های تبادل HTTP در stderr چاپ می‌شوند. .IP "\fB\,--download\/\fR, \fB\,-d\/\fR" بدنه پاسخ را در stdout چاپ نمی‌کند؛ در عوض، آن را بارگیری کرده و در یک فایل ذخیره می‌کند. نام فایل حدس زده می‌شود مگر اینکه با \fB\,--output\/\fR [filename] مشخص شده باشد. این عمل مشابه رفتار پیش‌فرض wget است. .IP "\fB\,--continue\/\fR, \fB\,-c\/\fR" ادامه یک بارگیری متوقف‌شده. توجه داشته باشید که گزینه \fB\,--output\/\fR نیز باید مشخص شده باشد..IP "\fB\,--quiet\/\fR, \fB\,-q\/\fR" در صورت مشخص شدن یک‌باره، چیزی در stdout یا stderr چاپ نمی‌شود، مگر برای خطاها و هشدارها. برای فرونشاندن هشدارها نیز، آن را دو بار مشخص کنید. اگر \fB\,--output\/\fR مشخص شده باشد، stdout همچنان تغییر مسیر می‌یابد. این پرچم بر رفتار بارگیری تأثیری فراتر از چاپ نکردن روی ترمینال نمی‌گذارد. .PP .SH "نشست‌ها (SESSIONS)" .IP "\fB\,--session\/\fR \fI\,SESSION_NAME_OR_PATH\/\fR" ایجاد، یا استفاده مجدد و به‌روزرسانی یک نشست. درون یک نشست، سرآیندهای سفارشی، اعتبارنامه‌های احراز هویت، و همچنین هرگونه کوکی ارسال‌شده توسط سرور بین درخواست‌ها حفظ می‌شوند. فایل‌های نشست در این مسیر ذخیره می‌شوند: [HTTPIE_CONFIG_DIR]//.json. برای آگاهی از HTTPIE_CONFIG_DIR پیش‌فرض خود به صفحه زیر مراجعه کنید: https://httpie.io/docs/cli/config-file-directory .IP "\fB\,--session-read-only\/\fR \fI\,SESSION_NAME_OR_PATH\/\fR" ایجاد یا خواندن یک نشست بدون به‌روزرسانی آن از طریق تبادل درخواست/پاسخ. .PP .SH "احراز هویت (AUTHENTICATION)" .IP "\fB\,--auth\/\fR, \fB\,-a\/\fR \fI\,USER[:PASS] | TOKEN\/\fR" برای سازوکارهای احراز هویت مبتنی بر نام‌کاربری/گذرواژه (مانند basic auth یا digest auth) اگر فقط نام‌کاربری وارد شود (\fB\,-a\/\fR username)، ابزار HTTPie گذرواژه را از شما درخواست خواهد کرد. .IP "\fB\,--auth-type\/\fR, \fB\,-A\/\fR" سازوکار احراز هویت مورد استفاده. پیش‌فرض بر روی \[dq]basic\[dq] است. \[dq]basic\[dq]: احراز هویتِ Basic HTTP \[dq]digest\[dq]: احراز هویتِ Digest HTTP \[dq]bearer\[dq]: احراز هویتِ Bearer HTTP برای مشاهده تمامی انواع احراز هویت موجود در سیستم خود، شامل مواردی که با افزونه‌ها نصب شده‌اند، دستور زیر را اجرا کنید: $ http \fB\,--auth-type\/\fR .IP "\fB\,--ignore-netrc\/\fR" نادیده گرفتن اعتبارنامه‌ها از .netrc. .PP .SH "شبکه (NETWORK)" .IP "\fB\,--offline\/\fR" ساخت درخواست و چاپ آن، اما ارسال نکردنِ واقعی آن. .IP "\fB\,--proxy\/\fR \fI\,PROTOCOL:PROXY_URL\/\fR" رشته‌ای برای نگاشت پروتکل به نشانی URL پروکسی (مانند http:http://foo.bar:3128). می‌توانید چندین پروکسی را با پروتکل‌های مختلف مشخص کنید. متغیرهای محیطی $ALL_PROXY، $HTTP_PROXY و $HTTPS_proxy نیز پشتیبانی می‌شوند. .IP "\fB\,--follow\/\fR, \fB\,-F\/\fR" دنبال کردن تغییرمسیرهای 30x سرآیند Location. .IP "\fB\,--max-redirects\/\fR" به‌طور پیش‌فرض، درخواست‌ها دارای محدودیت 30 تغییرمسیر هستند (با \fB\,--follow\/\fR کار می‌کند). .IP "\fB\,--max-headers\/\fR" حداکثر تعداد سرآیندهای پاسخ که باید پیش از صرف‌نظر کردن خوانده شوند (پیش‌فرض 0، به معنای بدون محدودیت). .IP "\fB\,--timeout\/\fR \fI\,SECONDS\/\fR" مهلت زمانی (timeout) اتصال درخواست بر حسب ثانیه. مقدار پیش‌فرض 0 است، یعنی هیچ محدودیت زمانی وجود ندارد. این محدودیت زمانی برای کل فرایند بارگیری پاسخ نیست؛ بلکه اگر سرور به مدت timeout ثانیه پاسخی ارسال نکند، خطایی گزارش می‌شود (دقیق‌تر، اگر به مدت timeout ثانیه هیچ بایتی روی سوکت پایه دریافت نشود). .IP "\fB\,--check-status\/\fR" به‌طور پیش‌فرض، اگر هیچ خطای شبکه یا خطای مهلک دیگری رخ ندهد، HTTPie با وضعیت 0 خارج می‌شود. این پرچم به HTTPie دستور می‌دهد تا کد وضعیت HTTP را نیز بررسی کند و در صورتی که وضعیت نشان‌دهنده خطا باشد، با یک خطا خارج شود. هنگامی که سرور با یک کد وضعیت 4xx (خطای کلاینت) یا 5xx (خطای سرور) پاسخ می‌دهد، HTTPie به ترتیب با وضعیت 4 یا 5 خارج می‌شود. اگر پاسخ 3xx (تغییرمسیر) باشد و \fB\,--follow\/\fR تنظیم نشده باشد، وضعیت خروج 3 خواهد بود. همچنین اگر stdout تغییر مسیر داده شده باشد، یک پیام خطا در stderr نوشته می‌شود. .IP "\fB\,--path-as-is\/\fR" دور زدن فشرده‌سازی بخش‌های نقطه‌ای (/../ یا /./) در URL. .IP "\fB\,--chunked\/\fR" فعال‌سازی جریان داده (streaming) از طریق کدگذاری انتقال تکه‌تکه (chunked transfer encoding). سرآیند Transfer-Encoding بر روی chunked تنظیم می‌شود. .PP.SH SSL .IP "\fB\,--verify\/\fR" برای صرف‌نظر از بررسی گواهی SSL میزبان، روی \[dq]no\[dq] (یا \[dq]false\[dq]) تنظیم کنید. پیش‌فرض آن \[dq]yes\[dq] (\[dq]true\[dq]) است. همچنین می‌توانید مسیر یک فایل CA_BUNDLE را برای گواهی‌های خصوصی مشخص کنید. (یا می‌توانید به‌جای آن متغیر محیطی REQUESTS_CA_BUNDLE را مقداردهی کنید.) .IP "\fB\,--ssl\/\fR" نسخهٔ پروتکل مورد نظر برای استفاده. مقدار پیش‌فرض آن SSL v2.3 خواهد بود که بالاترین پروتکل پشتیبانی‌شده توسط هر دو سرور و نسخهٔ OpenSSL نصب‌شده شما را مذاکره می‌کند. پروتکل‌های موجود ممکن است بسته به OpenSSL نصب‌شده متفاوت باشند (تنها موارد پشتیبانی‌شده در اینجا نمایش داده شده‌اند). .IP "\fB\,--ciphers\/\fR" رشته‌ای در قالب فهرست رمزهای (ciphers) OpenSSL. برای دیدن فهرست پیش‌فرض رمزها در سیستم خود، `http \fB\,--help\/\fR` را بررسی کنید. .IP "\fB\,--cert\/\fR" می‌توانید یک گواهی محلی را برای استفاده به‌عنوان گواهی SSL سمت کلاینت مشخص کنید. این فایل می‌تواند شامل هر دو کلید خصوصی و گواهی باشد یا می‌توانید \fB\,--cert-key\/\fR را به‌طور جداگانه مشخص کنید. .IP "\fB\,--cert-key\/\fR" کلید خصوصی برای استفاده با SSL. تنها در صورتی نیاز است که \fB\,--cert\/\fR داده شده باشد و فایل گواهی حاوی کلید خصوصی نباشد. .IP "\fB\,--cert-key-pass\/\fR" عبارت‌عبور مورد استفاده برای کلید خصوصی داده‌شده. تنها در صورتی نیاز است که \fB\,--cert-key\/\fR مشخص شده باشد و فایل کلید به یک عبارت‌عبور نیاز داشته باشد. در صورت ارائه نشدن، به‌صورت تعاملی از شما پرسیده خواهد شد. .PP .SH "عیب‌یابی (Troubleshooting)" .IP "\fB\,--ignore-stdin\/\fR, \fB\,-I\/\fR" برای خواندن stdin تلاش نکنید. .IP "\fB\,--help\/\fR" نمایش این پیام راهنما و خروج. .IP "\fB\,--manual\/\fR" نمایش کتابچه راهنمای کامل. .IP "\fB\,--version\/\fR" نمایش نسخه و خروج. .IP "\fB\,--traceback\/\fR" در صورت بروز استثنا، ردپای پشته (traceback) را چاپ می‌کند. .IP "\fB\,--default-scheme\/\fR" طرح (scheme) پیش‌فرض برای استفاده در صورتی که در URL مشخص نشده باشد. .IP "\fB\,--debug\/\fR" در صورت وقوع استثنا، ردپای پشته (traceback) را چاپ می‌کند، همچنین اطلاعات دیگر که برای اشکال‌زدایی خود HTTPie و گزارش باگ‌ها مفید هستند. .PP .SH "همچنین ببینید (SEE ALSO)" به‌ازای هر \fB\,--OPTION\/\fR یک \fB\,--no-OPTION\/\fR نیز وجود دارد که OPTION را به مقدار پیش‌فرض آن بازمی‌گرداند. از پیشنهادها و گزارش‌های باگ بسیار استقبال می‌شود: https://github.com/httpie/cli/issues