Paxa Labs
เข้าสู่ระบบ

ส่งความคิดเห็น

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

POST /v1/feedback ส่งรายงานผลลัพธ์ที่ผิด ปัญหาของ API หรือปัญหาของแพลตฟอร์มถึงทีม Paxa โดยผูกกับคำขอที่ระบุไว้

ดูเป็น Markdown
curl -X POST https://api.paxalabs.com/v1/feedback \
  -H "Authorization: Bearer $PAXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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": "ขอบคุณที่รอค่ะ ทางเราจะโทรกลับภายในวันนี้ค่ะ"
    }
  }'
{
  "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
}

ระบุคำขอที่รายงานเกี่ยวข้องด้วยค่า x-request-id หรือรหัสการเชื่อมต่อของเซสชันสด เพื่อให้ทีมตามรอยในบันทึกของบัญชีได้ หากผลลัพธ์ผิด ให้แนบตัวอย่างที่มีข้อมูลที่ส่งตามจริง ผลลัพธ์ที่ได้รับ และผลลัพธ์ที่คาดไว้

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

การส่งความคิดเห็นไม่ใช้เครดิตและไม่นับรวมในอัตราจำกัดคำขอ แต่ละบัญชีส่งรายงานที่มีข้อความได้ 50 รายงาน และรายงานที่มีเพียงคะแนนได้ 1,000 รายงานในทุกช่วง 24 ชั่วโมง เมื่อเกินโควตาใดโควตาหนึ่ง คำขอจะตอบ 429 feedback_limit และไม่บันทึกรายงาน รายงานไม่รองรับ Idempotency-Key จึงควรเรียก GET /v1/feedback พร้อม request_id ก่อนส่งซ้ำ

เฮดเดอร์#

authorizationBearer pxa_...จำเป็น

Authorization: Bearer pxa_... (recommended).

x-api-keypxa_...

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

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

เนื้อหา#

kind"model" or "api" or "platform" or "other"จำเป็น

What the report is about. Use model when an output was wrong or poor, api when the API misbehaved, platform for the dashboard, billing, or docs, and other for anything else.

rating"good" or "bad"

Your judgment of the output the request ids name. A rating alone is a complete report when request_ids names at least one request.

messagestring

What happened and what you expected, in plain text or Markdown.

up to 10,000 characters
request_idsarray of strings

Up to 20 x-request-id values the report is about, or the connection id of a live session. They link the report to the requests in your logs.

exampleobject

A worked case as text, with the exact input, the output you received, and the output you expected.

ดูฟิลด์ย่อย
example.inputstring

The input you sent.

up to 10,000 characters
example.outputstring

The output you received.

up to 10,000 characters
example.expectedstring

The output you expected instead.

up to 10,000 characters

การตอบกลับ#

One feedback report.

idstringจำเป็น

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

kind"model" or "api" or "platform" or "other"จำเป็น

What the report is about.

rating"good" or "bad" or nullจำเป็น

The rating sent, or null.

messagestring or nullจำเป็น

The message as stored, or null.

request_idsarray of stringsจำเป็น

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

exampleobjectจำเป็น

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

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

The example input, or null.

example.outputstring or nullจำเป็น

The example output, or null.

example.expectedstring or nullจำเป็น

The expected output, or null.

source"api" or "app"จำเป็น

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

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.

resolutionstring or nullจำเป็น

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

created_atstringจำเป็น

Creation time, ISO 8601.

resolved_atstring or nullจำเป็น

Resolution time, ISO 8601; null while open.

ข้อผิดพลาด#

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.
429feedback_limitThe account reached a daily feedback cap: 50 written reports, or 1,000 reports that carry only a rating, in the last 24 hours. Nothing was stored.
ก่อนหน้าบัญชีถัดไปรายการความคิดเห็น