getAppStats: بازیابی آمارهای اپلیکیشن
این متد آمارهای اپلیکیشن شما که در مرکز توسعهدهنده ثبت کردهاید را هر روز بازیابی میکند. آمارها فقط در دسترس صاحب اپ قرار میگیرند. دسترسی نامناسب باعث برگرداندن خطای ERROR_ACCESS_DENIED میشود.
فرمت این آمارها با فرمت مورد استفاده در AntiCaptcha یکسان است تا نمودارهای JS با استفاده از کتابخانه HighCharts رندر شوند. شما میتوانید آنها را به شیوهای که برای نمایش دادهها نیاز دارید دوباره فرمتبندی کنید
آدرس: https://api.anti-captcha.com/getAppStats
متد: POST
Content-type: application-json
خصوصیات درخواست
خصوصیت | نوع | ضروری | هدف |
---|---|---|---|
clientKey | رشته | بله | |
softId | عدد صحیح | بله | شناسه اپ شما در مرکز توسعهدهندگان |
mode | رشته | خیر | نوع آمار: errors: (پیشفرض): دادههای خطاها views: بازدید از صفحه اپ downloads: کلیکها روی لینک «دانلود» users: تعداد کاربران money: درآمد کسب شده |
نمونه درخواست
curl -i -H "Accept: application/json" \
-H "Content-Type: application/json" \
-X POST -d '{
"clientKey":"YOUR_API_KEY",
"softId":123,
"mode":"errors"
}' https://api.anti-captcha.com/getAppStats
ساختار پاسخ
خصوصیت | نوع | هدف |
---|---|---|
errorId | عدد صحیح | شناسه خطا. 0 – بدون خطا، عملیات با موفقیت انجام شد >0 – شناسه خطا. کد خطا و شرح مختصری از آن در خصوصیتهای errorCode و errorDescription درج میشوند. |
errorCode | رشته | |
errorDescription | رشته | شرح مختصری از خطا |
chartData | آرایه | شیئی که حاوی دادههای چارت، ارزشهای روزانه، تاریخ و غیره است. آماده ارائه با کتابخانه HighCharts.js است. |
fromDate | رشته | تاریخ شروع گزارش |
toDate | رشته | تاریخ پایان گزارش |
نمونه پاسخ
JSON بدون خطا
JSON با یک خطا
{
"errorId":0,
"chartData":[
{
"name":"Accepted (paid)",
"data":[
{
"date":"25 January",
"shortdate":"25 Jan",
"y":134587,
"beginstamp":1548374400,
"endstamp":1548460799,
"stamp":1548374400
},{
"date":"26 January",
"shortdate":"26 Jan",
"y":87532,
"beginstamp":1548460800,
"endstamp":1548547199,
"stamp":1548460800
},{
...
}],
"itemname":"Captchas",
"errorId":0,
"code":"",
"description":""
},{
"name":"No slots available (low bid)",
"data":[
..
],
"itemname":"Errors",
"errorId":2,
"count":82224,
"code":"ERROR_NO_SLOT_AVAILABLE",
"description":"No idle workers are available at the moment. Please try a bit later or increase your maximum bid in menu Settings - API Setup in Anti-Captcha Customers Area."
}],
"fromDate":"25 Jan 00:00",
"toDate":"24 Feb 08:09"
}