هل يُرجع Dockflow قيمة انبعاثات CO2 في مخرجات API، وأين أجدها؟

نعم. يعيد Dockflow بيانات انبعاثات CO2 في سجل واجهة برمجة التطبيقات (API). ابحث عن الحقل carbon_emissions، الذي تصفه الوثائق بأنه بيانات انبعاثات CO2 لمسار الشحنة.

يعيد الاستعلام الدوري (Polling) السجلات في مصفوفة data. أما الـ Webhooks فترسل سجلاً واحداً في data، وهذا السجل مطابق لما يعيده الاستعلام الدوري مع الحقول الافتراضية، والتي تتضمن shipment. يعيد كلا الوضعين السجل نفسه.

داخل carbon_emissions، اقرأ distance_km لمسافة المسار بالكيلومترات وco2_emissions_kg لإجمالي CO2 بالكيلوغرامات. الإجمالي هو من Well-to-Wheel، ويتكوّن من Tank-to-Wheel زائد Well-to-Tank. وttw_kg هو الجزء الخاص بـ Tank-to-Wheel، أي الاحتراق المباشر للوقود. يكون الحقل فارغاً (null) عندما لم تُحسب القيمة بعد.

لذا يجب أن يقرأ التكامل الخاص بك قيمة CO2 من الحقل carbon_emissions في كل سجل. وإذا كان هذا الحقل فارغاً (null)، فلا تتوفر بعد قيمة CO2 محسوبة.

مثال
بالنسبة لشحنة بحرية عامة، يمكن أن يُظهر السجل مسافة المسار في distance_km وقيمة إجمالي CO2 في co2_emissions_kg. وقيمة ttw_kg هي جزء الاحتراق المباشر. يقرأ التكامل الخاص بك هذه القيم من carbon_emissions في كل سجل من سجلات الاستعلام الدوري أو الـ Webhook. وإذا كان carbon_emissions فارغاً (null)، فلم يُجرَ الحساب بعد.