طلب تقرير بعد النشر #

انشر طلبا لتشغيل تقرير لفترة زمنية محددة (dateFilter).

POST /v1.0/workspaces/{WORKSPACE_ID}/reports/{REPORT_ID}/requests

مثال على استخدام مرشح تاريخ محدد مسبقا #

سيقوم هذا الطلب بتشغيل تقرير للربع الحالي. يحتوي جسم الإرجاع على 'requestId' والذي يمكن استخدامه للاستعلام عن حالة التقرير واسترجاع مجموعة البيانات.

طلب #

 
POST <https://api.eu.myreports.cloud/api/v1.0/workspaces/00000000-0000-0000-0000-000000000001/reports/00000000-0000-0000-0000-000000000001/requests> HTTP/1.1
نوع المحتوى: application/json
التفويض: حامل {TOKEN}
الاتصال: البقاء على قيد الحياة
{ 
    "reportId": "00000000-0000-0000-0000-00000-00000000001", 
    "filterId": "00000000-0000-0000-0000-0000-00000000001", 
    "dateFilter": { 
        "presetName": "هذا الربع" 
    }, 
    "الشروط الإضافية" : \[]

}

info
يمكن أن يكون 'presetName' أي من <مرشحات تاريخ الإعداد المسبق</c1> الصحيحة c1>presetDate).

info
يمكن استخدام 'filterId' لتطبيق مرشح محدد مسبقا على التقرير. إذا لم يتم توفيره، سيتم استخدام المرشح الافتراضي المطبق على التقرير المطلوب.

info
يمكن استخدام 'additionalConditions' لتطبيق Additional Filters على التقرير. ستكمل هذه المرشحات أي معلمات محددة في مرشح محدد مسبقا.

الرد #

 
HTTP/1.1 200 OK
نوع المحتوى: application/json; charset=utf-8
مدة المحتوى: xx
{ 
    "data": { 
        "requestId": "00000000-0000-0000-0000-0000-00000000005", 
        "locale": "en-GB", 
        "reportId": "00000000-0000-0000-0000-00000-00000000001", 
        "مرجع تاريخ": "2025-09-22T15:23:01.0201791+00:00", 
        "dateFilter": { 
            "presetName": "ThisQuarter", 
            "presetFilterObject": { 
                "وحدات": 5, 
                "الإزاحة": 0, 
                "الطول": 1, 
                "وضع التقريب": 1, 
                "أيام الأسبوع": 127
            }, 
            "أيام الأسبوع": 127
        }, 
        "وقت البدء": "2025-07-01T00:00:00+01:00", 
        "نهاية الزمن": "2025-09-22T16:08:01.02159+01:00" 
    }, 
    "المكانة": "نجاح", 
    "الطابع الزمني": "2025-09-22T15:23:02.2982477Z" 
}

مثال على استخدام نطاق زمني ثابت #

طلب #

 
منشور <https://api.eu.myreports.cloud/api/v1.0/workspaces/00000000-0000-0000-0000-000000000001/reports/00000000-0000-0000-0000-000000000001/requests> HTTP/1.1
نوع المحتوى: application/json
التفويض: حامل {TOKEN}
الاتصال: البقاء على قيد الحياة
{ 
    "reportId": "00000000-0000-0000-0000-00000-00000000001", 
    "dateFilter": { 
       "ابدأ": "2025-09-26T09:00:00+01:00", 
        "النهاية": "2025-09-26T17:00:00+01:00" 
    }
}

info
يمكن أن يكون 'presetName' أي من <مرشحات تاريخ الإعداد المسبق</c1> الصحيحة c1>presetDate).

الرد #

 
HTTP/1.1 200 OK
نوع المحتوى: application/json; charset=utf-8
مدة المحتوى: xx
{ 
    "data": { 
        "requestId": "00000000-0000-0000-0000-0000-00000000005", 
        "locale": "en-GB", 
        "reportId": "00000000-0000-0000-0000-00000-00000000001", 
        "مرجع تاريخ": "2025-09-22T15:23:01.0201791+00:00", 
        "dateFilter": { 
            "ابدأ": "2025-09-26T09:00:00+01:00", 
            "النهاية": "2025-09-26T17:00:00+01:00", 
            "presetFilterObject": { 
                "وحدات": 5, 
                "الإزاحة": 0, 
                "الطول": 1, 
                "وضع التقريب": 1, 
                "أيام الأسبوع": 127
            }, 
            "أيام الأسبوع": 127
        }, 
        "ابدأ": "2025-09-26T09:00:00+01:00", 
        "النهاية": "2025-09-26T17:00:00+01:00" 
    }, 
    "المكانة": "نجاح", 
    "الطابع الزمني": "2025-09-22T15:23:02.2982477Z" 
}

الأخطاء #

غير مصرح به #

عندما لا يتم توفير الرمز أو غير صالح أو منتهية الصلاحية

 
HTTP/1.1 401 غير مصرح به