Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Ανάγνωση και σύνοψη των αρχείων καταγραφής

Φέρτε ένα χρονικό παράθυρο αρχείων καταγραφής αιτημάτων, και μετά το ίδιο παράθυρο ως ομαδοποιημένα πλήθη, για μια σελίδα κατάστασης ή μια απάντηση υποστήριξης.

Το get_logs διαβάζει πίσω τα ίδια έγγραφα account_log που γράφει για εσάς κάθε κλήση προς το /cpi, περιορισμένα στον δικό σας λογαριασμό: τι καλέστηκε, από πού και τι επέστρεψε. Το get_logs_counts απαντά σε ένα στενότερο ερώτημα πάνω στο ίδιο παράθυρο, πόσα, ομαδοποιημένα, κάτι που είναι φθηνότερο από το να σελιδοποιήσετε μόνοι σας κάθε γραμμή όταν μια απάντηση υποστήριξης ή ένα widget κατάστασης χρειάζεται μόνο το σχήμα μιας περιόδου και όχι τη λεπτομέρειά της.

Μέθοδοι

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.

Οδηγός βήμα προς βήμα

Διαβάστε ένα παράθυρο εγγραφών

Τα log_type, log_date_from και log_date_to είναι τα μόνα δηλωμένα πεδία, αλλά ο χειριστής διαβάζει επίσης ένα μη δηλωμένο log_search (ελεύθερο κείμενο πάνω στα σώματα και τα headers αιτήματος/απάντησης) και ένα log_status ('success' ή 'failed', ανά ζώνη κατάστασης HTTP). Το log_type: "account_log" περιορίζει αυτόματα σε αυτόν τον λογαριασμό: δεν περνάτε ποτέ μόνοι σας το 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. Πάρτε το ίδιο παράθυρο ως ομαδοποιημένα πλήθη

Το get_logs_counts χρειάζεται επίσης μια μη δηλωμένη τιμή request_type ή response_status για να επιλέξει ποια ομαδοποιημένη προβολή θα διαβάσει: αν δεν στείλετε καμία, είναι άρνηση και όχι κενό αποτέλεσμα (δείτε τα Σφάλματα). Το request_type είναι το δικό του πεδίο request_type του αρχείου καταγραφής, 'POST' για κάθε γραμμή account_log που γράφει σήμερα το add_account_log. Το κλειδί ομαδοποίησης με το οποίο χτίζεται το response_status βρίσκεται σε έναν ορισμό προβολής που αυτό το repo δεν φέρει: επιβεβαιώστε πρώτα με το get_logs κάτω από ποιες τιμές ομαδοποιούνται οι δικές σας γραμμές αντί να μαντέψετε μία.

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

Η απάντηση

Το get_logs περνά ένα αποτέλεσμα Mango find ως έχει, docs συν ένα bookmark για την επόμενη σελίδα:

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 περνά αντίθετα ένα ακατέργαστο αποτέλεσμα ομαδοποιημένης προβολής CouchDB, rows με στοιχεία { key, value } όπου το value είναι το πλήθος για αυτό το κλειδί. Ποια πεδία απαρτίζουν το key ορίζεται από την ίδια την προβολή και όχι από αυτόν τον χειριστή: αντιμετωπίστε το ως αδιαφανές αναγνωριστικό ομάδας και διαβάστε το value για τον αριθμό.

Σφάλματα

Επόμενο