{
  "info": {
    "name": "Eco Libya — واجهة البيانات العامة v1",
    "description": "مجموعة Postman جاهزة لواجهة القراءة العامة في منصة اقتصاد ليبيا (Eco Libya). لا تتطلب مصادقة. عدّل المتغير baseUrl عند الحاجة، وغيّر المتغير code لتجربة مؤشر مختلف.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://ecolibya.com",
      "type": "string"
    },
    {
      "key": "code",
      "value": "LY.GDP.NOMINAL",
      "type": "string"
    },
    {
      "key": "editionId",
      "value": "00000000-0000-0000-0000-000000000000",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "معلومات الواجهة",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            ""
          ]
        },
        "description": "وصف الواجهة وقائمة النهايات المتاحة."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                ""
              ]
            },
            "description": "وصف الواجهة وقائمة النهايات المتاحة."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"name\": \"Eco Libya Public Data API\",\n  \"version\": \"1.0\",\n  \"docs_url\": \"/api/public/v1/docs\",\n  \"openapi_url\": \"/api/public/v1/openapi.json\"\n}"
        }
      ]
    },
    {
      "name": "قائمة المؤشرات النشطة",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/indicators?domain=macro",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "indicators"
          ],
          "query": [
            {
              "key": "domain",
              "value": "macro",
              "description": "المجال: macro, fiscal, monetary, trade, energy, labor, prices, population, other"
            },
            {
              "key": "frequency",
              "value": "annual",
              "description": "التكرار: daily, monthly, quarterly, annual",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "100",
              "description": "عدد النتائج (حد أقصى 500)",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "0",
              "description": "الإزاحة",
              "disabled": true
            }
          ]
        },
        "description": "قائمة المؤشرات النشطة مع الوحدة، تدعم الفلترة والترقيم."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/indicators?domain=macro",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "indicators"
              ],
              "query": [
                {
                  "key": "domain",
                  "value": "macro",
                  "description": "المجال: macro, fiscal, monetary, trade, energy, labor, prices, population, other"
                },
                {
                  "key": "frequency",
                  "value": "annual",
                  "description": "التكرار: daily, monthly, quarterly, annual",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "100",
                  "description": "عدد النتائج (حد أقصى 500)",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "0",
                  "description": "الإزاحة",
                  "disabled": true
                }
              ]
            },
            "description": "قائمة المؤشرات النشطة مع الوحدة، تدعم الفلترة والترقيم."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"data\": [\n    {\n      \"code\": \"LY.GDP.NOMINAL\",\n      \"name_ar\": \"الناتج المحلي الإجمالي الاسمي\",\n      \"name_en\": \"Nominal GDP\",\n      \"domain\": \"macro\",\n      \"frequency\": \"annual\",\n      \"direction\": \"up_good\",\n      \"base_year\": null,\n      \"unit\": {\n        \"code\": \"LYD_MN\",\n        \"name_ar\": \"مليون دينار ليبي\",\n        \"name_en\": \"Million LYD\",\n        \"symbol_ar\": \"م.د.ل\",\n        \"symbol_en\": \"LYD mn\",\n        \"kind\": \"currency\",\n        \"decimals\": 1\n      }\n    }\n  ],\n  \"meta\": {\n    \"total\": 1,\n    \"limit\": 100,\n    \"offset\": 0\n  }\n}"
        }
      ]
    },
    {
      "name": "تفاصيل مؤشر",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/indicators/{{code}}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "indicators",
            "{{code}}"
          ]
        },
        "description": "تفاصيل مؤشر واحد مع جهة المصدر وآخر قيمة معتمدة."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/indicators/{{code}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "indicators",
                "{{code}}"
              ]
            },
            "description": "تفاصيل مؤشر واحد مع جهة المصدر وآخر قيمة معتمدة."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"data\": {\n    \"code\": \"LY.GDP.NOMINAL\",\n    \"name_ar\": \"الناتج المحلي الإجمالي الاسمي\",\n    \"name_en\": \"Nominal GDP\",\n    \"domain\": \"macro\",\n    \"frequency\": \"annual\",\n    \"source_organization\": {\n      \"name_ar\": \"مصرف ليبيا المركزي\",\n      \"name_en\": \"Central Bank of Libya\",\n      \"abbreviation\": \"CBL\",\n      \"website_url\": \"https://cbl.gov.ly\"\n    },\n    \"latest_value\": {\n      \"period_type\": \"annual\",\n      \"period_label\": \"2024\",\n      \"period_start\": \"2024-01-01\",\n      \"period_end\": \"2024-12-31\",\n      \"value\": 265400.5,\n      \"page_reference\": \"12\",\n      \"notes\": null,\n      \"updated_at\": \"2026-01-15T10:20:30.000Z\"\n    },\n    \"values_url\": \"/api/public/v1/indicators/LY.GDP.NOMINAL/values\"\n  }\n}"
        }
      ]
    },
    {
      "name": "تفاصيل مؤشر — غير موجود",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/indicators/UNKNOWN.CODE",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "indicators",
            "UNKNOWN.CODE"
          ]
        },
        "description": "مثال على رد 404 عند رمز مؤشر غير معروف."
      },
      "response": [
        {
          "name": "استجابة خطأ 404",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/indicators/UNKNOWN.CODE",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "indicators",
                "UNKNOWN.CODE"
              ]
            },
            "description": "مثال على رد 404 عند رمز مؤشر غير معروف."
          },
          "status": "Not Found",
          "code": 404,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"error\": \"not_found\"\n}"
        }
      ]
    },
    {
      "name": "السلسلة الزمنية للقيم المعتمدة",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/indicators/{{code}}/values?period_type=annual",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "indicators",
            "{{code}}",
            "values"
          ],
          "query": [
            {
              "key": "period_type",
              "value": "annual",
              "description": "نوع الفترة: annual, quarterly, monthly, daily"
            },
            {
              "key": "from",
              "value": "2020-01-01",
              "description": "بداية النطاق بصيغة YYYY-MM-DD",
              "disabled": true
            },
            {
              "key": "to",
              "value": "2024-12-31",
              "description": "نهاية النطاق بصيغة YYYY-MM-DD",
              "disabled": true
            },
            {
              "key": "limit",
              "value": "100",
              "description": "عدد النتائج (حد أقصى 500)",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "0",
              "description": "الإزاحة",
              "disabled": true
            }
          ]
        },
        "description": "قيم المؤشر المعتمدة مرتبة تصاعديًا حسب بداية الفترة."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/indicators/{{code}}/values?period_type=annual",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "indicators",
                "{{code}}",
                "values"
              ],
              "query": [
                {
                  "key": "period_type",
                  "value": "annual",
                  "description": "نوع الفترة: annual, quarterly, monthly, daily"
                },
                {
                  "key": "from",
                  "value": "2020-01-01",
                  "description": "بداية النطاق بصيغة YYYY-MM-DD",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2024-12-31",
                  "description": "نهاية النطاق بصيغة YYYY-MM-DD",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "100",
                  "description": "عدد النتائج (حد أقصى 500)",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "0",
                  "description": "الإزاحة",
                  "disabled": true
                }
              ]
            },
            "description": "قيم المؤشر المعتمدة مرتبة تصاعديًا حسب بداية الفترة."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"data\": [\n    {\n      \"period_type\": \"annual\",\n      \"period_label\": \"2023\",\n      \"period_start\": \"2023-01-01\",\n      \"period_end\": \"2023-12-31\",\n      \"value\": 241300.2,\n      \"page_reference\": \"10\",\n      \"notes\": null,\n      \"updated_at\": \"2026-01-10T08:00:00.000Z\"\n    }\n  ],\n  \"meta\": {\n    \"indicator_code\": \"LY.GDP.NOMINAL\",\n    \"total\": 1,\n    \"limit\": 100,\n    \"offset\": 0\n  }\n}"
        }
      ]
    },
    {
      "name": "مواصفة OpenAPI",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/openapi.json",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "openapi.json"
          ]
        },
        "description": "مواصفة OpenAPI 3.1 الكاملة بصيغة JSON."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/openapi.json",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "openapi.json"
              ]
            },
            "description": "مواصفة OpenAPI 3.1 الكاملة بصيغة JSON."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"openapi\": \"3.1.0\",\n  \"info\": {\n    \"title\": \"Eco Libya Public Data API\",\n    \"version\": \"1.0.0\"\n  }\n}"
        }
      ]
    },
    {
      "name": "قائمة إصدارات المصادر",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/editions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "editions"
          ],
          "query": [
            {
              "key": "limit",
              "value": "100",
              "description": "عدد النتائج (حد أقصى 500)",
              "disabled": true
            },
            {
              "key": "offset",
              "value": "0",
              "description": "الإزاحة",
              "disabled": true
            }
          ]
        },
        "description": "إصدارات وثائق المصدر المتحقق منها مع الوثيقة والجهة المُصدِرة."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/editions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "editions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "100",
                  "description": "عدد النتائج (حد أقصى 500)",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "0",
                  "description": "الإزاحة",
                  "disabled": true
                }
              ]
            },
            "description": "إصدارات وثائق المصدر المتحقق منها مع الوثيقة والجهة المُصدِرة."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"data\": [\n    {\n      \"id\": \"{{editionId}}\",\n      \"edition_title\": \"World Economic Outlook — أبريل 2025\",\n      \"period_start\": \"2015-01-01\",\n      \"period_end\": \"2024-12-31\",\n      \"published_at\": \"2025-04-22\",\n      \"source_url\": \"https://www.imf.org/en/Publications/WEO\",\n      \"page_reference\": \"جداول قاعدة البيانات\",\n      \"verified_at\": \"2025-05-02T10:00:00.000Z\",\n      \"has_attachment\": false,\n      \"document\": {\n        \"id\": \"9c8b7a65-4321-4fed-9abc-0123456789ab\",\n        \"title_ar\": \"تقرير آفاق الاقتصاد العالمي\",\n        \"title_en\": \"World Economic Outlook\",\n        \"doc_type\": \"annual_report\",\n        \"frequency\": \"annual\",\n        \"language\": \"en\"\n      },\n      \"organization\": {\n        \"name_ar\": \"صندوق النقد الدولي\",\n        \"name_en\": \"International Monetary Fund\",\n        \"abbreviation\": \"IMF\",\n        \"website_url\": \"https://www.imf.org\"\n      },\n      \"url\": \"/api/public/v1/editions/{{editionId}}\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 1,\n    \"limit\": 100,\n    \"offset\": 0\n  }\n}"
        }
      ]
    },
    {
      "name": "تفاصيل إصدار مع قيمه",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/editions/{{editionId}}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "editions",
            "{{editionId}}"
          ]
        },
        "description": "تفاصيل إصدار متحقق منه مع القيم المعتمدة المستخرجة منه."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/editions/{{editionId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "editions",
                "{{editionId}}"
              ]
            },
            "description": "تفاصيل إصدار متحقق منه مع القيم المعتمدة المستخرجة منه."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"data\": {\n    \"id\": \"{{editionId}}\",\n    \"edition_title\": \"World Economic Outlook — أبريل 2025\",\n    \"published_at\": \"2025-04-22\",\n    \"source_url\": \"https://www.imf.org/en/Publications/WEO\",\n    \"verified_at\": \"2025-05-02T10:00:00.000Z\",\n    \"has_attachment\": false,\n    \"values\": [\n      {\n        \"indicator_code\": \"GDP_USD\",\n        \"indicator_name_ar\": \"الناتج المحلي الإجمالي بالدولار\",\n        \"indicator_name_en\": \"GDP, current prices (USD)\",\n        \"period_type\": \"annual\",\n        \"period_label\": \"2024\",\n        \"period_start\": \"2024-01-01\",\n        \"period_end\": \"2024-12-31\",\n        \"value\": 45120.5,\n        \"page_reference\": null,\n        \"notes\": null,\n        \"updated_at\": \"2025-05-02T10:05:00.000Z\"\n      }\n    ],\n    \"meta\": {\n      \"values_total\": 1\n    }\n  }\n}"
        }
      ]
    },
    {
      "name": "تفاصيل إصدار — غير موجود",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/editions/00000000-0000-0000-0000-000000000000",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "editions",
            "00000000-0000-0000-0000-000000000000"
          ]
        },
        "description": "مثال على رد 404 عند معرّف إصدار غير متحقق منه أو غير موجود."
      },
      "response": [
        {
          "name": "استجابة خطأ 404",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/editions/00000000-0000-0000-0000-000000000000",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "editions",
                "00000000-0000-0000-0000-000000000000"
              ]
            },
            "description": "مثال على رد 404 عند معرّف إصدار غير متحقق منه أو غير موجود."
          },
          "status": "Not Found",
          "code": 404,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"error\": \"not_found\"\n}"
        }
      ]
    },
    {
      "name": "مواصفة OpenAPI (JSON)",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/v1/openapi.json",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "public",
            "v1",
            "openapi.json"
          ]
        },
        "description": "مواصفة OpenAPI 3.1 الكاملة بصيغة JSON."
      },
      "response": [
        {
          "name": "استجابة ناجحة 200",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/public/v1/openapi.json",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "public",
                "v1",
                "openapi.json"
              ]
            },
            "description": "مواصفة OpenAPI 3.1 الكاملة بصيغة JSON."
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            },
            {
              "key": "Cache-Control",
              "value": "public, max-age=60"
            }
          ],
          "cookie": [],
          "body": "{\n  \"openapi\": \"3.1.0\",\n  \"info\": {\n    \"title\": \"Eco Libya Public Data API\",\n    \"version\": \"1.0.0\"\n  }\n}"
        }
      ]
    }
  ]
}