[{"data":1,"prerenderedAt":946},["ShallowReactive",2],{"page-\u002Far\u002Fguides\u002Fdpp-registry-api":3,"related-\u002Far\u002Fguides\u002Fdpp-registry-api":925},{"id":4,"title":5,"author":6,"body":7,"category":911,"description":912,"extension":913,"heading":914,"heroImage":911,"heroImageAlt":915,"howTo":911,"layout":916,"meta":917,"navigation":317,"ogImage":918,"path":919,"publishedAt":920,"sections":911,"seo":921,"sourcePath":922,"stem":923,"updatedAt":920,"videoPosition":911,"videos":911,"__hash__":924},"pages\u002Far\u002Fguides\u002Fdpp-registry-api.md","واجهة API لسجل جواز المنتج الرقمي: ما يتطلبه التكامل فعلا","Mia",{"type":8,"value":9,"toc":888},"minimark",[10,17,30,33,42,47,57,143,146,155,159,162,178,181,185,188,194,197,203,217,221,228,231,267,270,274,277,391,402,421,462,469,472,479,596,599,603,606,613,620,628,633,640,644,647,664,677,681,690,699,707,711,714,717,721,724,766,769,773,824,832,836,840,843,847,850,854,860,864,870,874,877,881,884],[11,12,13],"p",{},[14,15,16],"strong",{},"TL;DR",[18,19,20,24,27],"ul",{},[21,22,23],"li",{},"في 30 أكتوبر 2026 نشرت المفوضية الأوروبية المواصفات الفنية لواجهة API لسجل جواز المنتج الرقمي: دليل تكامل، وملفات OpenAPI، ودليلَي مصادقة لحسابات الخدمة وللاستضافة الذاتية، ونماذج البيانات الدلالية للبطاريات.",[21,25,26],{},"التسجيل غير متزامن ويعمل بمبدأ «الكل أو لا شيء»: ترسل حتى 100 جواز في كل عملية إرسال، ويجلب السجل كل جواز من عنوانه على الويب ويتحقق منه، وإذا فشل عنصر واحد فلا يُسجَّل أي منها.",[21,28,29],{},"البطاريات هي مجموعة المنتجات الوحيدة المحدّدة حتى الآن. تحتاج بطاريات المركبات الكهربائية (EV) وبطاريات وسائل النقل الخفيفة (LMT) والبطاريات الصناعية التي تزيد سعتها عن 2 كيلوواط ساعة إلى جواز مسجّل اعتبارا من 18 فبراير 2027، ويجب التحقق من مؤسستك بختم إلكتروني مؤهَّل قبل أن يعمل أي استدعاء للواجهة.",[11,31,32],{},"واجهة API لسجل جواز المنتج الرقمي هي الطريقة التي تسجّل بها الشركة المصنّعة أو المستورد، أو المنصة التي تعمل لصالحهما، جوازات المنتجات الرقمية لدى الاتحاد الأوروبي دون المرور على نموذج ويب منتجا تلو الآخر. السجل نفسه قيد التشغيل منذ 20 يوليو 2026. أما ما وصل في 30 أكتوبر فهو التفاصيل التي يحتاجها المطوّر للبناء عليه: نقاط النهاية، والمصادقة، ورموز الأخطاء، وقواعد الاستطلاع الدوري (polling)، ونماذج البيانات التي يتحقق السجل من الجوازات وفقا لها.",[11,34,35,36,41],{},"هذا الدليل موجّه إلى الشخص الذي عليه أن يجعل جوازات البطاريات تظهر في السجل بحلول فبراير. وهو يتبع الوثائق بالترتيب الذي ستصادفها به، ويفصل ما حُسم عمّا لا يزال مفتوحا. لمعرفة ماهية السجل وسبب وجوده، راجع ",[37,38,40],"a",{"href":39},"\u002Far\u002Fguides\u002Feuropean-dpp-registry\u002F","شرحنا لسجل جواز المنتج الرقمي في الاتحاد الأوروبي",". كل ما يلي صحيح حتى نوفمبر 2026.",[43,44,46],"h2",{"id":45},"ما-الذي-نشرته-المفوضية-في-30-أكتوبر","ما الذي نشرته المفوضية في 30 أكتوبر؟",[11,48,49,50,56],{},"ظهرت ست وثائق فنية على ",[37,51,55],{"href":52,"rel":53},"https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fresources-documentation_en",[54],"nofollow","صفحة موارد جواز المنتج الرقمي"," التابعة للمفوضية، دون خبر يعلن عنها. وهي تأتي إلى جانب دليل المستخدم للمشغّلين الاقتصاديين الصادر في سبتمبر 2026.",[58,59,60,76],"table",{},[61,62,63],"thead",{},[64,65,66,70,73],"tr",{},[67,68,69],"th",{},"الوثيقة",[67,71,72],{},"الإصدار",[67,74,75],{},"ما الذي تقدّمه لك",[77,78,79,91,102,112,123,133],"tbody",{},[64,80,81,85,88],{},[82,83,84],"td",{},"دليل تكامل واجهة API للمشغّلين الاقتصاديين",[82,86,87],{},"1.0",[82,89,90],{},"مسار التسجيل، وتتبّع المهام، والترويسات، والاستطلاع الدوري، ومعالجة الأخطاء",[64,92,93,96,99],{},[82,94,95],{},"مواصفات OpenAPI (ملف ZIP)",[82,97,98],{},"1.0.0، EUPL-1.2",[82,100,101],{},"ثلاثة ملفات OpenAPI 3.1.0: السجل، ولوحة المتابعة (تتبّع المهام)، والملف المشترك",[64,103,104,107,109],{},[82,105,106],{},"دليل البيانات الدلالية",[82,108,87],{},[82,110,111],{},"كيفية نمذجة بيانات الجواز وتسلسلها والتحقق منها",[64,113,114,117,120],{},[82,115,116],{},"عناصر البيانات الدلالية (ملف ZIP)",[82,118,119],{},"core 1.0.0، batteries 1.0.0",[82,121,122],{},"مخططات JSON Schema، وسياقات JSON-LD، وأشكال SHACL، ومفردات SKOS، مع المجموعات الفرعية EV وLMT والصناعية",[64,124,125,128,130],{},[82,126,127],{},"دليل التكامل الفني لحسابات الخدمة",[82,129,87],{},[82,131,132],{},"المصادقة من آلة إلى آلة لأنظمتك",[64,134,135,138,140],{},[82,136,137],{},"دليل المصادقة للاستضافة الذاتية",[82,139,87],{},[82,141,142],{},"كيف يجب أن يتعامل خادم جوازاتك مع الطلبات الواردة من السجل",[11,144,145],{},"وفي 19 أكتوبر نشرت المفوضية أيضا الإصدار 3.2 من إرشاداتها بشأن جواز البطارية، الذي يسرد نقاط البيانات حسب فئة البطارية. نتناوله أدناه.",[11,147,148,149,154],{},"الجزء المُلزِم هو ",[37,150,153],{"href":151,"rel":152},"https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg_impl\u002F2026\u002F1778\u002Foj\u002Feng",[54],"اللائحة التنفيذية (الاتحاد الأوروبي) 2026\u002F1778"," الصادرة في 16 يوليو 2026. تنص المادة 3(b) على واجهة API للتسجيل، وتسمح المادة 8(6) بالتسجيل عبر واجهة المستخدم أو عبر واجهة API، وتشترط المادة 8(7) إجراء فحوص آلية للدلالات ومستوى التفصيل. والمواصفات هي الطريقة التي تنفّذ بها المفوضية هذه المواد.",[43,156,158],{"id":157},"ماذا-يفعل-السجل-بجوازك","ماذا يفعل السجل بجوازك؟",[11,160,161],{},"السجل فهرس، وليس مخزنا. ترسل إليه معرّف منتج فريدا (UPI) لكل جواز، وتشترط الواجهة أن يكون هذا المعرّف عنوان URL بصيغة HTTPS. عند الإرسال، يذهب السجل إلى ذلك العنوان، ويجلب الجواز، ويتحقق منه وفقا لنموذج البيانات الخاص بمجموعة المنتجات. وبعبارة دليل التكامل، فإن السجل «لا يحتفظ بمحتوى حمولة جواز المنتج الرقمي الذي يجلبه».",[11,163,164,165,168,169,173,174,177],{},"هذا الخيار التصميمي الواحد هو ما يحدّد معظم العمل الهندسي. يجب أن يكون الجواز متاحا على الإنترنت ومكتملا وصالحا ",[14,166,167],{},"في لحظة الإرسال","، لا لاحقا. إذا لم يتمكن السجل من الوصول إليه، يفشل العنصر بالرمز ",[170,171,172],"code",{},"UPI_NOT_RESOLVABLE",". وإذا لم يطابق المحتوى المخطط، يفشل بالحالة ",[170,175,176],{},"ITEM_NON_COMPLIANT",". أي سير عمل يسجّل أولا ثم ينشر الجواز بعد ذلك لن ينجح.",[11,179,180],{},"بعد نجاح التسجيل، تمنحك المادة 9 من اللائحة التنفيذية إثبات تسجيل مختوما بالختم الإلكتروني المؤهَّل للمفوضية، ومتاحا لمدة 90 يوما. نزّله واحفظه في أرشيفك؛ فهو دليلك على أن الجواز سُجّل وعلى توقيت تسجيله.",[43,182,184],{"id":183},"ما-الذي-يجب-أن-يكون-جاهزا-قبل-أول-استدعاء-للواجهة","ما الذي يجب أن يكون جاهزا قبل أول استدعاء للواجهة؟",[11,186,187],{},"أكثر مما تتوقعه معظم الفرق، وتقريبا لا شيء منه برمجة.",[11,189,190,193],{},[14,191,192],{},"مؤسسة تم التحقق منها."," يسجّل المستخدمون الدخول عبر EU Login، لكن الواجهة ترفض الطلبات الواردة من مؤسسة لم يتم التحقق منها، برمز 403. بموجب المادة 4 من اللائحة التنفيذية، يثبت الشخص الاعتباري هويته ومقر تأسيسه بختم إلكتروني مؤهَّل (أو بشهادة إلكترونية للسمات)؛ ويمكن للتاجر الفرد استخدام توقيع إلكتروني مؤهَّل أو هوية إلكترونية (eID) بمستوى ضمان eIDAS «مرتفع». عمليا، يعطيك السجل إقرارا مختوما من المفوضية، فتوقّعه أو تختمه. وتستمر حالة التحقق حتى انتهاء صلاحية وسائل التعريف الخاصة بك، ولمدة لا تتجاوز ثلاث سنوات، وبعدها عليك التحقق من جديد.",[11,195,196],{},"يأتي الختم المؤهَّل من مزوّد خدمة ثقة مؤهَّل، وله إجراءات تحقق من الهوية خاصة به. إذا لم تكن شركتك تملك ختما، فابدأ من هنا.",[11,198,199,202],{},[14,200,201],{},"مسؤول وحساب خدمة."," ينشئ مسؤول مؤسستك حسابات الخدمة في واجهة السجل. حساب الخدمة هوية غير بشرية مرتبطة بمؤسستك التي تم التحقق منها، ويحتاج إلى الدور الذي يسمح بتسجيل جوازات المنتجات الرقمية. تُستخلص المؤسسة من رمز الوصول، لذا لا تمرّر أبدا معرّف المؤسسة في الطلب.",[11,204,205,208,209,212,213,216],{},[14,206,207],{},"تصنيف المنتج."," تحدّد كل عملية إرسال مجموعة منتجات ومجموعة فرعية، تأخذهما من ",[170,210,211],{},"GET \u002Fapi\u002Fv1\u002Fdpp\u002Fproduct-groups"," بدلا من تثبيتهما في الشيفرة. واليوم يعيد هذا الاستدعاء مجموعة واحدة، ",[170,214,215],{},"BATTERIES","، مع المجموعات الفرعية EV وLMT والصناعية.",[43,218,220],{"id":219},"كيف-يصادق-حساب-الخدمة","كيف يصادق حساب الخدمة؟",[11,222,223,224,227],{},"يستخدم السجل بيانات اعتماد العميل في OAuth 2.0 مع ",[170,225,226],{},"private_key_jwt",". والدليل صريح: «أسرار العميل المشتركة غير مدعومة». يحتفظ نظامك بمفتاح خاص، ويوقّع تأكيدا قصير العمر، ويستبدله برمز وصول.",[11,229,230],{},"التفاصيل التي ستُوقع الناس في الخطأ:",[18,232,233,239,249,255,261],{},[21,234,235,238],{},[14,236,237],{},"مفاتيح المنحنى الإهليلجي فقط"," (ES256 أو ES384 أو ES512). لا تُقبل مفاتيح RSA. ترفع المفتاح العام بصيغة JWK أو PEM، ويوصي الدليل بحفظ المفتاح الخاص في وحدة أمان للأجهزة (HSM).",[21,240,241,244,245,248],{},[14,242,243],{},"تأكيدات قصيرة."," ينبغي أن تنتهي صلاحية تأكيد العميل خلال 60 إلى 120 ثانية، وألا تتجاوز أبدا 5 دقائق، مع قيمة ",[170,246,247],{},"jti"," جديدة في كل مرة.",[21,250,251,254],{},[14,252,253],{},"مؤشر المورد."," يجب أن يحدّد طلب الرمز السجلَّ بوصفه المورد، باستخدام القيمة المنشورة لكل بيئة.",[21,256,257,260],{},[14,258,259],{},"رموز قصيرة."," تدوم رموز الوصول 15 دقيقة كحد أقصى، لذا على عميلك تجديدها أثناء عمليات الدفعات الطويلة.",[21,262,263,266],{},[14,264,265],{},"الحدود."," حتى 5 حسابات خدمة لكل مؤسسة، وبيانا اعتماد نشطان لكل حساب، وهو ما يتيح تدوير المفاتيح دون توقف. ويوصى بأن تدوم بيانات الاعتماد سنة واحدة، وسنتين كحد أقصى.",[11,268,269],{},"إذا كانت منصة تسجّل الجوازات نيابة عنك، فإن النموذج الذي تصفه وثائق الإصدار 1.0 هو حساب خدمة داخل مؤسستك التي تم التحقق منها. هكذا يعمل التكامل اليوم، لكنه ليس المسار الوحيد الذي يسمح به القانون. تنص اللائحة التنفيذية أيضا على أطراف ثالثة تم التحقق منها تعمل نيابة عن المشغّل: تسمح المادة 6(1) للمشغّلين الذين تم التحقق منهم بتفويض حقوق الوصول إلى أطراف ثالثة حيثما ينص قانون الاتحاد على ذلك، وتسمح المادة 8(2) لطرف ثالث تم التحقق منه بتنفيذ إجراءات التسجيل في تلك الحالة، وتشترط المادة 19(4) أن يخضع الطرف الثالث المفوَّض من المشغّل لإجراءات التحقق الخاصة به. وسيحتفظ السجل أيضا بقائمة بمزوّدي خدمات جواز المنتج الرقمي الذين تم التحقق منهم (المادة 3(f)). أما كيف سيعمل هذا التفويض من الناحية الفنية فلم يُوصف بعد في أدلة التكامل. وأيًّا كان المسار المستخدم، يظل المشغّل الاقتصادي مسؤولا مسؤولية كاملة عن الامتثال.",[43,271,273],{"id":272},"كيف-تعمل-عملية-إرسال-التسجيل","كيف تعمل عملية إرسال التسجيل؟",[11,275,276],{},"يتكوّن المسار من أربعة استدعاءات. تجلب مجموعات المنتجات، ثم ترسل، ثم تتابع المهمة عبر ما تسمّيه المفوضية واجهة Activity Dashboard API.",[278,279,284],"pre",{"className":280,"code":281,"language":282,"meta":283,"style":283},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","POST \u002Fapi\u002Fv1\u002Fdpp\u002Fsubmission\nAuthorization: Bearer \u003Caccess token>\nIdempotency-Key: 7f3c9a2e-batch-2027-02-01-001\nContent-Type: application\u002Fjson\n\n{\n  \"productGroup\": \"BATTERIES\",\n  \"productSubGroup\": \"EV\",\n  \"submissionItems\": [\n    {\n      \"uniqueProductIdentifier\": \"https:\u002F\u002Fexample.com\u002Fdpp\u002Fbattery\u002F0001\",\n      \"granularity\": \"item\",\n      \"batchIdentifier\": \"xxx-000\",\n      \"modelIdentifier\": \"yyy-111\"\n    }\n  ]\n}\n","http","",[170,285,286,294,300,306,312,319,325,331,337,343,349,355,361,367,373,379,385],{"__ignoreMap":283},[287,288,291],"span",{"class":289,"line":290},"line",1,[287,292,293],{},"POST \u002Fapi\u002Fv1\u002Fdpp\u002Fsubmission\n",[287,295,297],{"class":289,"line":296},2,[287,298,299],{},"Authorization: Bearer \u003Caccess token>\n",[287,301,303],{"class":289,"line":302},3,[287,304,305],{},"Idempotency-Key: 7f3c9a2e-batch-2027-02-01-001\n",[287,307,309],{"class":289,"line":308},4,[287,310,311],{},"Content-Type: application\u002Fjson\n",[287,313,315],{"class":289,"line":314},5,[287,316,318],{"emptyLinePlaceholder":317},true,"\n",[287,320,322],{"class":289,"line":321},6,[287,323,324],{},"{\n",[287,326,328],{"class":289,"line":327},7,[287,329,330],{},"  \"productGroup\": \"BATTERIES\",\n",[287,332,334],{"class":289,"line":333},8,[287,335,336],{},"  \"productSubGroup\": \"EV\",\n",[287,338,340],{"class":289,"line":339},9,[287,341,342],{},"  \"submissionItems\": [\n",[287,344,346],{"class":289,"line":345},10,[287,347,348],{},"    {\n",[287,350,352],{"class":289,"line":351},11,[287,353,354],{},"      \"uniqueProductIdentifier\": \"https:\u002F\u002Fexample.com\u002Fdpp\u002Fbattery\u002F0001\",\n",[287,356,358],{"class":289,"line":357},12,[287,359,360],{},"      \"granularity\": \"item\",\n",[287,362,364],{"class":289,"line":363},13,[287,365,366],{},"      \"batchIdentifier\": \"xxx-000\",\n",[287,368,370],{"class":289,"line":369},14,[287,371,372],{},"      \"modelIdentifier\": \"yyy-111\"\n",[287,374,376],{"class":289,"line":375},15,[287,377,378],{},"    }\n",[287,380,382],{"class":289,"line":381},16,[287,383,384],{},"  ]\n",[287,386,388],{"class":289,"line":387},17,[287,389,390],{},"}\n",[11,392,393,394,397,398,401],{},"يتبع هذا المحتوى المثال الرسمي. الحقلان ",[170,395,396],{},"uniqueProductIdentifier"," و",[170,399,400],{},"granularity"," (المادة أو الدفعة أو الطراز) مطلوبان لكل عنصر؛ أما معرّفا الدفعة والطراز فاختياريان.",[11,403,404,405,408,409,412,413,416,417,420],{},"يجيب السجل بـ ",[170,406,407],{},"202 Accepted"," مع ",[170,410,411],{},"taskId",". ويعني الرمز 202 فقط أن الطلب قُبل للمعالجة. بعد ذلك تستطلع ",[170,414,415],{},"GET \u002Fapi\u002Fv1\u002Ftasks\u002F{taskId}","، وعندما تحتاج إلى معرفة العناصر التي نجحت، ",[170,418,419],{},"GET \u002Fapi\u002Fv1\u002Ftasks\u002F{taskId}\u002Fitems","، الذي يعيد JSON أو CSV.",[11,422,423,424,427,428,397,431,397,434,437,438,441,442,445,446,437,449,452,453,455,456,458,459,461],{},"هناك حقلا حالة مهمّان، ولكل منهما معنى مختلف. تنتقل ",[170,425,426],{},"status"," الخاصة بالمهمة بين ",[170,429,430],{},"PENDING",[170,432,433],{},"PROCESSING",[170,435,436],{},"COMPLETED"," أو ",[170,439,440],{},"ERROR",". وبعد الاكتمال، يقول ",[170,443,444],{},"outcomeResult"," إما ",[170,447,448],{},"SUCCEEDED",[170,450,451],{},"FAILED",". يمكن أن تكون المهمة ",[170,454,436],{}," بنتيجة ",[170,457,451],{},": نجحت المعالجة، ولم تجتز بياناتك التحقق. أما ",[170,460,440],{}," فهو عطل فني من جانب السجل.",[11,463,464,465,468],{},"لا توجد خطافات ويب (webhooks). يوصي الدليل بالاستطلاع بعد 1 و1 و2 و3 و5 و8 و13 و21 و34 و55 ثانية، ثم كل 60 ثانية على الأكثر، وتتقدّم ترويسة ",[170,466,467],{},"Retry-After"," دائما على جدولك الخاص.",[11,470,471],{},"القاعدة التي ينبغي أن تشكّل تصميم دفعاتك هي الذرّية. تضم عملية الإرسال من 1 إلى 100 جواز من مجموعة المنتجات والمجموعة الفرعية نفسيهما، وإذا كان أي واحد منها غير ممتثل، فلا يُسجَّل أي منها، بما في ذلك تلك التي اجتازت التحقق. سجل واحد سيئ في دفعة من 100 يعطّل 99 سجلا سليما. من جهتنا، كنا سنتحقق من كل جواز محليا وفق المخططات المنشورة قبل الإرسال، ونبقي الدفعات أصغر ما دامت بياناتك لم تستقر بعد، ونعيد إرسال العناصر السليمة بسرعة بعد أي فشل.",[11,473,474,475,478],{},"ترويسة ",[170,476,477],{},"Idempotency-Key"," إلزامية، بحد أقصى 128 حرفا. إعادة المحاولة بالمفتاح نفسه تعيد المهمة الأصلية بدلا من إنشاء مهمة مكررة، وهذا ما تريده بعد انتهاء المهلة أو بعد خطأ 500. أما عملية الإرسال المعدَّلة فتحتاج إلى مفتاح جديد؛ وإعادة استخدام مفتاح لمحتوى مختلف تعيد الرمز 409.",[58,480,481,491],{},[61,482,483],{},[64,484,485,488],{},[67,486,487],{},"الحد أو القاعدة",[67,489,490],{},"القيمة",[77,492,493,501,509,517,525,533,540,548,556,564,572,580,588],{},[64,494,495,498],{},[82,496,497],{},"الجوازات في كل عملية إرسال",[82,499,500],{},"من 1 إلى 100، من مجموعة المنتجات والمجموعة الفرعية نفسيهما",[64,502,503,506],{},[82,504,505],{},"الحد الأقصى لحجم محتوى الطلب",[82,507,508],{},"10 ميغابايت",[64,510,511,514],{},[82,512,513],{},"سلوك الدفعة",[82,515,516],{},"الكل أو لا شيء",[64,518,519,522],{},[82,520,521],{},"صيغة UPI",[82,523,524],{},"عنوان URL بصيغة HTTPS، يمكن الوصول إليه عند الإرسال",[64,526,527,530],{},[82,528,529],{},"مستوى التفصيل",[82,531,532],{},"مطلوب: المادة أو الدفعة أو الطراز",[64,534,535,537],{},[82,536,477],{},[82,538,539],{},"إلزامي، 128 حرفا كحد أقصى",[64,541,542,545],{},[82,543,544],{},"مدة صلاحية رمز الوصول",[82,546,547],{},"15 دقيقة كحد أقصى",[64,549,550,553],{},[82,551,552],{},"مدة صلاحية تأكيد العميل",[82,554,555],{},"يوصى بـ 60 إلى 120 ثانية، 5 دقائق كحد أقصى",[64,557,558,561],{},[82,559,560],{},"أنواع المفاتيح",[82,562,563],{},"EC فقط: ES256 وES384 وES512",[64,565,566,569],{},[82,567,568],{},"حسابات الخدمة",[82,570,571],{},"5 كحد أقصى لكل مؤسسة، وبيانا اعتماد نشطان لكل منها",[64,573,574,577],{},[82,575,576],{},"تحديثات الحالة",[82,578,579],{},"الاستطلاع الدوري فقط، بلا خطافات ويب",[64,581,582,585],{},[82,583,584],{},"عمليات إعادة التوجيه المتّبعة عند جلب الجواز",[82,586,587],{},"3 كحد أقصى عبر السلسلة كاملة",[64,589,590,593],{},[82,591,592],{},"إثبات التسجيل",[82,594,595],{},"مختوم من المفوضية، متاح لمدة 90 يوما",[11,597,598],{},"رموز الأخطاء تقليدية (400 و403 و409 و413 و422 و429 و500)، ويحدّد الدليل لكل منها ما إذا كان يجب إعادة المحاولة بالمفتاح نفسه أو بمفتاح جديد. وعادة ما يعني الرمز 403 أن المؤسسة لم يتم التحقق منها أو أن حساب الخدمة يفتقر إلى دور التسجيل.",[43,600,602],{"id":601},"ما-الذي-يتغير-إذا-استضفت-الجوازات-بنفسك","ما الذي يتغير إذا استضفت الجوازات بنفسك؟",[11,604,605],{},"تحمل جوازات البطاريات بيانات عامة وبيانات مقيّدة، ويقرأ السجل كلتيهما عند التحقق. إذا كان الجواز على خادمك الخاص، فعلى ذلك الخادم أن يتعرّف على السجل وأن يعرض له أكثر مما يعرضه للعامة.",[11,607,608,609,612],{},"يعمل مضيف جوازاتك بوصفه خادم موارد في OAuth 2.0. يطلب السجل أولا معرّف UPI دون بيانات اعتماد ويتوقع الجواز العام. ثم يطلب العنوان نفسه برمز حامل (bearer token) صادر عن خدمة المصادقة التابعة للمفوضية، ويتوقع البيانات العامة مضافا إليها البيانات المقيّدة. الرمز قصير العمر (ES384، بحد أقصى 120 ثانية)، ويحمل النطاق ",[170,610,611],{},"dpp:registry:read","، وموجّه إلى أصل HTTPS الخاص بمضيفك. تتحقق منه فقط وفق المفاتيح الموجودة في JWKS التي تنشرها المفوضية، وليس أبدا وفق مفاتيح يُشار إليها من داخل الرمز.",[11,614,615,616,619],{},"قواعد الاستجابة صارمة. بلا رمز: أعد الجواز العام. رمز صالح وطالب مخوَّل: أعد البيانات العامة والمقيّدة. رمز موجود لكنه غير صالح: أعد 401، دون الرجوع إلى العرض العام. رمز صالح بنطاق أو طالب خاطئ: 403. أرسل ",[170,617,618],{},"Vary: Authorization"," حتى تفصل ذاكرات التخزين المؤقت بين النسختين، واستخدم TLS 1.2 أو أحدث. صيغة JSON هي صيغة الاستجابة الأساسية؛ وتُقبل أيضا JSON-LD وXML.",[11,621,622,623,627],{},"يصف الدليل طالبا واحدا فقط، هو السجل نفسه. ولا يغطي كيف ستصادق السلطات أو جهات إعادة التدوير أو الأطراف الأخرى ذات المصلحة المشروعة، لذا ستحتاج إلى حل منفصل لها؛ ويتناول دليلنا حول ",[37,624,626],{"href":625},"\u002Fguides\u002Fdigital-product-passport-access-rights\u002F","حقوق الوصول إلى جواز المنتج الرقمي"," من يحق له الوصول إلى ماذا. كما لا تتم بعد معالجة معرّفات المشغّلين الفريدة؛ إذ يخطط الدليل لها في إصدار مستقبلي.",[629,630,632],"h3",{"id":631},"أين-يندرج-gs1-digital-link","أين يندرج GS1 Digital Link",[11,634,635,636,639],{},"يتبع السجل عمليات إعادة التوجيه، بحد أقصى ثلاث عبر عملية الحل كاملة، ويحلّ معرّف UPI وكل عملية إعادة توجيه دون بيانات اعتماد، لذا يجب أن تكون كل خطوة متاحة للعامة. وهذا متوافق مع المُحلِّل (resolver). يُعدّ عنوان URI بمعيار GS1 Digital Link على نطاقك الخاص، مثل ",[170,637,638],{},"https:\u002F\u002Fid.yourbrand.com\u002F01\u002F09520123456788\u002F21\u002FSN0001","، إحدى الطرق لمنح كل بطارية معرّف HTTPS دائما يقود إلى جوازها ويعمل أيضا كرمز QR على المنتج. وهو ليس مطلوبا؛ فأي عنوان URL ثابت بصيغة HTTPS يستوفي قاعدة الصيغة في الواجهة. إذا كنت تستخدم مُحلِّلا، فاحسب القفزات: سلسلة تمرّ من نطاق رمز QR إلى المُحلِّل إلى مزوّد الاستضافة إلى العنوان النهائي تستهلك الثلاث كلها بالفعل. وينصح الدليل أيضا بتجنّب عمليات إعادة التوجيه بعد المصادقة، بحيث يصل الطلب المخوَّل مباشرة إلى الجواز.",[43,641,643],{"id":642},"ما-نماذج-البيانات-التي-يتحقق-السجل-وفقا-لها","ما نماذج البيانات التي يتحقق السجل وفقا لها؟",[11,645,646],{},"يحتوي ملف ZIP لعناصر البيانات الدلالية على النماذج التي يفحصها السجل. لا يوجد منها اليوم سوى اثنين: نموذج أساسي ونموذج للبطاريات، كلاهما بالإصدار 1.0.0، مع مخططات للمجموعات الفرعية لبطاريات EV وLMT والبطاريات الصناعية. ويأتي كل منها بصيغة JSON Schema (مسودة 2020-12)، وسياقات JSON-LD، وأشكال SHACL، ومفردات SKOS، إضافة إلى فهرس DCAT-AP. ويصف الدليل أيضا صيغة XSD، التي لا تتضمنها هذه النسخة.",[11,648,649,650,653,654,397,657,397,660,663],{},"المخططات مقسّمة حسب مستوى الوصول: عرض عام (",[170,651,652],{},"pub",") وثلاثة عروض مقيّدة (",[170,655,656],{},"res1",[170,658,659],{},"res2",[170,661,662],{},"res3","). يجب أن يقدّم جوازك الحقول الصحيحة للطالب الصحيح، والمخطط يخبرك أين يقع كل حقل. ويتضمن ملف ZIP أيضا نماذج مطابقة لكل مخطط، وهي تصلح كأول بيانات اختبار.",[11,665,666,667,671,672,676],{},"توصف أربع صيغ تسلسل (JSON وJSON-LD وXML وRDF)، لكن JSON هي الوحيدة الإلزامية للتسجيل، تماشيا مع EN 18216:2026. ويستشهد الدليل أيضا بـ EN 18223:2026 بشأن قابلية التشغيل البيني. نشرح كلا المعيارين في ",[37,668,670],{"href":669},"\u002Far\u002Fguides\u002Fcen-dpp-standards\u002F","دليل معايير CEN لجواز المنتج الرقمي","، ونشرح سبب أهمية البيانات المهيكلة في دليلنا حول ",[37,673,675],{"href":674},"\u002Far\u002Fguides\u002Fmachine-readable-digital-product-passport\u002F","جواز المنتج الرقمي القابل للقراءة آليا",". وتضيف المادة 12 من اللائحة التنفيذية أن المستودع الدلالي مجاني الاستخدام وله واجهات API عامة.",[43,678,680],{"id":679},"ما-الذي-يضيفه-الإصدار-32-من-إرشادات-البطاريات","ما الذي يضيفه الإصدار 3.2 من إرشادات البطاريات؟",[11,682,683,684,689],{},"تسرد ",[37,685,688],{"href":686,"rel":687},"https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fbatteries_en",[54],"الوثيقة الإرشادية: جواز البطاريات الرقمي، نقاط البيانات حسب الفئة","، الإصدار 3.2 بتاريخ 19 أكتوبر 2026، 71 نقطة بيانات لبطاريات EV وLMT والبطاريات الصناعية. وهي إرشادات، وتنص بنفسها على أنها غير ملزمة قانونا؛ فالالتزامات تأتي من لائحة البطاريات (الاتحاد الأوروبي) 2023\u002F1542.",[11,691,692,693,397,695,698],{},"لكل نقطة بيانات وكل فئة بطارية، تعطي الوثيقة حالة: إلزامية؛ أو اختيارية، تُملأ إذا كانت البيانات متاحة؛ أو حسب الاقتضاء؛ أو لأنواع معيّنة من البطاريات فقط؛ أو لا تُملأ ولا تُعرض اعتبارا من فبراير 2027. هذه الحالة الأخيرة هي المفيدة للتخطيط. فإعلان البصمة الكربونية وملصقها، على سبيل المثال، مصنّفان على أنهما لا يُملآن في فبراير 2027 لأن صيغتهما لا تزال تنتظر قانونا تنفيذيا، وتعليمات الاستخدام معلّقة بانتظار حزمة Omnibus. وتحمل كل نقطة بيانات أيضا مستوى وصول: عام، أو مقيّد بالأشخاص ذوي المصلحة المشروعة والهيئات المُخطَرة وسلطات الدول الأعضاء والمفوضية، أو مستويات مقيّدة أضيق. وهذه المستويات هي ما تنفّذه عروض المخطط ",[170,694,652],{},[170,696,697],{},"res",".",[11,700,701,702,706],{},"يغطي ",[37,703,705],{"href":704},"\u002Far\u002Fguides\u002Fbattery-passport\u002F","دليلنا حول جواز البطارية"," المتطلبات القانونية. أما لعمل التكامل، فاستخدم الإصدار 3.2 كجدول ربط بين بيانات منتجك وحقول المخطط.",[43,708,710],{"id":709},"ما-الذي-حُسم-وما-الذي-لا-يزال-مفتوحا","ما الذي حُسم، وما الذي لا يزال مفتوحا؟",[11,712,713],{},"ما حُسم: نقاط النهاية، ونموذج المصادقة، وقاعدة الدفعة الذرّية، والاستطلاع الدوري، ونموذج بيانات البطاريات، واشتراط أن تكون الجوازات متاحة على الإنترنت عند الإرسال. والتحقق بالختم المؤهَّل منصوص عليه في اللائحة التنفيذية نفسها.",[11,715,716],{},"ما لا يزال مفتوحا حتى نوفمبر 2026: كيف سيعمل فنيا التسجيل من قِبل أطراف ثالثة تم التحقق منها نيابة عن المشغّل، ونماذج البيانات لأي شيء غير البطاريات، وصيغة البصمة الكربونية، وكيف تصادق الأطراف الأخرى على الجوازات المستضافة ذاتيا، ومعرّفات المشغّلين الفريدة. وتغطي اللائحة التنفيذية أيضا منتجات البناء والألعاب والمنظفات، التي لا نموذج بيانات لها بعد؛ وبالنسبة للمنتجات غير البطاريات، تبدأ الالتزامات بعد 18 شهرا على الأقل من كل قانون تفويضي. ويجب على الدول الأعضاء تسمية المسؤولين عن السجلات الوطنية لديها بحلول 18 فبراير 2027 (المادة 7).",[43,718,720],{"id":719},"ثغرات-في-وثائق-الإصدار-10","ثغرات في وثائق الإصدار 1.0",[11,722,723],{},"يحتوي الإصدار الأول دائما على تناقضات، ومن المفيد معرفة هذه قبل أن تكتب الشيفرة:",[18,725,726,741,744,755],{},[21,727,728,729,732,733,736,737,740],{},"يحدّد دليل حسابات الخدمة عنوان قاعدة الواجهة على أنه ",[170,730,731],{},"reg.product-passport.ec.europa.eu","، بينما تستخدم ملفات OpenAPI العنوان ",[170,734,735],{},"registry.product-passport.ec.europa.eu"," (و",[170,738,739],{},"registry.acc.product-passport.ec.europa.eu"," لبيئة القبول). تأكّد من القيمة الحالية في السجل قبل إعداد بيئة الإنتاج.",[21,742,743],{},"حد الـ 100 عنصر منصوص عليه في الدليل لكنه غير مفروض في مخطط OpenAPI، لذا فإن العميل المولَّد من المخطط سيبني دون اعتراض طلبا من 101 عنصر.",[21,745,746,747,750,751,754],{},"يقول دليل التكامل إن الأخطاء تعيد المعرّف باسم ",[170,748,749],{},"traceId","، بينما يسمّيه مخطط الأخطاء في OpenAPI ",[170,752,753],{},"correlationId",". سجّل كليهما.",[21,756,757,758,761,762,765],{},"تستخدم الواجهة رمز المجموعة الفرعية ",[170,759,760],{},"EV","، بينما تستخدم العناصر الدلالية ",[170,763,764],{},"evb"," في مساراتها. اربط بينهما صراحة.",[11,767,768],{},"لا يمنع أيٌّ من هذا التكامل، لكن أعد التحقق منها مع كل إصدار جديد من الوثائق.",[43,770,772],{"id":771},"ما-الذي-يجب-فعله-الآن","ما الذي يجب فعله الآن",[774,775,776,782,788,794,800,806,812,818],"ol",{},[21,777,778,781],{},[14,779,780],{},"احصل على ختم إلكتروني مؤهَّل"," من مزوّد خدمة ثقة مؤهَّل، إذا لم تكن شركتك تملك واحدا بالفعل، وتحقّق من مؤسستك في السجل. هذه هي الخطوة الأطول مهلة بين كل ما في هذه القائمة.",[21,783,784,787],{},[14,785,786],{},"سجّل في بيئة القبول"," وعيّن مسؤولا يمكنه إنشاء حسابات الخدمة.",[21,789,790,793],{},[14,791,792],{},"قرّر أين ستوجد الجوازات:"," على خادمك الخاص، الذي يجب عليه حينئذ تطبيق قواعد المصادقة للاستضافة الذاتية، أو لدى مزوّد يطبّقها بالفعل.",[21,795,796,799],{},[14,797,798],{},"ثبّت معرّفات UPI الخاصة بك."," اختر نمط عنوان URL ثابتا بصيغة HTTPS لكل بطارية، وقرّر مستوى التفصيل (المادة أو الدفعة أو الطراز)، واحسب عمليات إعادة التوجيه في السلسلة.",[21,801,802,805],{},[14,803,804],{},"اربط بياناتك بالإصدار 3.2 وبمخططات البطاريات،"," حقلا بحقل، بما في ذلك العروض العامة والمقيّدة. ضع علامة على ما ليس مطلوبا في فبراير 2027 حتى لا يضيّع أحد وقته عليه.",[21,807,808,811],{},[14,809,810],{},"تحقّق محليا قبل الإرسال،"," وفق مخططات JSON Schema المرفقة، وصمّم الدفعات بحيث لا يعطّل سجل واحد سيئ بقية السجلات.",[21,813,814,817],{},[14,815,816],{},"ابنِ العميل بالشكل الصحيح:"," مفاتيح EC في وحدة HSM، وتجديد الرموز، ومفاتيح عدم تكرار (idempotency) يمكنك إعادة إنتاجها، واستطلاع دوري وفق متتالية فيبوناتشي، وحفظ كل إثبات تسجيل.",[21,819,820,823],{},[14,821,822],{},"أجرِ اختبارا كاملا في بيئة القبول"," قبل 18 فبراير 2027 بوقت كافٍ، بما في ذلك دفعة فاشلة وتدوير مفتاح.",[11,825,826,827,831],{},"Digital Link شريك حلول لدى GS1، وتبني منصتنا جوازات البطاريات والمنتجات على معرّف GS1 Digital Link دائم لكل منتج، مع تقديم البيانات العامة والمقيّدة من السجل نفسه. نحن نُعِدّ تكاملنا الخاص مع السجل. ويتضمّن ذلك ثلاث خطوات منفصلة: الحصول على ختمنا الإلكتروني المؤهَّل، وإتمام التحقق منا في السجل، وبناء اتصال واجهة برمجة التطبيقات (API) واختباره. لسنا متصلين بالسجل بعد. إذا أردت التخطيط لتكاملك مع السجل، أو التحقق مما إذا كانت بيانات جوازك ستجتاز التحقق، ",[37,828,830],{"href":829},"mailto:support@digital-link.com","تواصل معنا"," وسيراجع فريقنا حالتك.",[43,833,835],{"id":834},"الأسئلة-الشائعة","الأسئلة الشائعة",[629,837,839],{"id":838},"هل-واجهة-api-لسجل-جواز-المنتج-الرقمي-إلزامية","هل واجهة API لسجل جواز المنتج الرقمي إلزامية؟",[11,841,842],{},"لا. تسمح المادة 8(6) من اللائحة التنفيذية (الاتحاد الأوروبي) 2026\u002F1778 بالتسجيل عبر واجهة المستخدم أو عبر واجهة API. عمليا، كل من يسجّل أكثر من عدد قليل من الجوازات سيرغب في استخدام الواجهة.",[629,844,846],{"id":845},"هل-يخزّن-السجل-بيانات-جوازي","هل يخزّن السجل بيانات جوازي؟",[11,848,849],{},"لا. فهو يجلب الجواز من عنوانه عند الإرسال للتحقق منه، وينص دليل التكامل على أنه لا يحتفظ بالمحتوى الذي يجلبه. يبقى الجواز حيث تستضيفه، ولهذا يجب أن يكون الوصول إليه ممكنا عند الإرسال.",[629,851,853],{"id":852},"هل-يمكنني-استخدام-مفتاح-rsa-أو-سر-عميل-لحساب-الخدمة-الخاص-بي","هل يمكنني استخدام مفتاح RSA أو سر عميل لحساب الخدمة الخاص بي؟",[11,855,856,857,859],{},"لا. تصادق حسابات الخدمة باستخدام ",[170,858,226],{}," بمفاتيح المنحنى الإهليلجي (ES256 أو ES384 أو ES512). أسرار العميل المشتركة ومفاتيح RSA غير مدعومة.",[629,861,863],{"id":862},"ماذا-يحدث-إذا-فشل-جواز-واحد-في-دفعة-ما-في-التحقق","ماذا يحدث إذا فشل جواز واحد في دفعة ما في التحقق؟",[11,865,866,867,869],{},"تفشل عملية الإرسال بأكملها ولا يُسجَّل أي من جوازاتها. تكتمل المهمة بنتيجة ",[170,868,451],{},"، وتخبرك النتائج الخاصة بكل عنصر بالعناصر التي تسببت في ذلك. أصلحها وأعد الإرسال بمفتاح عدم تكرار (idempotency key) جديد.",[629,871,873],{"id":872},"هل-أحتاج-إلى-gs1-digital-link-لتسجيل-جواز","هل أحتاج إلى GS1 Digital Link لتسجيل جواز؟",[11,875,876],{},"لا. يجب أن يكون معرّف المنتج الفريد عنوان URL بصيغة HTTPS يُحلّ إلى الجواز. ويُعدّ عنوان URI بمعيار GS1 Digital Link على نطاقك الخاص إحدى طرق استيفاء ذلك، ويؤدي أيضا دور رمز QR للمنتج، لكن أي عنوان URL ثابت بصيغة HTTPS مقبول.",[629,878,880],{"id":879},"متى-يجب-تسجيل-جوازات-البطاريات","متى يجب تسجيل جوازات البطاريات؟",[11,882,883],{},"بالنسبة لبطاريات المركبات الكهربائية وبطاريات وسائل النقل الخفيفة والبطاريات الصناعية التي تزيد سعتها عن 2 كيلوواط ساعة، ينطبق التزام جواز البطارية بموجب اللائحة (الاتحاد الأوروبي) 2023\u002F1542 اعتبارا من 18 فبراير 2027. السجل وبيئة القبول الخاصة به مفتوحان الآن، لذا يتوفر وقت للاختبار أولا.",[885,886,887],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":283,"searchDepth":302,"depth":302,"links":889},[890,891,892,893,894,895,898,899,900,901,902,903],{"id":45,"depth":296,"text":46},{"id":157,"depth":296,"text":158},{"id":183,"depth":296,"text":184},{"id":219,"depth":296,"text":220},{"id":272,"depth":296,"text":273},{"id":601,"depth":296,"text":602,"children":896},[897],{"id":631,"depth":302,"text":632},{"id":642,"depth":296,"text":643},{"id":679,"depth":296,"text":680},{"id":709,"depth":296,"text":710},{"id":719,"depth":296,"text":720},{"id":771,"depth":296,"text":772},{"id":834,"depth":296,"text":835,"children":904},[905,906,907,908,909,910],{"id":838,"depth":302,"text":839},{"id":845,"depth":302,"text":846},{"id":852,"depth":302,"text":853},{"id":862,"depth":302,"text":863},{"id":872,"depth":302,"text":873},{"id":879,"depth":302,"text":880},null,"صدرت مواصفات واجهة API لسجل جواز المنتج الرقمي. كيف يعمل التسجيل وحسابات الخدمة والجوازات المستضافة ذاتيا، وما على مصنّعي البطاريات فعله قبل 18 فبراير 2027.","md","واجهة API لسجل جواز المنتج الرقمي: كيف تسجّل جوازات البطاريات لدى الاتحاد الأوروبي خطوة بخطوة","مهندسان في مختبر لاختبار البطاريات، تشير إحداهما إلى حاسوب محمول بينما يحمل الآخر وحدة بطارية عليها ملصق صغير برمز QR","article",{},"\u002Fimages\u002F2026\u002F11\u002Fdpp-registry-api-hero.webp","\u002Far\u002Fguides\u002Fdpp-registry-api","2026-11-10T13:00:00+01:00",{"title":5,"description":912},"\u002Far\u002Fguides\u002Fdpp-registry-api\u002F","ar\u002Fguides\u002Fdpp-registry-api","GceAXUxqqcSZsXXU4MgoACQXzB4rX2Yleq1v_4MJvRs",[926,933,939],{"path":927,"sourcePath":928,"title":929,"heading":930,"ogImage":931,"publishedAt":932},"\u002Far\u002Fguides\u002Fagentic-commerce","\u002Far\u002Fguides\u002Fagentic-commerce\u002F","التجارة الوكيلة: كيف يشتري وكلاء الذكاء الاصطناعي وما يلزم منتجك","التجارة الوكيلة: كيف يشتري وكلاء الذكاء الاصطناعي، وما يحتاجه منتجك","\u002Fimages\u002F2026\u002F11\u002Fagentic-commerce-hero.webp","2026-11-03T12:13:00+01:00",{"path":934,"sourcePath":674,"title":935,"heading":936,"ogImage":937,"publishedAt":938},"\u002Far\u002Fguides\u002Fmachine-readable-digital-product-passport","جواز المنتج الرقمي القابل للقراءة آليًا، مشروحًا","جواز المنتج الرقمي القابل للقراءة آليًا: ما تشترطه ESPR، ولماذا سيقرؤه وكلاء الذكاء الاصطناعي","\u002Fimages\u002F2026\u002F11\u002Fmachine-readable-digital-product-passport-hero.webp","2026-11-02T11:00:00+01:00",{"path":940,"sourcePath":941,"title":942,"heading":943,"ogImage":944,"publishedAt":945},"\u002Far\u002Fguides\u002Fproduct-authentication-for-ai-agents","\u002Far\u002Fguides\u002Fproduct-authentication-for-ai-agents\u002F","التحقق من أصالة المنتجات لوكلاء الذكاء الاصطناعي: ما يمكن إثباته","التحقق من أصالة المنتجات لوكلاء الذكاء الاصطناعي: كيف يتأكد الوكيل من أن المنتج أصلي","\u002Fimages\u002F2026\u002F11\u002Fproduct-authentication-for-ai-agents-hero.webp","2026-10-30T12:13:00+01:00",1794322850086]