getAppStats: pobierz statystyki aplikacji
Ta metoda pozyskuje statystyki dzienne twojej aplikacji, pod warunkiem zarejestrowania jej w naszym Centrum deweloperów. Statystyki dostępne są wyłącznie dla właściciela aplikacji. Niepoprawny dostęp skutkuje zwróceniem kodu ERROR_ACCESS_DENIED.
Statystyki są w takim samym formacie, z jakiego korzysta AntiCaptcha renderując wykresy JS przy pomocy biblioteki HighCharts. Możesz je przeformatować wedle swoich potrzeb, w zależności od tego w jaki sposób dane mają być przedstawiane.
Adres: https://api.anti-captcha.com/getAppStats
Metoda: POST
Content-type: application-json
Atrybuty żądania
Właściwość/atrybut | Typ | Wymagany | Przeznaczenie |
---|---|---|---|
clientKey | Łańcuch znaków (String) | Tak | |
softId | Integer | Tak | ID twojej aplikacji z Centrum deweloperów. |
mode | Łańcuch znaków (String) | Nie | Typ statystyk: errors: (domyślnie) : Dane błędów views: Odsłony aplikacji downloads: Kliknięcie łącza "Pobierz" users: Liczba użytkowników money: Zarobione pieniądze |
Przykład żądania
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
Struktura odpowiedzi
Właściwość/atrybut | Typ | Przeznaczenie |
---|---|---|
errorId | Integer | Identyfikator błędu 0 - brak błędów, operacja przebiegła pomyślnie. >0 - identyfikator błędu. Kod błędu oraz jego krótki opis dostępne są w atrybutach errorCode i errorDescription. |
errorCode | Łańcuch znaków (String) | |
errorDescription | Łańcuch znaków (String) | Krótki opis błędu. |
chartData | Tablica (Array) | Obiekt zawierający tytuł wykresu, wartości dzienne, daty i nie tylko. Gotowe do wyrenderowania za pomocą biblioteki HighCharts.js. |
fromDate | Łańcuch znaków (String) | Data początkowa raportu. |
toDate | Łańcuch znaków (String) | Data końca raportu. |
Przykład odpowiedzi
JSON bez błędów
JSON z błędem
{
"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"
}