Aller au contenu
Vérifié

Lire et résumer vos journaux

Récupérez une fenêtre de journaux de requêtes, puis la même fenêtre sous forme de comptes regroupés, pour une page d'état ou une réponse au support.

get_logs relit les mêmes documents account_log que chaque appel à /cpi écrit pour vous, limités à votre propre compte : ce qui a été appelé, d'où, et ce qui est revenu. get_logs_counts répond à une question plus étroite sur la même fenêtre, combien, regroupé, ce qui coûte moins cher que de parcourir vous-même chaque ligne quand une réponse au support ou un widget d'état n'a besoin que de la forme d'une période, pas de son détail.

Méthodes

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.

Pas à pas

Lire une fenêtre d'entrées

log_type, log_date_from et log_date_to sont les seuls champs déclarés, mais le gestionnaire lit aussi un log_search non déclaré (texte libre sur les corps et les en-têtes de requête et de réponse) et un log_status ('success' ou 'failed', selon la tranche de statut HTTP). log_type: "account_log" se limite automatiquement à ce compte : vous ne passez jamais uid vous-même.

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. Obtenir la même fenêtre sous forme de comptes regroupés

get_logs_counts a aussi besoin d'une valeur non déclarée request_type ou response_status pour choisir la vue groupée qu'elle lit ; n'envoyer ni l'une ni l'autre est un refus, pas un résultat vide (voir Erreurs). request_type est le champ request_type du journal lui-même, 'POST' pour chaque ligne account_log que add_account_log écrit aujourd'hui. La clé de regroupement que construit response_status se trouve dans une définition de vue que ce dépôt ne contient pas : confirmez d'abord avec get_logs les valeurs sous lesquelles vos propres lignes se regroupent, plutôt que d'en deviner une.

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

La réponse

get_logs renvoie tel quel un résultat Mango find, docs plus un bookmark pour la page suivante :

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 renvoie à la place un résultat brut de vue groupée CouchDB, des rows de { key, value } où value est le compte pour cette clé. Les champs qui composent key sont définis par la vue elle-même, pas par ce gestionnaire ; traitez-la comme un identifiant de groupe opaque et lisez value pour le nombre.

Erreurs

Suite