Sari la conținut
Verificat

Citește și rezumă jurnalele

Preia o fereastră de jurnale de cereri, apoi aceeași fereastră ca numărători grupate, pentru o pagină de stare sau un răspuns de asistență.

get_logs citește înapoi aceleași documente account_log pe care le scrie pentru tine fiecare apel către /cpi, limitate la contul tău: ce a fost apelat, de unde și ce a revenit. get_logs_counts răspunde la o întrebare mai îngustă peste aceeași fereastră, câte, grupate, ceea ce este mai ieftin decât să parcurgi singur fiecare rând când un răspuns de asistență sau un widget de stare are nevoie doar de forma unei perioade, nu de detaliul ei.

Metode

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.

Parcurgere

Citește o fereastră de intrări

log_type, log_date_from și log_date_to sunt singurele câmpuri declarate, dar handlerul citește și un log_search nedeclarat (text liber peste corpurile și antetele cererii/răspunsului) și log_status ('success' sau 'failed', după intervalul de stare HTTP). log_type: "account_log" limitează automat la acest cont, nu trimiți niciodată tu 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. Obține aceeași fereastră ca numărători grupate

get_logs_counts are nevoie și de o valoare nedeclarată request_type sau response_status ca să aleagă ce view grupat citește; dacă nu trimiți niciuna, este un refuz, nu un rezultat gol (vezi Erori). request_type este câmpul request_type al jurnalului însuși, 'POST' pentru fiecare rând account_log pe care îl scrie azi add_account_log. Cheia de grupare pe care o construiește response_status se află într-o definiție de view pe care acest repo nu o conține, confirmă mai întâi cu get_logs valorile sub care se grupează propriile tale rânduri, în loc să ghicești una.

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

Răspunsul

get_logs transmite direct un rezultat Mango find, docs plus un bookmark pentru pagina următoare:

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 transmite în schimb un rezultat brut de view grupat CouchDB, rows de { key, value }, unde value este numărul pentru acea cheie. Ce câmpuri alcătuiesc key este stabilit de view-ul însuși, nu de acest handler; tratează-l ca pe un id de grup opac și citește value pentru număr.

Erori

Urmează