MoroccoAPIميناء حسب الاسم
معلومة مهمة. قوائم وزارة التجهيز والماء. تُحفظ أسماء المصدر وحقوله باللغة الفرنسية.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 7
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobjectالنتيجة المطلوبة: كائن واحد أو قائمة.
data.Nom du portstringاسم الميناء كما نُشر؛ يُحتفظ بمفتاح JSON الفرنسي.
data.Type de portsstringفئة الميناء المذكورة في المصدر.
data.Connectivitéstringمعلومات الربط البحري الواردة في المصدر.
data.Latitudenumberخط العرض وفق WGS 84 بالدرجات العشرية: موجب شمالاً وسالب جنوباً.
data.Longitudenumberخط الطول وفق WGS 84 بالدرجات العشرية: موجب شرقاً وسالب غرباً.
data.Etatstringحالة الميناء في ملف المصدر؛ ليست متابعة لحظية.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"Nom du port",
"Type de ports",
"Connectivité",
"Latitude",
"Longitude",
"Etat"
],
"properties": {
"Nom du port": {
"type": "string",
"minLength": 1
},
"Type de ports": {
"type": "string",
"minLength": 1
},
"Connectivité": {
"type": "string",
"minLength": 1
},
"Latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"Longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"Etat": {
"type": "string",
"minLength": 1
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"license_url",
"retrieved_at",
"source_updated_at",
"transformation_version",
"scope",
"limitations",
"sources"
],
"properties": {
"dataset": {
"type": "string",
"enum": [
"morocco-ports",
"morocco-lighthouses"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"license_url": {
"type": "string",
"format": "uri"
},
"retrieved_at": {
"type": "string",
"format": "date"
},
"source_updated_at": {
"type": "string",
"format": "date"
},
"transformation_version": {
"type": "string"
},
"scope": {
"type": "string",
"minLength": 1
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"sources": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"source_url",
"resource_url",
"license",
"source_updated_at"
],
"properties": {
"dataset": {
"type": "string",
"minLength": 1
},
"producer": {
"type": "string",
"minLength": 1
},
"source_url": {
"type": "string",
"format": "uri"
},
"resource_url": {
"type": "string",
"format": "uri"
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"source_updated_at": {
"type": "string",
"format": "date"
}
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 17
metaobjectسياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.
meta.datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"morocco-ports""morocco-lighthouses"meta.totalintegerعدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.
meta.licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"ODbL-1.0"meta.license_urlstringرابط شروط الرخصة؛ null عند غياب الرابط.
meta.retrieved_atstringتاريخ جلب المشروع لملف المصدر؛ وليس تاريخ رصد البيانات.
meta.source_updated_atstringآخر تحديث معلن من المصدر؛ وليس تاريخ جلب الملف.
meta.transformation_versionstringإصدار قواعد تحويل مجموعة البيانات؛ مستقل عن إصدار الواجهة.
meta.scopestringالنطاق الذي تغطيه البيانات؛ لا يعني تغطية شاملة.
meta.limitationsstring[]القيود المعروفة للمصدر أو التغطية؛ اقرأها قبل استخدام البيانات.
meta.sourcesobject[]المصادر المستخدمة لهذه النتيجة مع الجهات المنتجة والرخص.
meta.sources[].datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
meta.sources[].producerstringالجهة التي تنشر البيانات الأصلية.
meta.sources[].source_urlstringصفحة نشر المصدر أو التعريف ببياناته.
meta.sources[].resource_urlstringرابط الملف أو المورد المستخدم فعلياً.
meta.sources[].licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"ODbL-1.0"meta.sources[].source_updated_atstringآخر تحديث معلن من المصدر؛ وليس تاريخ جلب الملف.
الأخطاء
400: معامل غير صالح أو مفقود.404: المورد غير موجود.
تتضمن الأخطاء error.code وerror.message وerror.request_id.
errorobjectتفاصيل الطلب الفاشل؛ تحل محل data وmeta.
error.codestringرمز ثابت للخطأ، مثل RESOURCE_NOT_FOUND؛ استعمله في منطق التطبيق.
error.messagestringشرح مقروء للخطأ؛ استعمل code في منطق التطبيق.
error.request_idstringمعرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.