مرجع API لرمز HS
اقرأ رمز HS واحدًا من إصدار مع اسمه ومستواه وأصله والرموز التي تقع تحته بمستوى واحد.
نظرة عامة
GET /
يُعيد GET / رمز HS واحدًا من إصدار: اسمه ومستواه وأصله والرموز التي تقع تحته بمستوى واحد. يتكوّن code من 2 أو 4 أو 6 أرقام.
الرمز الذي لا يوجد في الإصدار يُعيد 404 hs_. قد يوجد الرمز نفسه ذو 6 أرقام في إصدار ولا يوجد في آخر، لأن الإصدارات لا تُحوَّل إلى بعضها أبدًا. أداة MCP هي trade_ وتأخذ المعلمات نفسها.
طلب
البند الفرعي 851713، الهواتف الذكية، في إصدار 2022، والاستجابة الفعلية:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/hs-codes/851713"{
"code": "851713",
"level": 6,
"label": "Smartphones for wireless networks",
"parent": "8517",
"classification": "HS",
"edition": "2022",
"children": []
}لا رموز تحت البند الفرعي، لذلك يكون children فارغًا.
المعلمات
| معلمة | الموضع | النوع | مطلوب | الافتراضي | القيم المسموح بها ومعناها |
|---|---|---|---|---|---|
code | مسار | سلسلة نصية | نعم | لا شيء | رمز HS من 2 أو 4 أو 6 أرقام، مثل 85 أو 8517 أو 851713، بلا نقاط. أي صيغة أخرى تُعيد 400. |
edition | استعلام | سلسلة نصية | لا | 2022 | 2007 أو 2012 أو 2017 أو 2022. أي قيمة أخرى تُعيد 400. |
الاستجابة
تحتوي الإجابة على هذه الحقول.
| حقل | المعنى |
|---|---|
code | الرمز. |
level | 2 للفصل، و4 للبند، و6 للبند الفرعي. |
label | اسم الرمز بكلمات الإصدار. |
parent | الرمز الأعلى بمستوى واحد. null للفصل. |
classification | HS. |
edition | الإصدار. |
children | الرموز التي تقع تحته بمستوى واحد، لكل منها code وlevel وlabel وparent. فارغة للبند الفرعي. |
أمثلة إضافية
رمز لا يوجد في الإصدار
الرمز 851713 جديد في إصدار 2022. لا يوجد في إصدار 2017، لذلك يُعيد الطلب 404 وهو مجاني:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/hs-codes/851713?edition=2017"{
"type": "https://narwhalapi.com/problems/hs-code-not-found",
"title": "HS code not found",
"status": 404,
"detail": "HS 2017 has no code 851713.",
"code": "hs_code_not_found",
"request_id": "d8c40c41-aeaf-4b83-a315-c855697eafc3"
}المصادر
يحتفظ هذا المسار بالرموز ولا يحتفظ بأرقام تجارة، لذلك لا ينطبق أي مصدر.
العملة
لا يُعيد المسار قيمًا، لذلك لا تنطبق أي عملة.
التصفح بالصفحات
لا يوجد تقسيم إلى صفحات في المسار. تأتي كل الرموز التابعة في إجابة واحدة.
السعر
كل طلب يجد الرمز هو استدعاء واحد، بسعر $2 لكل 1,000 استدعاء. الرمز غير الموجود وكل خطأ آخر مجانيان.
الأخطاء
تستخدم هذه الأخطاء بنية تفاصيل الخطأ المشتركة مع request_. المفتاح المفقود أو غير الصالح (401)، والرصيد الأقل من سعر الاستدعاء (402)، وكثرة الطلبات في الدقيقة (429) هي أخطاء الحساب التي تشترك فيها كل المسارات: راجع أخطاء API والرصيد.
| الحالة | الرمز | متى يحدث |
|---|---|---|
400 | invalid_query | code ليس من 2 أو 4 أو 6 أرقام، أو edition ليس 2007 أو 2012 أو 2017 أو 2022. |
404 | hs_code_not_found | الإصدار لا يحتوي على هذا الرمز، مثلًا HS 2017 has no code 851713. |
هل كانت هذه الصفحة مفيدة؟