Hopp til innholdet
Bekreftet

List supportsaker

Hent skrankens kø inn i ditt eget produkt, filtrert, sortert og delt opp i sider.

ticket_api_list er den samme filtrerte, sorterte og sidedelte lesingen skrankebehandleren selv bruker, avgrenset til din egen API-nøkkels skranke og aldri med en annen leietakers saker. Alle felt er valgfrie. En tom forespørsel lister alt, med nyeste aktivitet først.

Metode

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.

Gjennomgang

List, filtrert

Kombiner status, topic_id, reference_id og fritekst-search slik skjermen din trenger det. sort er én av date_created_ts, last_activity_ts, status_ts eller priority, dir er asc eller 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. Bla til neste side

Send forrige svars bookmark tilbake som bookmark for å fortsette forbi limit (opptil 500 per kall, feltets egen deklarerte øvre grense).

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

Svaret

data er en liste med den samme smale saksvisningen åpne en supportsak returnerer (ingen interactions her, dette er listen og ikke detaljlesingen), og bookmark ligger ved siden av, på toppnivå og ikke inni 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..."
}

En tom data-liste er et ekte, vellykket svar for en skranke uten noe som passer med filteret, ikke en feil.

Feil

Neste