Menu

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"
}