Přeskočit na obsah
Ověřeno

Číst a shrnout své logy

Načtěte okno logů požadavků a pak totéž okno jako seskupené počty, pro stavovou stránku nebo odpověď podpoře.

get_logs čte zpět tytéž dokumenty account_log, které pro vás zapisuje každé volání /cpi, s rozsahem vašeho vlastního účtu: co bylo voláno, odkud a co se vrátilo. get_logs_counts odpovídá na užší otázku nad stejným oknem, kolik, seskupeně, což je levnější než procházet každý řádek stránku po stránce, když odpověď podpoře nebo stavový widget potřebuje jen tvar období, ne jeho detail.

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.

Postup

Přečíst okno záznamů

log_type, log_date_from a log_date_to jsou jediná deklarovaná pole, ale obslužná rutina čte také nedeklarované log_search (volný text přes těla a hlavičky požadavků/odpovědí) a log_status ('success' nebo 'failed', podle pásma stavu HTTP). log_type: "account_log" se automaticky omezí na tento účet, uid nikdy neposíláte sami.

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. Získat totéž okno jako seskupené počty

get_logs_counts také potřebuje nedeklarovanou hodnotu request_type nebo response_status, aby vybrala, který seskupený pohled čte; poslat ani jednu je odmítnutí, ne prázdný výsledek (viz Chyby). request_type je vlastní pole logu request_type, 'POST' u každého řádku account_log, který dnes add_account_log zapisuje. Klíč seskupení, podle kterého se response_status staví, žije v definici pohledu, kterou tento repozitář nenese, hodnoty, pod kterými se vaše řádky seskupují, si ověřte nejdřív přes get_logs, ne hádáním.

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()

Odpověď

get_logs předává výsledek Mango find beze změny, docs plus bookmark pro další stránku:

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 místo toho předává syrový výsledek seskupeného pohledu CouchDB, rows s položkami { key, value }, kde value je počet pro daný klíč. Která pole tvoří key, určuje samotný pohled, ne tato obslužná rutina; berte ho jako neprůhledné ID skupiny a číslo čtěte z value.

Chyby

Dále