افحص ما إذا كانت طريقة HTTP آمنة أو قابلة للتكرار
صنّف طريقة HTTP قياسية بحسب خاصيتي الأمان وقابلية التكرار بلا أثر إضافي كما تحددهما دلالات HTTP.
شغّل الأداة مجانًا
أدخل طريقة مثل GET أو POST أو PUT أو PATCH أو DELETE لتحصل على الاسم الموحّد، ونتيجتين منطقيتين منفصلتين، وتصنيف إجمالي موجز. تتعرف الأداة على الطرق التسع المحددة في المواصفات الأساسية لدلالات HTTP وPATCH، وتتجاهل المسافات المحيطة والفرق بين الأحرف الكبيرة والصغيرة، وترفض الأسماء غير المعروفة بدلاً من افتراض خصائص طرق الامتداد.
طريقة الاستخدام
أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.
راجع بياناتك
اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.
أعد الحساب أو نفّذه آليًا
استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.
حالات الاستخدام
احصل على النتيجة الآن
أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.
قارن السيناريوهات
غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.
أتمت العمل المتكرر
استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.
الأسئلة الشائعة
هل كل طريقة آمنة قابلة أيضاً للتكرار بلا أثر إضافي؟
نعم. تعرّف دلالات HTTP الطرق الآمنة بأنها قابلة للتكرار، ولذلك تجمع GET وHEAD وOPTIONS وTRACE الخاصيتين.
لماذا تُعد DELETE قابلة للتكرار مع أن المحاولة الثانية قد تعيد حالة مختلفة؟
تتعلق قابلية التكرار بالأثر المقصود في الخادم لا بتطابق الاستجابات. وتستهدف طلبات الحذف المتكررة الحالة النهائية نفسها للمورد.
هل PATCH قابلة للتكرار بلا أثر إضافي؟
ليست PATCH قابلة للتكرار افتراضياً. وقد تعرّف خدمة API عملية PATCH تقبل الإعادة، لكن ذلك ضمان خاص بالتطبيق.
هل تُقبل أسماء الطرق المكتوبة بأحرف صغيرة؟
نعم. تحذف الأداة المسافات المحيطة وتوحّد الاسم المدخل إلى الأحرف الكبيرة قبل تصنيفه.
ماذا يحدث لطرق WebDAV أو الطرق المخصصة؟
تُرفض بوصفها غير معروفة. ويجب استمداد خصائصها من المواصفة أو عقد التطبيق الذي يعرّفها.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/dev2/http-method-idempotent-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"method":"PUT"}'const res = await fetch("https://api.kit.forhosting.com/dev2/http-method-idempotent-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"method": "PUT"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/http-method-idempotent-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"method": "PUT"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/http-method-idempotent-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"method":"PUT"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"method":"PUT"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/http-method-idempotent-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"method": "PUT"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.http_method_idempotent_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |