أوامر Posting

أوامر عميل HTTP واجهة المستخدم النصية الشاملة Posting وسير العمل لاختبار API في الطرفية.

التثبيت

الأمر	الوصف
uv tool install posting	تثبيت Posting عبر uv (مستحسن)
pipx install posting	تثبيت Posting عبر pipx
brew install posting	تثبيت Posting عبر Homebrew (macOS)
posting --version	عرض إصدار Posting
posting	تشغيل Posting TUI
posting --collection ./my-api	التشغيل مع دليل مجموعة محدد
posting --env .env.dev	التشغيل مع ملف البيئة

التنقل

الاختصار	الوصف
Tab	دوران التركيز بين اللوحات
Shift + Tab	دوران التركيز للخلف
Ctrl + J	وضع القفز (القفز إلى أي لوحة حسب العلامة)
Ctrl + P	فتح لوحة الأوامر
Ctrl + Q	الخروج من Posting
j / k	النزول/الصعود في القوائم (وضع Vim)
g / G	الانتقال إلى أعلى/أسفل القائمة
Escape	إغلاق الحوار أو إلغاء التحديد

إدارة الطلبات

الاختصار	الوصف
Ctrl + N	إنشاء طلب جديد
Ctrl + S	حفظ الطلب الحالي
Ctrl + Shift + S	حفظ الطلب كملف جديد
Ctrl + D	نسخ الطلب الحالي
Ctrl + Delete	حذف الطلب الحالي
Ctrl + R	إعادة تسمية الطلب الحالي
Enter	إرسال الطلب الحالي
Ctrl + L	التركيز على شريط URL

طرق HTTP

الطريقة	الوصف
GET	استرجاع المورد
POST	إنشاء مورد
PUT	تحديث/استبدال مورد
PATCH	تحديث جزئي للمورد
DELETE	حذف مورد
HEAD	الحصول على الرؤوس فقط
OPTIONS	الحصول على الطرق المدعومة

تكوين الطلب

التبويب	الوصف
تبويب الرؤوس	إضافة/تحرير رؤوس الطلب
تبويب الجسم	تعيين محتوى جسم الطلب
تبويب الاستعلام	إضافة معاملات استعلام URL
تبويب المصادقة	تكوين المصادقة
تبويب الخيارات	تعيين خيارات خاصة بالطلب
تبويب البرامج النصية	برامج Python قبل/بعد الطلب

متغيرات البيئة

الإجراء	الوصف
$VARIABLE_NAME في URL	الإشارة إلى متغير البيئة
${VARIABLE_NAME} في الجسم	إدراج متغير في الجسم
posting --env .env.dev	تحميل ملف البيئة عند بدء التشغيل
.env ملف في جذر المجموعة	تحميل تلقائي للبيئة
.env.local ملف الاستبدال	استبدالات محلية (مُتجاهل)

ملفات طلب YAML

الحقل	الوصف
name: My Request	اسم عرض الطلب
method: POST	طريقة HTTP
url: https://api.example.com/users	عنوان URL الهدف
headers:	خريطة رؤوس الطلب
body:	محتوى جسم الطلب
params:	معاملات الاستعلام
auth:	تكوين المصادقة
scripts:	برامج قبل/بعد الطلب

مثال على ملف الطلب

name: Create User
description: Create a new user account
method: POST
url: https://api.example.com/users
headers:
  Content-Type: application/json
  Authorization: Bearer ${API_TOKEN}
body:
  content: |
    {
      "name": "John Doe",
      "email": "john@example.com"
    }

أنواع المصادقة

النوع	الوصف
Bearer Token	Authorization: Bearer <token>
Basic Auth	اسم مستخدم:كلمة مرور مشفرة بـ Base64
API Key	رأس مخصص مع مفتاح API
بدون مصادقة	بدون مصادقة

برامج ما قبل/بعد الطلب

Hook	الوصف
pre_request.py	برنامج Python يعمل قبل الطلب
post_request.py	برنامج Python يعمل بعد الاستجابة
الوصول إلى كائن request	تعديل الطلب في النص المسبق
الوصول إلى كائن response	معالجة الاستجابة في النص اللاحق
تعيين المتغيرات	تخزين القيم للطلبات اللاحقة

عارض الاستجابة

الميزة	الوصف
تبويب الجسم	عرض جسم الاستجابة مع تمييز بناء الجملة
تبويب الرؤوس	عرض رؤوس الاستجابة
عرض كود الحالة	كود الحالة ونص HTTP
وقت الاستجابة	مدة الطلب بالميلي ثانية
حجم الاستجابة	حجم جسم الاستجابة
Ctrl + F	البحث في جسم الاستجابة

إدارة المجموعة

الإجراء	الوصف
هيكل الدليل = المجموعة	تنظيم الطلبات بواسطة هرمية الدليل
إنشاء دليل فرعي	تجميع الطلبات ذات الصلة
.yaml الملفات = الطلبات	كل ملف YAML هو طلب واحد
posting --collection <dir>	فتح مجموعة محددة
مراقبة الإصدارات مع Git	ملفات YAML صديقة لـ Git

الاستيراد/التصدير

الإجراء	الوصف
لصق أمر curl في شريط URL	الاستيراد من curl
Ctrl + E	تصدير الطلب الحالي كـ curl
الاستيراد من Postman	استيراد مجموعات Postman
الاستيراد من OpenAPI	استيراد مواصفات OpenAPI/Swagger
ملفات YAML محمولة	مشاركة الطلبات عبر الملفات

التكوين

الإعداد	الوصف
~/.config/posting/config.yaml	ملف التكوين العام
theme: monokai	تعيين مظهر اللون
vim_mode: true	تفعيل ربط مفاتيح Vim
editor: nvim	تعيين محرر خارجي
pager: less	تعيين عارض خارجي
timeout: 30	مهلة الطلب الافتراضية (ثانية)

المواضيع

الأمر	الوصف
posting --theme monokai	التشغيل بمظهر Monokai
posting --theme dracula	التشغيل بمظهر Dracula
posting --theme solarized	التشغيل بمظهر Solarized
مظهر مخصص في التكوين	تحديد مخطط ألوانك الخاص
posting --list-themes	عرض المظاهر المتاحة

نصائح وأفضل الممارسات

النصيحة	الوصف
استخدم وضع القفز (Ctrl+J)	التنقل أسرع من الجدولة
خزن الطلبات في Git	تحكم إصدارات لاختبارات API
استخدم ملفات البيئة	التبديل بين بيئات الإنتاج/التدريج/التطوير
اكتب برامج قبل/بعد	أتمتة تحديث رموز المصادقة
استخدم لوحة الأوامر Ctrl+P	اكتشف الميزات بسرعة
منظم في مجلدات	تجميع نقاط النهاية ذات الصلة معاً
استخدم المتغيرات في URLs	حافظ على الطلبات DRY ومرنة
افتح في $EDITOR للأجسام المعقدة	تحرير الحمولات الكبيرة خارجياً