Gå til indhold
Bekræftet

List supportsager

Træk skrivebordets kø ind i dit eget produkt, filtreret, sorteret og delt i sider.

ticket_api_list er den samme filtrerede, sorterede og delte læsning, som skrivebordsadministratoren selv bruger, afgrænset til din API-nøgles eget skrivebord og uden nogensinde at medtage en anden lejers sager. Alle felter er valgfrie; en tom forespørgsel lister alt, 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.

Gennemgang

List, filtreret

Kombiner status, topic_id, reference_id og fri tekst i search, som din skærm har brug for; sort er en af date_created_ts, last_activity_ts, status_ts eller priority, og 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. Bladr om

Send det forrige svars bookmark tilbage som bookmark for at fortsætte forbi limit (op til 500 pr. kald, feltets eget erklærede loft).

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 et array af den samme snævre sagsvisning, som åbn en supportsag returnerer (ingen interactions her, det er listen, ikke detaljelæsningen), og bookmark ligger ved siden af, øverst, ikke inde i 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..."
}

Et tomt data-array er et reelt, vellykket svar for et skrivebord uden noget, der passer til filteret, ikke en fejl.

Fejl

Næste