تصفّح التوثيق كاملًا

مرجع API لرمز HS

اقرأ رمز HS واحدًا من إصدار مع اسمه ومستواه وأصله والرموز التي تقع تحته بمستوى واحد.

نظرة عامة

GET /v1/trade/hs-codes/{code}

يُعيد GET /v1/trade/hs-codes/{code} رمز HS واحدًا من إصدار: اسمه ومستواه وأصله والرموز التي تقع تحته بمستوى واحد. يتكوّن code من 2 أو 4 أو 6 أرقام.

الرمز الذي لا يوجد في الإصدار يُعيد 404 hs_code_not_found. قد يوجد الرمز نفسه ذو 6 أرقام في إصدار ولا يوجد في آخر، لأن الإصدارات لا تُحوَّل إلى بعضها أبدًا. أداة MCP هي trade_get_hs_code وتأخذ المعلمات نفسها.

طلب

البند الفرعي 851713، الهواتف الذكية، في إصدار 2022، والاستجابة الفعلية:

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/trade/hs-codes/851713"
الرمز 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استعلامسلسلة نصيةلا20222007 أو 2012 أو 2017 أو 2022. أي قيمة أخرى تُعيد 400.

الاستجابة

تحتوي الإجابة على هذه الحقول.

حقلالمعنى
codeالرمز.
level2 للفصل، و4 للبند، و6 للبند الفرعي.
labelاسم الرمز بكلمات الإصدار.
parentالرمز الأعلى بمستوى واحد. null للفصل.
classificationHS.
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"
الرمز 851713 في إصدار 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_id. المفتاح المفقود أو غير الصالح (401)، والرصيد الأقل من سعر الاستدعاء (402)، وكثرة الطلبات في الدقيقة (429) هي أخطاء الحساب التي تشترك فيها كل المسارات: راجع أخطاء API والرصيد.

الحالةالرمزمتى يحدث
400invalid_querycode ليس من 2 أو 4 أو 6 أرقام، أو edition ليس 2007 أو 2012 أو 2017 أو 2022.
404hs_code_not_foundالإصدار لا يحتوي على هذا الرمز، مثلًا HS 2017 has no code 851713.

أخطاء API والرصيد · مرجع واجهة API للتجارة · دول التجارة

هل كانت هذه الصفحة مفيدة؟