دریافت داده های جدولی

داده های جداول متنوع ترین هستند زیرا به شما امکان می دهند گزارشی را از دیدگاه های مختلف تهیه کنید.

فرمت درخواست #

برای به دست آوردن داده های جدولی ، درخواست GET را اجرا کنید:

GET https://content.mql5.com/api/v1/reports/website/{WEBSITE_ID}/table
?metrics=<string>
&date_from=<unixtime>
&date_to=<unixtime>
&group=<string>
&where=<array>
&offset=<integer>
&limit=<integer>
&order=<string>

شناسه وب سایت را به عنوان {WEBSITE_ID} تنظیم کنید. می توان آن را در تنظیمات وب سایت (فیلد شناسه) از پانل Finteza بدست آورد.

پارامترهای درخواست #

پارامتر	نوع	توصیف
metrics *	string	لیستی از > معیارها (با کاما از هم جدا) ، به عنوان مثال ، metrics=visits،events .
date_from *	unixtime	تاریخ اولیه درخواست داده. به عنوان مثال از سال 1970.01.01 در ثانیه مشخص شده است ، date_from=1549027860 .
date_to *	unixtime	تاریخ پایان درخواست داده به عنوان مثال از سال 1970.01.01 در ثانیه مشخص شده است ، date_from=1549027860 .
group *	string	لیست زمینه های برای تنظیم داده ها (جدا شده با کاما).
where	array	آرایه ای از شرایط به فرم ?where[key]=value, که کلید نام فیلدی هست که مرتب سازی باید بر اساس آن انجام شود. برای مقدار شرط می توان از عملگرهای زیر استفاده کرد: = (IS) - مقدار دقیق همخوانی. به عنوان مثال, where[os]=windows به این معناست که فقط داده های مربوط به کاربران ویندوز برگردانده شوند. * (LIKE) — همخوانی غیر دقیق. به عنوان مثال, where[device]=mobile به این معناست که تنها داده های مربوط به دستگاه های موبایل برگردانده شوند. ! (NOT) — مقدار مخالف. به عنوان مثال, where[country]=!ru به این معناست که تنها داده های مربوط به کاربران غیر روسی برگردانده شوند.
offset	integer	موقعیت اولین مورد لیست برای دریافت داده ها از آن. پیش فرض 0 است - داده ها را از آخرین (آخرین) عنصر دریافت کنید.
limit	integer	تعداد موارد لیست دریافت شده پیش فرض 20 است.
order	string	نام مرتب سازی field است. برای معکوس کردن مرتب سازی ، "-" را قبل از نام زمینه تنظیم کنید ، به عنوان مثال ، order=-visits .

* - پارامترهای مورد نیاز.

درخواست نمونه #

GET https://content.mql5.com/v1/reports/website/dxnnhxrwpcwsgwowveipxmslrznjfhzarp/table
?metrics=webvisits,events
&group=ua_device,ua_device_model
&where[os]=windows
&where[device]=*mobile
&where[country]=!ru
&offset=0
&limit=20
&date_from=1549027860
&date_to=1549632660
&order=webvisits

پاسخ نمونه #

{
    "data": {
        "offset": 0,
        "limit": 20,
        "date_from": 1549027860,
        "date_to": 1549632660,
        "where": {
            "os": "windows",
            "device": "*mobile",
            "country": "!ru",
        },
        "order": "webvisits",
        "items": [ {
            "ua_device": "Desktop",
            "ua_device_model": "Apple",
            "webvisits": 4205748,
            "events": 1247138
        }, {
            "ua_device": "Mobile",
            "ua_device_model": "Apple",
            "webvisits": 42050,
            "events": 1247
        }, {
            "ua_device": "Tablet",
            "ua_device_model": "Apple",
            "webvisits": 420,
            "events": 12
        } ]
    }
}