Paxa Labs

ดูรายการความคิดเห็น

GEThttps://api.paxalabs.com/v1/feedback

GET /v1/feedback แสดงรายงานความคิดเห็นของบัญชี เรียงจากใหม่ไปเก่า พร้อมสถานะและข้อความจากทีมของแต่ละรายงาน

ดูเป็น Markdown
curl "https://api.paxalabs.com/v1/feedback?request_id=7d9c2b7e-4a41-4c8e-9a35-1f26d8c04b7a" \
  -H "Authorization: Bearer $PAXA_API_KEY"
{
  "reports": [
    {
      "id": "3f1c9a52-8e4b-4d7a-b6c0-2e5f9d8a1b47",
      "kind": "model",
      "rating": "bad",
      "message": "The reply to a customer dropped the polite register.",
      "request_ids": [
        "7d9c2b7e-4a41-4c8e-9a35-1f26d8c04b7a"
      ],
      "example": {
        "input": "Thank you for waiting. We will call you back today.",
        "output": "ขอบคุณที่รอ เดี๋ยวโทรกลับวันนี้",
        "expected": "ขอบคุณที่รอค่ะ ทางเราจะโทรกลับภายในวันนี้ค่ะ"
      },
      "source": "api",
      "status": "open",
      "resolution": null,
      "created_at": "2026-09-28T06:12:44.301Z",
      "resolved_at": null
    }
  ],
  "has_more": false
}

ส่ง request_id เพื่อค้นหารายงานที่ระบุคำขอนั้นก่อนส่งรายงานเพิ่ม หากต้องการหน้าถัดไป ให้ส่ง id ของรายงานสุดท้ายเป็น before ตราบที่ has_more เป็น true

รายงานที่มีข้อความจะรอดำเนินการจนกว่าทีมจะดำเนินการ และ resolution จะมีข้อความจากทีมเมื่อทีมเขียนไว้ ส่วนรายงานที่มีเพียงคะแนนจะคงสถานะรอดำเนินการ

เฮดเดอร์#

authorizationBearer pxa_...จำเป็น

Authorization: Bearer pxa_... (recommended).

x-api-keypxa_...

Alternative to the Authorization header. Ignored when Authorization is present.

การยืนยันตัวตน

พารามิเตอร์คิวรี#

limitinteger

Reports per page.

ค่าเริ่มต้น 20min 1max 50
beforestring

A report id from this account. The page starts with the next older report.

pattern ^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
request_idstring

Lists only reports naming this request id. Check it before sending a report again.

pattern ^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

การตอบกลับ#

One page of the account's feedback reports.

reportsarray of objectsจำเป็น

The account's reports, newest first.

ดูฟิลด์ย่อย
reports[].idstringจำเป็น

Report id. Pass it as before to list older reports.

reports[].kind"model" or "api" or "platform" or "other"จำเป็น

What the report is about.

reports[].rating"good" or "bad" or nullจำเป็น

The rating sent, or null.

reports[].messagestring or nullจำเป็น

The message as stored, or null.

reports[].request_idsarray of stringsจำเป็น

The request ids sent, lowercased, deduplicated, and sorted.

reports[].exampleobjectจำเป็น

The example as stored; every field is null without one.

ดูฟิลด์ย่อย
reports[].example.inputstring or nullจำเป็น

The example input, or null.

reports[].example.outputstring or nullจำเป็น

The example output, or null.

reports[].example.expectedstring or nullจำเป็น

The expected output, or null.

reports[].source"api" or "app"จำเป็น

api: sent to this endpoint with a key. app: sent from the dashboard.

reports[].status"open" or "resolved"จำเป็น

A report is open until the team has acted on it, and resolved from then on. A report that carries only a rating feeds quality measures and stays open.

reports[].resolutionstring or nullจำเป็น

The team's note on the outcome; null when none was written.

reports[].created_atstringจำเป็น

Creation time, ISO 8601.

reports[].resolved_atstring or nullจำเป็น

Resolution time, ISO 8601; null while open.

has_morebooleanจำเป็น

Older reports exist. Pass the last report's id as before to fetch them.

ข้อผิดพลาด#

400validationThe request body, query, or headers failed validation against the endpoint schema, or broke a rule the endpoint's reference states. A field the schema refused adds two fields to the problem body. path names the first failing field by location and name in dot form, such as body.voice or headers.idempotency-key. A body that could not be read gives the path body alone. reason is one stable code from the validation reasons list.
401unauthorizedThe request carried no API key, or the key is invalid or disabled.