كيفية استخدام منشئ ترويسات API
- اختر نوع المصادقة وأدخل بيانات الاعتماد.
- اختر قيم Accept / Content-Type وفعّل ترويسات التتبّع أو التنفيذ الأحادي (idempotency).
- أضف أي ترويسات مخصّصة تتطلبها واجهة API لديك.
- اختر صيغة التصدير، وانسخ الكتلة إلى عميلك، وانقر «إعادة التوليد» للحصول على معرّفات ربط جديدة.
مزايا منشئ ترويسات API
- إعدادات مسبقة للمصادقة: Bearer وBasic (ترميز base64 تلقائي) وترويسات مفاتيح API
- قوائم اختيار لـ Accept وContent-Type وAccept-Language مع معاملات charset الصحيحة
- ترويسات تتبّع بنقرة واحدة: X-Request-Id (UUID v4) وtraceparent وفق W3C، إضافة إلى Idempotency-Key وCache-Control: no-cache
- ترويسات مخصّصة مع التحقق من الأسماء وفق معايير RFC
- التصدير كترويسات خام أو cURL أو fetch أو axios أو طلب HTTP كامل أو كائن JSON
- الأسرار مقنّعة في الجدول المرجعي، ولا تُرسل إلى أي مكان
مثال على منشئ ترويسات API
Bearer + JSON + تتبّع بصيغة fetch
الإدخال:
Auth: Bearer eyJ… · Accept: application/json · Content-Type: application/json · Tracing: on · Export: JavaScript fetchالنتيجة:
fetch("https://api.example.com/v1/orders", {
method: "POST",
headers: {
"Authorization": "Bearer eyJ…",
"Accept": "application/json",
"Content-Type": "application/json",
"X-Request-Id": "8f1c…",
"traceparent": "00-4bf9…-00f0…-01"
},
});الأسئلة الشائعة حول منشئ ترويسات API
كيف تُرمَّز مصادقة Basic؟
ترمّز الأداة "username:password" بـ base64 وتُخرج Authorization: Basic <encoded>. ولأن base64 ليس تشفيراً، لا تستخدمه إلا عبر HTTPS.
ما فائدة X-Request-Id وtraceparent؟
X-Request-Id معرّف ربط يمكنك البحث عنه في سجلات الخادم. أما traceparent فهي ترويسة W3C Trace Context (version-traceId-spanId-flags) التي تفهمها أنظمة التتبّع مثل OpenTelemetry وDatadog وJaeger. انقر «إعادة التوليد» للحصول على معرّفات جديدة.
متى ينبغي إرسال Idempotency-Key؟
في طلبات POST التي تنشئ شيئاً ما (المدفوعات والطلبات). فإذا أعاد العميل المحاولة بعد انتهاء المهلة، يتعرّف الخادم على المفتاح ولا ينشئ نسخة مكرّرة. تشترطه Stripe وAdyen وكثير من واجهات API للمدفوعات.
هل تُخزَّن رموزي أو تُرسل إلى أي مكان؟
لا. يُجمَّع كل شيء في متصفحك. تُقنَّع الحقول الحساسة في الجدول المرجعي؛ ويحتوي التصدير على القيمة الحقيقية حتى تتمكن من لصقها في عميلك.