getAppStats: بازیابی آمارهای اپلیکیشن
این متد فقط آمارهای روزانه برای اپلیکیشنتان که در مرکز توسعهدهنده ثبت میکنید را بازیابی میکند. آمارها فقط برای صاحب اپلیکیشن قابلدسترس هستند. درصورتیکه از متد دسترسی نامناسبی استفاده شود، خطای ERROR_ACCESS_DENIED برگردانده میشود.
این آمارها به همان فرمتی هستند که در AntiCaptcha استفاده میشود تا نمودارهای JS با استفاده از پلاگین HighCharts رندر شوند. میتوانید آنها را دوباره به شیوهای فرمتبندی کنید که برای ارائه دادهها نیاز دارید.
آدرس: https://api.anti-captcha.com/getAppStats
متد: POST
Content-type: application-json
خصوصیات درخواست
خصوصیت | نوع | موردنیاز | هدف |
---|---|---|---|
clientKey | رشته | بله | |
softId | عدد صحیح | بله | ID اپ شما از مرکز توسعه دهندگان |
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"
}