İçeriğe geç
Doğrulandı

Destek taleplerini listeleyin

Masanın kuyruğunu süzülmüş, sıralanmış ve sayfalanmış olarak kendi ürününüze çekin.

ticket_api_list, masa yöneticisinin kendisinin kullandığı aynı süzülmüş, sıralanmış, sayfalanmış okumadır. API anahtarınızın kendi masasına kapsamlıdır ve başka bir kiracının taleplerini asla içermez. Her alan isteğe bağlıdır: boş bir istek, en yeni etkinlik önce olacak şekilde her şeyi listeler.

Yöntem

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.

Anlatım

Süzülmüş olarak listeleyin

status, topic_id, reference_id ve serbest metin search alanlarını ekranınızın ihtiyacına göre birleştirin. sort, date_created_ts, last_activity_ts, status_ts veya priority değerlerinden biridir, dir ise asc veya desc olur.

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. Sayfayı çevirin

limit değerini aşıp devam etmek için önceki yanıttaki bookmark değerini bookmark olarak geri geçin (çağrı başına en çok 500, alanın kendi bildirilmiş tavanı).

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},
)

Yanıt

data, destek talebi açma tarifinin döndürdüğü aynı dar talep görünümünün bir dizisidir (burada interactions yok, bu liste, ayrıntı okuması değil) ve bookmark onun yanında, data içinde değil en üst düzeyde durur:

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..."
}

Boş bir data dizisi, süzgece uyan hiçbir şeyi olmayan bir masa için gerçek ve başarılı bir yanıttır, hata değildir.

Hatalar

Sonraki