Przejdź do treści
Zweryfikowano

Odczytaj i podsumuj swoje logi

Pobierz okno logów żądań, potem to samo okno jako zgrupowane liczniki, do strony statusu lub odpowiedzi dla wsparcia.

get_logs odczytuje te same dokumenty account_log, które każde wywołanie /cpi zapisuje dla Ciebie, w zakresie Twojego własnego konta: co wywołano, skąd i co wróciło. get_logs_counts odpowiada na węższe pytanie dla tego samego okna, ile ich jest, zgrupowanych, co jest tańsze niż przeglądanie każdego wiersza samodzielnie, gdy odpowiedź dla wsparcia lub widżet statusu potrzebuje tylko kształtu okresu, a nie jego szczegółów.

Metody

POST/cpi/get_logs
user

Get Logs

Queries logs of a given type within a timestamp range, with optional search, paging, and status filters.

POST/cpi/get_logs_counts
user

Get Logs Counts

Returns grouped log counts by request type or response status within a timestamp range.

Krok po kroku

Odczytaj okno wpisów

log_type, log_date_from i log_date_to to jedyne zadeklarowane pola, ale procedura obsługi czyta też niezadeklarowane log_search (wolny tekst po treściach i nagłówkach żądań/odpowiedzi) oraz log_status ('success' lub 'failed', według pasma statusu HTTP). log_type: "account_log" automatycznie ogranicza do tego konta, nigdy sam nie przekazujesz uid.

curl -s https://xuda.ai/cpi/get_logs \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "log_type": "account_log",
    "log_date_from": 1735689600000,
    "log_date_to": 1738368000000,
    "log_status": "failed"
  }'
const res = await fetch('https://xuda.ai/cpi/get_logs', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    log_type: 'account_log',
    log_date_from: Date.UTC(2025, 0, 1),
    log_date_to: Date.UTC(2025, 1, 1),
    log_status: 'failed',
  }),
});
const { code, data } = await res.json();
if (code > 0) for (const row of data.docs) console.log(row.method, row.response_status_code);
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_logs',
    json={
        'api_key': 'YOUR_API_KEY',
        'log_type': 'account_log',
        'log_date_from': 1735689600000,
        'log_date_to': 1738368000000,
        'log_status': 'failed',
    },
)
body = res.json()
if body['code'] > 0:
    for row in body['data']['docs']:
        print(row['method'], row['response_status_code'])

2. Pobierz to samo okno jako zgrupowane liczniki

get_logs_counts potrzebuje też niezadeklarowanej wartości request_type lub response_status, żeby wybrać, który zgrupowany widok czyta; wysłanie żadnej z nich to odmowa, a nie pusty wynik (zobacz Błędy). request_type to własne pole request_type logu, 'POST' dla każdego wiersza account_log, który dziś zapisuje add_account_log. Klucz grupowania, względem którego buduje się response_status, żyje w definicji widoku, której to repozytorium nie zawiera, więc potwierdź najpierw przez get_logs, pod jakimi wartościami grupują się Twoje własne wiersze, zamiast zgadywać.

curl -s https://xuda.ai/cpi/get_logs_counts \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "log_type": "account_log",
    "log_date_from": 1735689600000,
    "log_date_to": 1738368000000,
    "request_type": "POST"
  }'
const res = await fetch('https://xuda.ai/cpi/get_logs_counts', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    log_type: 'account_log',
    log_date_from: Date.UTC(2025, 0, 1),
    log_date_to: Date.UTC(2025, 1, 1),
    request_type: 'POST',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_logs_counts',
    json={
        'api_key': 'YOUR_API_KEY',
        'log_type': 'account_log',
        'log_date_from': 1735689600000,
        'log_date_to': 1738368000000,
        'request_type': 'POST',
    },
)
body = res.json()

Odpowiedź

get_logs przekazuje wynik Mango find wprost, docs plus bookmark do następnej strony:

json
{
  "code": 1,
  "data": {
    "docs": [
      {
        "_id": "log_9c21ff",
        "docType": "account_log",
        "ts": 1737042311422,
        "method": "create_contact",
        "source": "api",
        "channel": "api",
        "api_pk": "pk_7f2a...",
        "req_body": { "name": "Priya Shah", "email": "[email protected]" },
        "response_status_code": 200,
        "response_data": "{\"contact_id\":\"cnt_a91f0e\"}",
        "user_email": "[email protected]",
        "date_created": 1737042311422
      }
    ],
    "bookmark": "g1AAAABweJzLYWBg..."
  }
}

get_logs_counts przekazuje zamiast tego surowy wynik zgrupowanego widoku CouchDB, rows z { key, value }, gdzie value to licznik dla danego klucza. To, z jakich pól składa się key, ustala sam widok, a nie ta procedura obsługi; traktuj go jako nieprzezroczysty identyfikator grupy i czytaj value, żeby poznać liczbę.

Błędy

Dalej