דילוג לתוכן
אומת

רשימת קריאות תמיכה

שליפת התור של הדלפק אל המוצר שלכם, מסונן, ממוין ומחולק לעמודים.

ticket_api_list היא אותה קריאה מסוננת, ממוינת ומחולקת לעמודים שמנהל הדלפק עצמו משתמש בה, ברמת הדלפק של מפתח ה-API שלכם ולעולם בלי קריאות של דייר אחר. כל שדה הוא אופציונלי; בקשה ריקה מפרטת הכול, הפעילות האחרונה קודם.

שיטה

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 ריק הוא תשובה אמיתית ומוצלחת לדלפק שאין בו דבר שמתאים לסינון, לא שגיאה.

שגיאות

הבא