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