راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
تحويل الرموز البريدية لقائمة عملاء دفعة واحدة
ملف العملاء المُصدَّر الذي يحتوي على عمود للرمز البريدي دون إحداثيات نقطة بداية شائعة لأي عمل يتعلق بمناطق الشحن أو التقارير الإقليمية أو تعيين المتاجر. وتحويل العمود كاملًا دفعة واحدة أسرع من كتابة حلقة تكرار.
إرسال الدفعة
أرسل عبر POST مصفوفة من كائنات الرمز والدولة إلى /v1/postcode. يُحوَّل كل عنصر بشكل مستقل ويعود بالترتيب نفسه.
POST /v1/postcode
Content-Type: application/json
[{"code": "10115", "country": "DE"}, {"code": "75001", "country": "FR"}]{
"status": "ok",
"results": [
{"postcode": "10115", "country_code": "DE", "results": [{"lat": 52.5300, "lon": 13.3800, "components": {"city": "Berlin", "region": "Berlin"}}]},
{"postcode": "75001", "country_code": "FR", "results": [{"lat": 48.8630, "lon": 2.3360, "components": {"city": "Paris", "region": "Ile-de-France"}}]}
]
}مطابقة النتائج مع سجلات العملاء
احتفظ برقم الصف الأصلي أو معرّف العميل إلى جانب كل زوج من الرمز والدولة قبل إرسال الطلب، وطابق النتائج مع سجلات العملاء بالموضع نفسه، وهو الأسلوب نفسه الذي ينجح في الترميز الجغرافي الأمامي أو العكسي المجمّع.
إزالة التكرار قبل الإرسال
قائمة العملاء ذات الحجم الحقيقي تحتوي عادة على رموز بريدية مميزة أقل بكثير من عدد صفوفها، لأن كثيرًا من العملاء يشتركون في الرمز نفسه في أي مدينة أو حي. أنشئ أولًا قائمة فريدة بأزواج الرمز والدولة، وحوّل تلك القائمة الأصغر في دفعة واحدة، ثم اربط النتائج بكل صف عميل يشترك في كل رمز، بدلًا من إرسال عنصر في المصفوفة لكل عميل والدفع مقابل زوج الرمز والدولة نفسه مرارًا وتكرارًا.
التعامل مع الرموز التي لا تُحوَّل
مصفوفة النتائج الفارغة لعنصر معين تعني عادة أن زوج الرمز والدولة غير موجود، وهذا شائع في ملف مُصدَّر قديم يحتوي على أخطاء إملائية أو رمز بريدي متقادم. ضع علامة على تلك الصفوف للمراجعة اليدوية بدلًا من حذفها بصمت من تقريرك.
حالة حدّية: اختلافات التنسيق
الرمز المخزّن بالشكل "SW1A1AA" دون مسافة والرمز المخزّن بالشكل "SW1A 1AA" بمسافة قد يُحوَّلان بالطريقة نفسها أو لا، بحسب مدى اتساق ملفك المُصدَّر في تنسيق الرموز، لذا فإن توحيد المسافات وحالة الأحرف في ملفك قبل بناء مصفوفة الدفعة يقلل عدد الصفوف التي تفشل في التحويل بسبب التنسيق وحده لا لأن الرمز خاطئ فعلًا.
كم يكلف
تُفوتر الدفعة بطلب واحد لكل عنصر، لذا فإن قائمة عملاء من 2,000 صف تكلف 2,000 طلب، سواء أُرسلت كاستدعاء مجمّع واحد أو على شكل 2,000 استدعاء منفصل. ويظل إرسالها كاستدعاء واحد مستحقًا لتقليل العبء ولوجود مجموعة واحدة من ترويسات الحصة للتحقق منها، رغم أن عدد الطلبات المحتسب من حصتك متطابق في الحالتين. وإزالة التكرار أولًا، كما ورد أعلاه، هي ما يقلل عدد الطلبات فعلًا، لا الاختيار بين الاستدعاءات المجمّعة والفردية.
مراقبة حصتك أثناء الدفعة
بالنسبة لقائمة كبيرة بما يكفي لتتجاوز 2,500 طلب مجاني يوميًا، تحقق من X-Quota-Free-Remaining قبل أن تلتزم بتشغيلها كاملة دفعة واحدة، أو قسّمها على يومين إذا لم تكن تخطط للانتقال إلى الرصيد المسبق الدفع لمهمة لمرة واحدة.
تحويل الرموز البريدية لقائمة عملاء كاملة في استدعاء واحد يحوّل ما كان مهمة خلفية بطيئة إلى طلب واحد مباشر. يغطي توثيق الاستعلام عن الرمز البريدي قائمة الحقول الكاملة.