getAppStats: بازیابی آمارهای اپلیکیشن
این متد فقط آمارهای روزانه برای اپلیکیشنتان که در مرکز توسعهدهنده ثبت میکنید را بازیابی میکند. آمارها فقط برای صاحب اپلیکیشن قابلدسترس هستند. درصورتیکه از متد دسترسی نامناسبی استفاده شود، خطای ERROR_ACCESS_DENIED برگردانده میشود.
این آمارها به همان فرمتی هستند که در AntiCaptcha استفاده میشود تا نمودارهای JS با استفاده از پلاگین HighCharts رندر شوند. میتوانید آنها را دوباره به شیوهای فرمتبندی کنید که برای ارائه دادهها نیاز دارید.
آدرس: https://api.anti-captcha.com/getAppStats
متد: POST
Content-type: application-json
خصوصیات درخواست
خصوصیت | نوع | موردنیاز | هدف |
---|---|---|---|
clientKey | رشته | بله | |
softId | عدد صحیح | بله | ID اپ شما از مرکز توسعه دهندگان |
mode | رشته | خیر | انواع آمارها: خطاها (default) دادههای خطاها views : App بازدیدهای صفحه دانلودها : روی لینک «دانلود» کلیک کنید users : مقدار کاربران پول : پول کسب شده |
نمونه درخواست
CURL
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 - بدون خطا - عملیات با موفقیت به اتمام رسید. 1 - شناسه خطا. کد خطا و شرح کوتاه در خصوصیات errorCode و errorDescription منتقل میشوند. |
errorCode | رشته | |
errorDescription | رشته | شرح کوتاهی از خطا |
chartData | آرایه | شیئی که حاوی عنوان دادههای چارت، مقدارهای روزانه، تاریخ و اطلاعات بیشتر است. آماده رندر شدن در HighCharts.js است |
fromDate | رشته | تاریخ شروع گزارش |
toDate | رشته | تاریخ پایان گزارش |
نمونه پاسخ
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"
}
JSON با یک خطا
{
"errorId": 1,
"errorCode": "ERROR_KEY_DOES_NOT_EXIST",
"errorDescription": "Account authorization key not found in the system"
}