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

Λίστα αιτημάτων υποστήριξης

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

Το ticket_api_list είναι η ίδια φιλτραρισμένη, ταξινομημένη, σελιδοποιημένη ανάγνωση που χρησιμοποιεί ο ίδιος ο διαχειριστής του γραφείου, περιορισμένη στο δικό σας γραφείο του κλειδιού API και χωρίς να περιλαμβάνει ποτέ αιτήματα άλλου tenant. Κάθε πεδίο είναι προαιρετικό: ένα κενό αίτημα καταγράφει τα πάντα, με πρώτη την πιο πρόσφατη δραστηριότητα.

Μέθοδος

POST/cpi/ticket_api_list
user

API: List Tickets

External service: lists tickets on the desk owned by the API key, with the same filters as the manager.

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

Λίστα, με φίλτρα

Συνδυάστε τα status, topic_id, reference_id και το ελεύθερο κείμενο search όπως τα χρειάζεται η οθόνη σας: το sort είναι ένα από τα date_created_ts, last_activity_ts, status_ts ή priority, και το dir είναι asc ή desc.

curl -s https://xuda.ai/cpi/ticket_api_list \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "status": "open",
    "sort": "last_activity_ts",
    "dir": "desc",
    "limit": 25
  }'
const res = await fetch('https://xuda.ai/cpi/ticket_api_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    status: 'open',
    sort: 'last_activity_ts',
    dir: 'desc',
    limit: 25,
  }),
});
const { code, data, bookmark } = await res.json();
if (code > 0) for (const t of data) console.log(t.ticket_no, t.status, t.subject);
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_list',
    json={
        'api_key': 'YOUR_API_KEY',
        'status': 'open',
        'sort': 'last_activity_ts',
        'dir': 'desc',
        'limit': 25,
    },
)
body = res.json()
if body['code'] > 0:
    for t in body['data']:
        print(t['ticket_no'], t['status'], t['subject'])

2. Γυρίστε τη σελίδα

Περάστε το bookmark της προηγούμενης απάντησης πίσω ως bookmark για να συνεχίσετε πέρα από το limit (έως 500 ανά κλήση, το δηλωμένο ανώτατο όριο του ίδιου του πεδίου).

curl -s https://xuda.ai/cpi/ticket_api_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","status":"open","limit":25,"bookmark":"g1AAAABweJzLYWBg..."}'
const res = await fetch('https://xuda.ai/cpi/ticket_api_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', status: 'open', limit: 25, bookmark: previousBookmark }),
});
import requests

res = requests.post(
    'https://xuda.ai/cpi/ticket_api_list',
    json={'api_key': 'YOUR_API_KEY', 'status': 'open', 'limit': 25, 'bookmark': previous_bookmark},
)

Η απάντηση

Το data είναι ένας πίνακας με την ίδια στενή προβολή αιτήματος που επιστρέφει το άνοιγμα αιτήματος υποστήριξης (χωρίς interactions εδώ, αυτή είναι η λίστα, όχι η ανάγνωση λεπτομερειών), και το bookmark βρίσκεται δίπλα του, στο ανώτατο επίπεδο, όχι μέσα στο data:

json
{
  "code": 1,
  "data": [
    {
      "ticket_no": "TK-1042",
      "id": "tkt_3b7a10982341",
      "status": "open",
      "status_stage": "new",
      "subject": "Cannot export invoices",
      "requester": { "name": "Priya Shah", "email": "[email protected]", "phone": "", "company": "" },
      "priority": 2,
      "last_activity_ts": 1737042311422
    }
  ],
  "bookmark": "g1AAAABweJzLYWBg..."
}

Ένας κενός πίνακας data είναι πραγματική, επιτυχής απάντηση για ένα γραφείο χωρίς τίποτα που να ταιριάζει με το φίλτρο, όχι σφάλμα.

Σφάλματα

Επόμενο