Crossref
https://api.crossref.org/works?rows=1
الوثائقأدلة عملية معمقة
حدد الطلب والصفحات والأخطاء والاستجابة الأصلية قبل تحويل البيانات.
آخر تحديث :

رسم توضيحي مولّد بالذكاء الاصطناعي
تجيب API عن طلب بمخطط وفي لحظة محددة. لا يثبت ذلك طلب القاعدة كلها أو ثباتها بين الاستدعاءات. افصل سجل الجمع عن التحليل.
اقرأ الوثائق الرسمية: النسخة والنطاق والشروط والمصادقة والحدود. ابحث عن تصدير رسمي للقاعدة الكاملة.
احفظ نقطة الوصول والطريقة والمعلمات والفلاتر والترتيب. فضّل المعرّفات ولا تنشر مفاتيح أو رموزاً.
سجل حالة HTTP والوقت والصيغة والأخطاء. تحقق من الحقول والوحدات؛ قد تحتوي 200 على فراغ أو خطأ وظيفي.
راجع الإجمالي والصفحات والمؤشرات. عدّ الصفوف والمعرّفات الفريدة وسجل التكرار وشرط التوقف. قد تتغير القاعدة أثناء الجمع.
احفظ الاستجابة وبصمتها ووثق التنظيف والتحويل. لا تنشر بيانات شخصية أو أسراراً في سجل عام.
اتبع تعليمات إعادة المحاولة عند 429 أو تعذر الخدمة. الاستخراج الجديد ملاحظة جديدة؛ قارن المخطط والنطاق أيضاً.
توضح العناوين الصياغة؛ تحقق من التوفر والمصادقة والشروط في الوثائق.
ورشة قراءة البيانات
تبادلات HTTP في DEMO افتراضية. لا يتصل هذا القسم بخادم ولا يعيد طلباً.
بيانات وسجلات افتراضية للتعلم: لا تأتي هذه النتائج من استعلام مباشر لأي خدمة.
يحفظ العميل تمثيلاً لـarea=A مع ETag. تحد السياسة الافتراضية المحاولات باثنتين ولا تضمن إتاحة الخدمة.
افتح كل اقتراح لمقارنة تشخيصه. قد تبقى فحوص إضافية ضرورية.
لا؛ يستخدم السيناريو نسخة الاختيار نفسه. غياب الجسم لا ينشئ جدولاً فارغاً.
لا؛ يغير ذلك نطاق المشاهدات بصمت. المعلمات جزء من السجل.
نعم. يجب تحديد البيانات المستخدمة والمحاولات التي لم تقدم استخراجاً جديداً.
الاختيار: GET /demo?area=A النسخة: جسم محفوظ؛ ETag="demo-v1" الشرط: If-None-Match="demo-v1" الاستجابة: 304؛ مرجع النسخة A محاولة أخرى: 429؛ Retry-After=15 ثانية سياسة DEMO: محاولتان كحد أقصى ثم التوقف حقوق إعادة النشر: فحص منفصل
حد المحاولتين من المثال لا من RFC. دون نسخة صالحة لا تختلق محتوى؛ حضر جلباً جديداً وفق سياسة الخدمة.
راجع الإجمالي والمؤشر التالي قبل عرض تعداد شامل.
ميّز null والحقل المفقود والقائمة الفارغة والصفر؛ يؤثر ذلك في المتوسط.
يوثق Eurostat قاعدة بأحدث النسخ. احفظ استخراجاً مؤرخاً لإعادة حساب قديم.
تمرين مع الحل
مثال افتراضي: القيم والوثائق لتعلم الطريقة ولا تصف مؤسسة حقيقية.
يشترط عقد هذه API الافتراضية success=true قبل المعالجة. افحص استجابة HTTP وحالة التطبيق ووجود النتائج كلّاً على حدة.
إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.
| العنصر | المعلومة المرصودة |
|---|---|
| حالة HTTP | 200 |
| مؤشر التطبيق | success=false |
| الرسالة المستلمة | الرسالة: بلوغ الحصة |
| مصفوفة النتائج | لم تُقدم مصفوفة |
استجاب النقل لكن الجمع فشل وفق العقد. لم يثبت عدد صفر. صنف الاستخراج كفشل واتبع قاعدة إعادة المحاولة؛ لا تصنع جدولاً فارغاً لمتابعة الحساب.
إذا احتوت استجابة ناجحة مصفوفة فارغة فعلاً، فقد يثبت الصفر للاستعلام والنطاق المحددين. أعد الاختبار مع success=true لكن بجسم JSON مبتور؛ فلا تكفي الحالة والعلامة بعد. ارفض الدفعة الناقصة واحفظ نقطة الاستئناف وتحقق من أن قيمة جزئية لم تستبدل آخر استخراج معتمد.
احفظ الاستعلام دون أسرار والحالة والخطأ والعقد وحالة الإعادة.
مرجع توثيقي : IETF — RFC 9110, 200 OK · تاريخ الاطلاع
مرجع موثق
Truthy إسقاط تقني لكل كيان وخاصية: تستبعد العبارات المفضلة العادية عند وجودها، وإلا تختار العادية. ليست تصويتاً آلياً للمصادر أو اختياراً لأحدث تاريخ.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| PreferredRank | Preferred | تختار جميع العبارات المفضلة للزوج. لا يضمن التفضيل قيمة وحيدة. |
| NormalRank | Normal | تختار العادية فقط عند غياب المفضلة للزوج. قد تكون قيم عادية متعددة مشروعة. |
| DeprecatedRank | Deprecated | تستبعد العبارات ذات الرتبة المهملة من truthy، مع بقائها كاملة لتوثيق أخطاء أو قيم مرفوضة. |
| wdt: | Best non-deprecated rank | يستخدم المسار المباشر أفضل الرتب غير المهملة دون مؤهلات. لا يضمن الحداثة أو الاكتمال أو الإسناد. |
| wikibase:BestRank | Full statement selection | يختار هذا النوع عقد العبارات الكاملة بأفضل رتبة مع إبقاء المؤهلات والمراجع متاحة. |
| Scope | Entity + property | القاعدة لكل كيان وخاصية. تفضيل السكان لا يختار تاريخ التأسيس أو الاسم. |
إذا كانت جميع العبارات مهملة فلا تفترض العودة إليها. اقرأ العبارات الكاملة والرتب لدراسة الاختلاف أو التاريخ. قد يكون غياب قيمة مباشرة نتيجة ترشيح الرتبة.
لا. الرتبة والتأهيل الزمني آليتان مختلفتان. افحص الزمن وسياسة الرتبة؛ قد تتعايش عبارات مفضلة متعددة.
تاريخ الاطلاع على الوثائق .
مرجع موثق
تتضمن استجابة JSON أكثر من قيمة. يخص المقتطف الحقيقي كثافة فنلندا في 2023. يشير رأس الاستجابة إلى تحديث WDI في 8 أكتوبر 2026، واستُخرجت هذه اللقطة في 23 أكتوبر. تجيب التواريخ الثلاثة عن أسئلة مختلفة.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| date | 2023 | سنة الرصد. لا تصبح 2026 لمجرد تنفيذ الطلب في 2026. |
| lastupdated | 2026-10-08 | تاريخ التحديث في رأس المصدر. لا يثبت وحده مراجعة هذه القيمة المحددة. |
| extracted | 2026-10-23 | تاريخ إعداد اللقطة المحلية؛ لا يحل محل فترة الرصد أو تاريخ المصدر. |
| unit | "" | حقل unit فارغ. لكن تعريف EN.POP.DNST يحدد أشخاصاً لكل كم² من اليابسة؛ الفراغ لا يعني أن القيمة بلا وحدة. |
| decimal / value | 0 / 18.3705454665088 | حقل decimal يساوي صفراً بينما تحتوي value على كسور عشرية. احتفظ بالقيمة الواردة ولا تفسر الحقل كهامش خطأ. |
| pages / total | 1 / 4 | تسع صفحة استجابة واحدة المشاهدات الأربع. قد يكون طلب آخر متعدد الصفحات؛ تحقق من pages وtotal قبل اعتبار الجمع مكتملاً. |
https://api.worldbank.org/v2/country/FRA;DEU;ESP;FIN/indicator/EN.POP.DNST?date=2023&format=json&per_page=100
[
{
"page": 1,
"pages": 1,
"per_page": 100,
"total": 4,
"sourceid": "2",
"lastupdated": "2026-10-08"
},
[
{
"indicator": {
"id": "EN.POP.DNST",
"value": "Population density (people per sq. km of land area)"
},
"country": {
"id": "FI",
"value": "Finland"
},
"countryiso3code": "FIN",
"date": "2023",
"value": 18.3705454665088,
"unit": "",
"obs_status": "",
"decimal": 0
}
]
]هذه لقطة مؤرخة من الواجهة، بلا تحديث آلي عند تحميل الصفحة. لا يثبت رمز الدولة المشترك تطابق النطاق الجغرافي لجميع السلاسل. لإعادة التحليل، احتفظ بالطلب الكامل والتعاريف والقيم المفقودة ولا تحول null إلى صفر.
تاريخ الاطلاع على الوثائق .
مرجع موثق
قائمة المعلمات تسلسل مرتب من أزواج الاسم والقيمة. قد يتكرر الاسم نفسه. تطبق الأداة application/x-www-form-urlencoded عبر URLSearchParams على قيمتين من سطر واحد ثم تعيد قراءة النتيجة، ولا ترسل نموذجاً.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| U+0020 | + | يُسلسل الفراغ U+0020 إلى + في هذا التنسيق. ليست هذه قاعدة عامة لكل أجزاء عنوان URL. |
| + | %2B | تتحول علامة + الأصلية في القيمة إلى %2B. يؤدي لصق C++ مباشرة في سلسلة مرمزة مسبقاً إلى قراءة علامتي + كفراغين. |
| & | %26 | تتحول & داخل القيمة إلى %26 فلا تنشئ معلمة إضافية. |
| = | %3D | تتحول = داخل القيمة إلى %3D، بينما تبقى علامة الفصل البنيوية بين الاسم والقيمة =. |
| été | %C3%A9t%C3%A9 | تُرمز المحارف غير ASCII انطلاقاً من UTF-8. تمثل تسلسلات النسبة المئوية بايتات لا عدد الحروف الظاهرة. |
| append / get / getAll / set | ordered pairs | تحتفظ append بظهور جديد. تعيد get القيمة الأولى وgetAll جميع القيم بالترتيب. تستبدل set الأولى وتحذف بقية مرات ظهور الاسم نفسه. |
قيمتان توضيحيتان تحسبان في هذه الصفحة.
حُفظ الزوجان بترتيبهما.
tag=C%2B%2B+%26+IA&tag=%C3%A9t%C3%A9
["C++ & IA","été"]
"C++ & IA"
الترميز ليس تشفيراً ولا تنقية HTML. لا تحاكي التجربة اختيار عناصر النموذج أو ملفات multipart أو توحيد نهايات الأسطر. يجب أن يحدد الخادم صراحة معالجة المعلمات المتكررة؛ قد يفقد تحويل القائمة مبكراً إلى كائن بعض القيم.
تاريخ الاطلاع على الوثائق .
لا. راجع الجسم والفلاتر والإجمالي والصفحات.
لا. اختر نطاقاً مفيداً ووثق حدوده.
تقارن البايتات المحفوظة. المنهج والجودة يحتاجان فحوصاً أخرى.
الحفاظ على الخطوة الأخيرة التي تم تأكيدها، وإعدادات ومراجعات الاستمرار. يجب على الاسترداد التحقق من تكرار البيانات والتغيرات المحتملة بدلاً من الافتراض ببساطة إضافة الإجابات.
مرجع موثق
قد يقرأ محرران نسخة واحدة ثم يرسلان تصحيحين مختلفين. يتيح الشرط المسبق للخادم رفض كتابة تستند إلى تمثيل قديم. الحالات افتراضية: v1 وv2 وسمان تعليميان وليسا رصداً لخدمة فعلية.
قراءة ← تعديل متزامن ← رفض الكتابة: مثال افتراضي.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| PUT · If-Match: "v1" | ETag: "v2" → 412 | تغيرت الوثيقة بعد قراءتها. تفشل المقارنة القوية في طلب PUT هذا؛ لا تستبدل النسخة الحالية. أعد قراءتها وافحص الاختلافات. |
| PUT · If-Match: "v2" | ETag: "v2" → ✓ | يتطابق الوسمان القويان، فيسمح هذا الشرط بمواصلة المعالجة. لا يضمن ذلك الحالة 200 أو نجاح بقية الفحوص. |
| PUT · If-Match: W/"v2" | ETag: "v2" → 412 | النص المعتم متطابق، لكن أحد الوسمين ضعيف. يتطلب If-Match مقارنة قوية فيفشل. حذف W/ لدى العميل لا ينشئ أداة تحقق قوية. |
| PUT · If-None-Match: * | موجود → 412 / غائب → ✓ | في الكتابة، تشترط النجمة عدم وجود تمثيل حالي. يفشل الشرط عند وجوده، وتسمح حالة الغياب بمواصلة المعالجة. |
| GET · If-None-Match: W/"v2" | ETag: "v2" → 304 | مع GET أو HEAD يستخدم If-None-Match مقارنة ضعيفة. يؤدي التطابق إلى 304؛ تُستخدم النسخة المحفوظة دون تلقي متن جديد. |
| 428 | Precondition Required | يشترط الخادم طلباً شرطياً. غياب الشرط يختلف عن 412 الذي يعني أن شرطاً مقدماً غير متحقق. يجب عدم تخزين استجابة 428 في الذاكرة المخبئية. |
غيّر الطريقة والحالة والشرط. أدخل وسماً بين علامتي اقتباس أو قائمة تفصلها فواصل أو * وحدها. يُجرى التقييم في متصفحك. مع * أو غياب التمثيل، لا يُستخدم وسم ETag الحالي.
412: الشرط غير متحقق. لا تُنفذ العملية المطلوبة.
محاكاة تعليمية محلية: لا يُرسل أي طلب إلى واجهة API ولا تُحفظ البيانات.
الشرط متحقق: تُستكمل الفحوص والمعالجة المعتادة. لا تُستنتج حالة نجاح.412: الشرط غير متحقق. لا تُنفذ العملية المطلوبة.304: الشرط غير متحقق مع GET/HEAD. تُستخدم النسخة المحفوظة.صياغة غير صالحة: استخدم وسوم HTTP بين علامتي اقتباس أو * وحدها. عند وجود تمثيل، يجب أن يكون ETag الحالي وسماً واحداً.يقيّم التمرين شرطاً واحداً قبل التنفيذ. يفترض قبول بقية الطلب ويستثني الحالة الخاصة لعملية اكتملت بنجاح بالفعل. تظل المصادقة والصلاحيات والتحقق من الوثيقة وقواعد العمل مطلوبة. لمنع ضياع التعديلات، يجب أن تتحقق الواجهة من الشرط وتطبق التغيير بصورة ذرية.
تاريخ الاطلاع على الوثائق .
قراءة موسعة / تطبيق عملي
يوفر API بيانات مفيدة، ولكن النتيجة تعتمد على الإعدادات والصفحة. يجب أن يحتفظ المجموعة بالطلب الكامل والشروط اللازمة لفهم الإجابة.
آخر تحديث في .
إرسال URL، الإعدادات، الحالة، النموذج والصفحة. التحكم في الفلاتر والحدود الحجمية والأخطاء التي يتم إرجاعها دون الكشف عن سر في السجلات.
يمكن أن يحتوي إجابة ناجحة على صفحة واحدة فقط من النتائج. تكرار الطلب في وقت لاحق قد يوفر حالة مختلفة إذا كانت البيانات قد تغيرت.
يرتبط سجل الاستقبال بالطلب، وتاريخ، والإجابة المحفوظة، والغطاء، والحد. يحدد كيفية استعادة أو التحقق من الاستخراج.