Gå til indhold
Bekræftet

Læs og opsummer dine logge

Hent et vindue af forespørgselslogge, derefter det samme vindue som grupperede tal, til en statusside eller et supportsvar.

get_logs læser de samme account_log-dokumenter tilbage, som hvert kald til /cpi skriver for dig, afgrænset til din egen konto: hvad der blev kaldt, hvorfra, og hvad der kom tilbage. get_logs_counts besvarer et snævrere spørgsmål over det samme vindue, hvor mange, grupperet, hvilket er billigere end at bladre gennem hver række selv, når et supportsvar eller en statuswidget kun har brug for et tidsrums form, ikke dets detaljer.

Metoder

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.

Gennemgang

Læs et vindue af poster

log_type, log_date_from og log_date_to er de eneste erklærede felter, men handleren læser også et ikke-erklæret log_search (fri tekst over forespørgslens/svarets brødtekster og headere) og log_status ('success' eller 'failed', efter HTTP-statusbånd). log_type: "account_log" afgrænser til denne konto automatisk, du sender aldrig selv 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. Hent det samme vindue som grupperede tal

get_logs_counts kræver også en ikke-erklæret request_type- eller response_status-værdi for at vælge, hvilket grupperet view den læser; hvis du sender ingen af dem, afvises det, det giver ikke et tomt resultat (se Fejl). request_type er logens eget request_type-felt, 'POST' for hver account_log-række, add_account_log skriver i dag. Grupperingsnøglen, response_status bygger mod, ligger i en view-definition, som dette repo ikke indeholder, så bekræft de værdier, dine egne rækker grupperes under, med get_logs først i stedet for at gætte på en.

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

Svaret

get_logs sender et Mango-find-resultat direkte videre, docs plus en bookmark til næste side:

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 sender i stedet et råt CouchDB-resultat fra et grupperet view videre, rows af { key, value }, hvor value er optællingen for den nøgle. Hvilke felter key består af, afgøres af viewet selv, ikke af denne handler; behandl den som et uigennemsigtigt gruppe-id, og læs value for tallet.

Fejl

Næste