getAppStats: استعراض إحصائيات التطبيق

تساعد هذه الأوامر على استرداد الإحصائيات اليومية لتطبيقك الذي قمت بتسجيله في قسم المطورين. يُرجى العلم أن تلك الإحصائيات مُتاحة فقط لمالك التطبيق. لذلك قد تظهر رسالة خطأ ERROR_ACCESS_DENIED حال عدم امتلاكك التصاريح المطلوبة.

تظهر الإحصائيات بنفس الصيغة المستخدمة في AntiCaptcha لعرض المخططات البيانية المصنوعة بالجافاسكريبت بواسطة مكتبة HighCharts. يمكنك إعادة صياغة هذه المخططات بالطريقة التي ترغب بإظهارها بها في عروضك التقديمية الخاصة.

العنوان: https://api.anti-captcha.com/getAppStats
الأمر: POST
Content-type: application-json

خصائص الطلب

الخاصية	نوع الخاصية	الأهمية	الوظيفة
clientKey	String	مطلوبة	يمكن إيجاد مفتاح حساب العميل هنا
softId	Integer	مطلوبة	الرقم التعريفي لتطبيقك من قسم المطورين
mode	String	غير مطلوبة	نوع الإحصائيات: 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	Integer	مُعرف الخطأ. 0 - لا يوجد أخطاء، تمت العملية بنجاح. معرف الخطأ >0 عبارة عن كود خطأ مزود بوصف مختصر يمكن الاطلاع عليه عن طريق errorCode و errorDescription
errorCode	String	كود خطأ، لن يتم تضمين كود خطأإذا لم ينتج أي أخطاء عن الطلب. يُرجى الاطلاع على قائمة الأخطاء للمراجعة.
errorDescription	String	شرح مختصر للخطأ
chartData	Array	يحتوي هذا الكائن على اسم الرسم البياني، على القيم اليومية، والتواريخ والمزيد من المعلومات. يمكن عرض هذه البيانات عن طريق مكتبة HighCharts.js
fromDate	String	تاريخ بدء التقرير
toDate	String	تاريخ انتهاء التقرير

مثال على نتيجة الطلب

كود 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"
}