التوثيق
مرجع APIالموقع
تصفّح التوثيق كاملًا

كيفية تحقق Narwhal من البيانات الاقتصادية الرسمية

المصادر وقواعد التحقق والتخزين والتنقيح التي تستند إليها كل استجابة متاحة للجمهور من واجهة API للاقتصاد.

توحّد Narwhal مواصفات التعامل مع الإصدارات الإحصائية الوطنية. وتحافظ على الفترة والوحدة وتاريخ الإصدار وحقول التفسير الواردة في المصدر، بدلًا من اختزال مؤشرات مختلفة في رقم مبهم.

المصادر الرسمية فقط

يبدأ كل تدفق بيانات متاح حاليًا من مكتب إحصاء حكومي أو ناشر وطني رسمي آخر. ولا تخلط Narwhal تقديرًا تجاريًا بأي سلسلة رسمية لمؤشر أسعار المستهلك أو سوق العمل أو الناتج المحلي الإجمالي أو تجارة السلع.

يشمل الناشرون الحاليون ABS وStatistics Canada وDestatis وINSEE وONS والجهات الإحصائية الوطنية في اليابان وDOSM وCBS Netherlands وSingStat وBLS وBEA وUS Census Bureau وStatistics Estonia وCentral Statistics Office في أيرلندا وCentral Statistical Bureau في لاتفيا وStatistical Office في سلوفينيا وCroatian Bureau of Statistics وCzech Statistical Office وState Data Agency of Lithuania وStatistics Portugal (INE). إن مصفوفة التغطية توضح الناشرين ودوريات النشر الخاصة بكل دولة متاحة للجمهور.

البرتغال سجل مصدر INE يُنشر بموجب رخصة CC BY 4.0؛ تنسب Narwhal البيانات إلى INE وتحدد القيم الموحّدة الصيغة والقيم المشتقة في مواصفات API.

تظل مخرجات Narwhal الموحّدة الصيغة من هذه الجهات خاضعة للشروط المنشورة:

توضح Narwhal عمليات توحيد الصيغة والمعدلات المشتقة في مواصفات API.

إحصاءات النرويج (SSB) تُعاد الاستفادة من جداولها 09190 و14710/14700 و13760 و08792 بموجب CC BY 4.0؛ احتفظ بتفاصيل المصدر والجدول والترخيص والتحديث، وبيّن توحيد Narwhal للبيانات والتغييرات المشتقة، ولا توحِ بتأييد SSB.

هيئة الإحصاء الفنلندية (StatFin) تُعاد الاستفادة من جداولها 132h و15b5/122p و135y بموجب CC BY 4.0؛ احتفظ بالإسناد إلى هيئة الإحصاء الفنلندية وتفاصيل مجموعة البيانات والترخيص والتحديث، وبيّن توحيد Narwhal للبيانات.

الجمارك الفنلندية تُعاد الاستفادة من مكعبي Uljas التابعين لها، ULJAS_KAUPPATASE (النهائي) وULJAS_ENNAKKO (الأولي)، بموجب CC BY 4.0؛ احتفظ بالإسناد إلى الجمارك الفنلندية والمكعب والتحديث، وحافظ على بيان الحالة النهائية أو المؤقتة، وبيّن اختيار Narwhal للبيانات وتوحيدها.

إحصاءات السويد (SCB) تُعاد الاستفادة من جداولها TAB3102/TAB3100 وTAB6596 وTAB6387 وTAB5391 بموجب CC0؛ حدّد مجموعات البيانات ومعالجة Narwhal المستقلة، دون تقديم المخرجات كمنشورات رسمية لـSCB أو الإيحاء بتعاون رسمي.

إحصاءات الدنمارك تُعاد الاستفادة من جداول StatBank التابعة لها PRIS01 وAKU111K وSITC2R4M وSITC2R4 بموجب CC BY 4.0؛ احتفظ بالإسناد إلى هيئة الإحصاء الدنماركية والجدول، وبيّن توحيد Narwhal للبيانات.

يوروستات تشمل شروط إعادة الاستخدام لديه بيانات الدنمارك المختارة من namq_10_gdp وبيانات لوكسمبورغ المختارة من namq_10_gdp وune_rt_q وlfsq_argan وext_st_27_2020msbec؛ احتفظ بالإسناد إلى Eurostat ومجموعة البيانات وتاريخ الوصول، وحدّد تغييرات Narwhal واذكر أن Eurostat غير مسؤول عنها.

STATEC تُعاد الاستفادة من مجموعة بيانات مؤشر أسعار المستهلك الوطني التابعة له DSD_ECOICOP_PRIX@DF_E5405 بموجب CC0؛ احتفظ باسم STATEC وسجل مجموعة البيانات المرتبط.

هيئة الإحصاء الكندية تُعاد الاستفادة من بياناتها بموجب Open Government Licence - Canada؛ احتفظ بالإسناد إلى المصدر وإشعارات الأطراف الثالثة، وبيّن توحيد Narwhal للبيانات والتغييرات المشتقة، ولا توحِ بتأييد هيئة الإحصاء الكندية.

هيئة الإحصاء الهولندية (CBS) تُعاد الاستفادة من جداول StatLine التابعة لها 86141ENG و80590ENG و85879ENG و85880ENG و85427ENG بموجب CC BY 4.0؛ احتفظ بالإسناد إلى CBS، وحدّد تغييرات Narwhal، واستبعد مواد الأطراف الثالثة الخاضعة لقيود منفصلة، ولا توحِ بتأييد CBS.

مكتب الإحصاءات الوطنية (ONS) تُعاد الاستفادة من بياناته بموجب Open Government Licence v3.0؛ احتفظ بالإسناد إلى ONS والترخيص وإشعارات الأطراف الثالثة، وبيّن توحيد Narwhal للبيانات والتغييرات المشتقة، ولا توحِ بتأييد ONS.

المكتب الأسترالي للإحصاء (ABS) تُعاد الاستفادة من بياناته بموجب CC BY 4.0؛ احتفظ بالإسناد إلى ABS، وبيّن توحيد Narwhal للبيانات والتغييرات المشتقة، واستبعد مواد الأطراف الثالثة التي لم يُتحقق من الإذن باستخدامها، ولا توحِ بتأييد ABS.

لوحة الإحصاءات / e-Stat اليابانية تُعاد الاستفادة من بياناتها بموجب Government of Japan Standard Terms of Use 2.0 / شروط متوافقة مع CC BY 4.0؛ احتفظ بالإسناد إلى المصدر وحقوق الأطراف الثالثة المحدّدة على نحو منفصل.

INSEE تُعاد الاستفادة من بياناته بموجب Open Licence 2.0؛ احتفظ بالإسناد إلى المصدر وآخر تحديث وإشعارات الأطراف الثالثة، وبيّن توحيد Narwhal للبيانات والتغييرات المشتقة، ولا توحِ بتأييد INSEE.

الجمارك الفرنسية (DGDDI/DSECE) تُعاد الاستفادة من بياناتها بموجب إشعار إعادة الاستخدام المرتبط؛ احتفظ بالمصدر الدقيق والتاريخ المرجعي وحافظ على سلامة البيانات.

Destatis تُعاد الاستفادة من بياناته بموجب Data licence Germany - attribution - Version 2.0؛ احتفظ بالمصدر والترخيص وسياق التحديث.

المعهد الوطني للإحصاء في إسبانيا (INE) تُعاد الاستفادة من جداولِه 76125 و67821 و67822 و65081 و65219 بموجب CC BY 4.0؛ احتفظ بالإسناد إلى المصدر والتحديث، وحدّد تغييرات Narwhal، ولا توحِ بتأييد INE.

وكالة الضرائب الإسبانية (AEAT) تستخدم بياناتها لإجمالي التجارة السلعية المنهجية الجديدة اعتبارًا من 2024 بموجب شروط إعادة الاستخدام المرتبطة؛ احتفظ بالمصدر والتواريخ والبيانات الوصفية، وحدّد تغييرات Narwhal، ولا تحرّف البيانات أو توحِ بتأييد AEAT.

هيئة الإحصاء الفلبينية (PSA) تُعاد الاستفادة من جداول OpenSTAT التابعة لها 0012M4ACP22.px و0021B3FKEI2.px و0012L4DFTS0.px و0012B5BEXQ1.px و0022B5BEXQ2.px و022B5BEXS2.px بموجب شروط مجموعات البيانات CC BY؛ احتفظ بالإسناد إلى PSA ورابط الشروط والملاحظات الفنية، وحدّد تغييرات Narwhal، ولا توحِ بتأييد PSA.

يعيد Narwhal استخدام إدخالات تقاويم الإصدارات للجهات الناشرة التالية (التواريخ والأوقات والعناوين والفترات المرجعية) بموجب الشروط المرتبطة.

مجلس محافظي نظام الاحتياطي الفيدرالي تُعاد الاستفادة من إدخالات تقويم إصداراته المتاحة ضمن الملكية العامة، مع ذكر مجلس محافظي نظام الاحتياطي الفيدرالي بوصفه المصدر. لا يستخدم Narwhal شعارات أو أختامًا، ولا يوحي بتأييد المجلس.

وزارة العمل الأمريكية، إدارة التوظيف والتدريب تُعاد الاستفادة من إدخالات تقويم إصداراتها المتاحة ضمن الملكية العامة، مع ذكر وزارة العمل الأمريكية (DOL) بوصفها المصدر ودون الإيحاء بتأييدها.

إدارة معلومات الطاقة الأمريكية تُعاد الاستفادة من إدخالات تقويم إصداراتها المتاحة ضمن الملكية العامة، مع ذكر المصدر بالصيغة "Source: U.S. Energy Information Administration". يبيّن الحقل observed_at لكل إصدار تاريخ قراءة Narwhal لجدول EIA، ويُستخدم هذا التاريخ لتأريخ الإقرار بالمصدر بالصيغة "Source: U.S. Energy Information Administration (<date>)".

مكتب الخدمات المالية يتيح FiscalData إدخالات تقويم إصدارات البيان الشهري للخزانة الصادرة عنه (تواريخ الإصدار وأوقاته وعناوينه والفترات المرجعية) للاستخدام التجاري، ويعيد Narwhal استخدامها. يذكر Narwhal مكتب الخدمات المالية التابع لوزارة الخزانة الأمريكية بوصفه المصدر ويوحّد صيغة الإدخالات، دون الإيحاء بأي تأييد من المكتب أو وزارة الخزانة الأمريكية.

يوروستات تُعاد الاستفادة من إدخالات تقويم إصداراته لمنطقة اليورو مع الإسناد "Source: Eurostat". يوحّد Narwhal صيغة الإدخالات دون الإيحاء بتأييد Eurostat.

المفوضية الأوروبية، المديرية العامة للشؤون الاقتصادية والمالية (DG ECFIN) تُعاد الاستفادة من إدخالات تقويم إصداراتها لمسوح الأعمال والمستهلكين مع الإسناد "© European Union" بموجب رخصة CC BY 4.0. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات.

وزارة المالية اليابانية تُعاد الاستفادة من إدخالات تقويم إصداراتها بموجب Public Data License 1.0، مع ذكر وزارة المالية اليابانية بوصفها المصدر. حرّر Narwhal المحتوى؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

e-Stat (البوابة الإلكترونية للإحصاءات الرسمية لليابان) تُعاد الاستفادة من إدخالات تقويم إصداراتها مع الإسناد "Source: Portal Site of Official Statistics of Japan website (https://www.e-stat.go.jp/)". حرّر Narwhal المحتوى؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

معهد البحوث الاقتصادية والاجتماعية (ESRI)، مكتب مجلس الوزراء الياباني تُعاد الاستفادة من إدخالات تقويم إصداراته بموجب شروط الاستخدام القياسية لحكومة اليابان 2.0 مع الإسناد "Created by Narwhal based on the GDP release schedule (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/en/sna/kouhyou/kouhyou_top.html)". حرّر Narwhal الإدخالات (وحّد صيغتها)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

الجمارك اليابانية (وزارة المالية اليابانية) تُعاد الاستفادة من إدخالات تقويم إصداراته بموجب رخصة البيانات العامة 1.0 مع الإسناد "Created by Narwhal based on the Calendar of Release Dates (Japan Customs, Ministry of Finance) (https://www.customs.go.jp/toukei/calendar/calend_e.htm)". حرّر Narwhal الإدخالات (وحّد صيغتها)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

وزارة المالية اليابانية، إحصاءات القوائم المالية للشركات حسب القطاع تُعاد الاستفادة من إدخالات تقويم إصداراته بموجب رخصة البيانات العامة 1.0 مع الإسناد "Created by Narwhal based on the Financial Statements Statistics of Corporations by Industry release schedule (Ministry of Finance, Japan) (https://www.mof.go.jp/pri/reference/ssc/results/release_info.htm)". حرّر Narwhal الإدخالات (وحّد صيغتها)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

مكتب الإحصاء الياباني (وزارة الشؤون الداخلية والاتصالات) توفر ملخصاته الشهرية القيم الفعلية والسابقة المعروضة في إدخالات تقويم إصدارات مؤشر أسعار المستهلك، ومؤشر أسعار المستهلك لمنطقة طوكيو (أولي)، ومسح القوى العاملة، ومسح دخل الأسرة وإنفاقها (إنفاق الأسر) في اليابان، والتي يقرأها Narwhal كما نُشرت ويعيد استخدامها بموجب رخصة البيانات العامة 1.0 مع الإسناد "Created by Narwhal based on the Consumer Price Index, Tokyo area Consumer Price Index (preliminary), Labour Force Survey, and Family Income and Expenditure Survey (household spending) monthly summaries (Statistics Bureau of Japan) (https://www.stat.go.jp/english/)". حرّر Narwhal المحتوى (وحّد صيغته)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

وزارة الصحة والعمل والرعاية الاجتماعية (MHLW)، اليابان توفر بياناتها الصحفية القيم الفعلية (إجمالي الأجور النقدية والأجور الحقيقية، على أساس سنوي) المعروضة في إدخالات تقويم إصدارات مسح العمل الشهري، والتي يقرأها Narwhal كما نُشرت ويعيد استخدامها بموجب رخصة البيانات العامة 1.0 مع الإسناد "Created by Narwhal based on the Monthly Labour Survey (Ministry of Health, Labour and Welfare) (https://www.mhlw.go.jp/toukei/itiran/roudou/monthly/)". حرّر Narwhal المحتوى (وحّد صيغته)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

معهد البحوث الاقتصادية والاجتماعية (ESRI)، مكتب مجلس الوزراء الياباني توفر إحصاءاته لطلبيات الآلات القيم الفعلية والسابقة (طلبيات الآلات الأساسية في القطاع الخاص باستثناء السفن والطاقة الكهربائية، على أساس شهري وسنوي) المعروضة في إدخالات تقويم إصدارات طلبيات الآلات، والتي يقرأها Narwhal كما نُشرت ويعيد استخدامها بموجب شروط الاستخدام القياسية لحكومة اليابان 2.0 مع الإسناد "Created by Narwhal based on the Machinery Orders statistics (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/jp/stat/juchu/menu_juchu.html)". حرّر Narwhal المحتوى (وحّد صيغته)؛ ولا تُقدَّم النسخة المحررة على أنها من تأليف الحكومة اليابانية.

المؤسسة الكندية للرهن العقاري والإسكان تُعاد الاستفادة من إدخالات تقويم إصداراتها مع الإشعار "Source: Canada Mortgage and Housing Corporation (CMHC), housing data release schedule, reference period as shown on each release." يستخدم المستفيدون الإدخالات بموجب شروط ترخيص CMHC.

بنك الاحتياطي الأسترالي تُعاد الاستفادة من إدخالات تقويم إصداراته مع ذكر المصدر بالصيغة "Source: Reserve Bank of Australia 2026" بموجب رخصة CC BY 4.0. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات. لا ينطوي هذا الاستخدام على أي تأييد من RBA.

Banco Central do Brasil تُعاد الاستفادة من إدخالات تقويم إصداراته مع ذكر Banco Central do Brasil (BCB) بوصفه المصدر. تُحفظ المعلومات كما هي، بما في ذلك التواريخ والأوقات والعناوين كما نُشرت.

Banco de México تُعاد الاستفادة من إدخالات تقويم إصداراته مع ذكر Banco de México بوصفه المصدر وإيراد عنوان موقعه https://www.banxico.org.mx/.

معهد الإحصاء التركي (TurkStat) تُعاد الاستفادة من إدخالات تقويم إصداراته مع ذكر TurkStat بوصفه المصدر.

وزارة الإحصاء وتنفيذ البرامج (MoSPI)، الهند تُعاد الاستفادة من إدخالات تقويم إصداراتها مع ذكر MoSPI بوصفها المصدر.

الهيئة الإحصائية الهيلينية (ELSTAT) تُعاد الاستفادة من إدخالات تقويم إصداراتها مع ذكر ELSTAT بوصفها المصدر. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات، ولا تتحمل ELSTAT أي مسؤولية عن هذه التغييرات.

المكتب المركزي للإحصاء المجري (KSH) تُعاد الاستفادة من إدخالات تقويم إصداراته مع ذكر المصدر بالصيغة "Forrás: KSH" بموجب رخصة CC BY 4.0. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات.

إحصاءات آيسلندا تُعاد الاستفادة من إدخالات تقويم إصداراتها مع ذكر إحصاءات آيسلندا بوصفها الجهة المؤلفة بموجب رخصة CC BY 4.0. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات.

المديرية العامة للميزانية والمحاسبة والإحصاء (DGBAS)، تايوان تُعاد الاستفادة من إدخالات تقويم إصداراتها بموجب رخصة البيانات الحكومية المفتوحة، الإصدار 1.0، مع ذكر DGBAS بوصفها المصدر. غيّر Narwhal المحتوى بتوحيد صيغة الإدخالات.

يُقبل الإصدار كوحدة نشر متكاملة

يجلب فحص مجدول للمصدر إصدارًا مرشحًا ويتحقق من هويته وفترته وحقوله المطلوبة ووحداته واكتماله. وتُخزّن المشاهدات وأدلة مصدرها معًا. ولا يصبح متاحًا لطلبات العملاء إلا الإصدار الكامل الذي يجتاز الفحوص المطلوبة.

إذا كان المرشح غير مكتمل أو فشل التحقق، تبقي Narwhal آخر إصدار مقبول متاحًا. ولا تستبدل قيمة مفقودة بصفر ولا تخلط جزءًا من إصدار فاشل مع إصدار أقدم.

مواصفات موحّدة دون فقدان المعنى

تستخدم عمليات أحدث البيانات والبيانات التاريخية للبلدان مسارات REST وأدوات MCP ثابتة، مع توضيح سياق كل مؤشر. يحتفظ CPI بأساسه المرجعي، مثل 1982-84=100؛ ويستخدم CPI لأيرلندا أساس ديسمبر 2023، وتُحفظ علامة التعديل WorkAndSes من المصدر في لاتفيا كما هي دون تعديل غير متحقق منه من Narwhal. يُقاس GDP بالأسعار الجارية دائمًا، ويكون نمو GDP حقيقيًا؛ ولا تظهر علامة إلا عندما تكون السلسلة غير معدّلة موسميًا أو محوّلة إلى أساس سنوي. تقتصر التجارة على السلع وتحتفظ بعملتها؛ وتُحوّل قيم المصدر الأيرلندي من آلاف اليورو إلى اليورو في عقد API.

تُعاد القيم العشرية كسلاسل نصية حتى لا تفقد التطبيقات العميلة الدقة دون تنبيه. وتظل القيم المفقودة مفقودة. إن مرجع واجهة API للاقتصاد يوثق الحقول وتنسيق الفترة المقبول لكل عملية.

الحداثة والتنقيحات

تقرأ طلبات العملاء البيانات المقبولة المخزنة لدى Narwhal؛ ولا تنتظر موقعًا حكوميًا. إن period يحدد المشاهدة، بينما released_on يوثق تاريخ النشر الرسمي.

يمكن للجهات الرسمية تنقيح الأرقام السابقة. وعندما يجتاز إصدار منقح الفحوص نفسها، يمكنه استبدال القيمة المخزنة سابقًا لتلك الفترة. لا تعرض Narwhal حاليًا طابعًا زمنيًا لإدخال البيانات، ولا تَعِد بمدة تأخير ثابتة بين صدورها من المصدر ونشرها خلال المرحلة التجريبية العامة. للاطّلاع على التفاصيل الدقيقة، راجع مواصفات حداثة البيانات.

القيود الحالية

  • تُدرج تغطية الدول والمؤشرات في صفحات التغطية العامة. تختلف الفترات المتاحة حسب المصدر.
  • تتبع دورية التحديث المصدر الرسمي، ولا تُزاد وتيرتها بصورة مصطنعة.
  • تجارة السلع لا تشمل تجارة الخدمات.
  • قد تتأخر البيانات الاقتصادية أو يصححها ناشرها أو ينقحها.
  • تتضمن خطتا Basic وPro اتفاقية مستوى خدمة بتوفر 99.5%؛ راجع الشروط. وبيانات Narwhal ليست نصيحة مالية أو استثمارية أو قانونية أو ضريبية.

بالنسبة للسلوك التشغيلي، اقرأ الأخطاء والحصة. للاطّلاع على نطاق التغطية على مستوى الدولة، افتح التغطية.