MoroccoAPIالتوثيق
مرجع الواجهة

اختر مورداً. حدّد المعاملات. جرّب الطلب.

دون مفتاح APIإجابات JSONCORS مفتوح

أجر درجة

GET/api/v2/public-service/salaries/{code}

معلومة مهمة. أجور صافية مرجعية حاكاها موقع وظيفة إنفو بالمحاكي الرسمي (simulation.mmsp.gov.ma): ليست أجوراً رسمية مستحقة. انظر meta.notice.

المعاملات

01
stringإلزامي · المسار

معرّف المورد، كما يظهر في القائمة.

2-200 حرفاً
النمط^[a-z0-9-]+$
فهم الإجابة

data: النتائج المطلوبة، في كائن أو قائمة.

meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.

API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.

حقول الإجابة 8

تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.

dataobject

النتيجة المطلوبة: كائن واحد أو قائمة.

data.codestring

معرّف المورد في MoroccoAPI؛ استعمله في روابط المورد المناسبة.

data.gradeobject

اسم الدرجة في الوظيفة العمومية، بالفرنسية والعربية.

data.grade.frstring

القيمة بالفرنسية؛ null عند غياب الترجمة.

data.corpsobject

الهيئة أو الإطار الذي تنتمي إليه الدرجة، كما ينشره المحاكي الرسمي.

data.corps.arstring

القيمة بالعربية؛ null عند غياب الترجمة.

data.net_monthly_salary_madinteger

الأجر الصافي الشهري المرجعي بالدرهم، ناتج عن محاكاة؛ وليس أجراً رسمياً مستحقاً.

data.reference_urlstring

صفحة وظيفة إنفو التي تفصّل هذه الدرجة وطريقة المحاكاة.

بنية البيانات
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code",
        "grade",
        "corps",
        "net_monthly_salary_mad",
        "reference_url"
      ],
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[a-z0-9-]+$"
        },
        "grade": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "fr"
          ],
          "properties": {
            "fr": {
              "type": "string"
            }
          }
        },
        "corps": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "ar"
          ],
          "properties": {
            "ar": {
              "type": "string"
            }
          }
        },
        "net_monthly_salary_mad": {
          "type": "integer",
          "minimum": 1
        },
        "reference_url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "meta": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dataset",
        "total",
        "license",
        "retrieved_at",
        "transformation_version",
        "value_type",
        "notice",
        "sources"
      ],
      "properties": {
        "dataset": {
          "enum": [
            "public-service-salaries"
          ]
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "license": {
          "enum": [
            "CC-BY-4.0"
          ]
        },
        "retrieved_at": {
          "enum": [
            "2026-10-08"
          ]
        },
        "transformation_version": {
          "enum": [
            "1.0.0"
          ]
        },
        "value_type": {
          "enum": [
            "simulated-reference"
          ]
        },
        "notice": {
          "enum": [
            "Simulated reference values compiled by Wadifa Info from the official salary simulator (simulation.mmsp.gov.ma), not official salary entitlements. Net monthly pay at the first echelon for a single person with no children and no mutuelle, in the highest residence-allowance zone; actual pay differs with echelon, location, family situation and specific allowances."
          ]
        },
        "sources": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "dataset",
              "producer",
              "source_url",
              "resource_url",
              "license",
              "source_updated_at"
            ],
            "properties": {
              "dataset": {
                "type": "string"
              },
              "producer": {
                "type": "string"
              },
              "source_url": {
                "type": "string",
                "format": "uri"
              },
              "resource_url": {
                "type": "string",
                "format": "uri"
              },
              "license": {
                "enum": [
                  "CC-BY-4.0"
                ]
              },
              "source_updated_at": {
                "type": "string",
                "format": "date"
              }
            }
          }
        }
      }
    }
  }
}
المصادر وتقسيم الصفحات 15
metaobject

سياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.

meta.datasetstring

اسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.

القيم المقبولة: "public-service-salaries"

meta.totalinteger

عدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.

meta.licensestring

رخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.

القيم المقبولة: "CC-BY-4.0"

meta.retrieved_atstring

تاريخ جلب المشروع لملف المصدر؛ وليس تاريخ رصد البيانات.

القيم المقبولة: "2026-10-08"

meta.transformation_versionstring

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

القيم المقبولة: "1.0.0"

meta.value_typestring

طبيعة القيم: تعني simulated-reference مبالغ ناتجة عن محاكاة وليست رسمية.

القيم المقبولة: "simulated-reference"

meta.noticestring

تنبيه حول إعدادات المحاكاة؛ يُقرأ قبل إعادة استعمال المبالغ.

القيم المقبولة: "Simulated reference values compiled by Wadifa Info from the official salary simulator (simulation.mmsp.gov.ma), not official salary entitlements. Net monthly pay at the first echelon for a single person with no children and no mutuelle, in the highest residence-allowance zone; actual pay differs with echelon, location, family situation and specific allowances."

meta.sourcesobject[]

المصادر المستخدمة لهذه النتيجة مع الجهات المنتجة والرخص.

meta.sources[].datasetstring

اسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.

meta.sources[].producerstring

الجهة التي تنشر البيانات الأصلية.

meta.sources[].source_urlstring

صفحة نشر المصدر أو التعريف ببياناته.

meta.sources[].resource_urlstring

رابط الملف أو المورد المستخدم فعلياً.

meta.sources[].licensestring

رخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.

القيم المقبولة: "CC-BY-4.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

معرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.

طلبك

GET · JSON

العنوان الأساسي

الإجابة

ستظهر الإجابة الفعلية هنا.

تغيّر اللغة نص التوثيق فقط، دون مفاتيح JSON أو قيم المصادر.