پرامپت و بازخورد

ویرایش بازخورد

نمره، وزن یا توضیح بازخوردی که پیشتر ثبت کرده‌اید را عوض کنید. فقط بازخوردهای حساب خودتان را می‌توانید ویرایش کنید.

PUT/v1/feedback/{id}

فقط فیلدهایی که می‌فرستید عوض می‌شوند. فیلد ناشناخته (مثل metadata یا request_id) رد می‌شود، چون بازخورد پس از ثبت به همان درخواست وصل می‌ماند. بازخورد دیگران یا شناسه‌ی نادرست 404 feedback_not_found می‌دهد.

نمونه‌ها

curl -X PUT https://1ai.ir/v1/feedback/fbk_5RzKb8TwXq3NfYhG2mCeVu \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "value": 2,
  "comment": "Reviewed again: accurate."
}'
200پاسخ
{
  "id": "fbk_5RzKb8TwXq3NfYhG2mCeVu",
  "object": "feedback",
  "request_id": "6f1d1c52-2a0e-4c3a-9a6e-0d2f6b7c9e11",
  "value": 2,
  "weight": 1,
  "comment": "Reviewed again: accurate.",
  "metadata": {
    "ui": "web",
    "reviewer": "qa-team"
  },
  "created_at": "2026-11-08T10:15:30.000Z"
}

پارامترهای مسیر

  • idstringالزامی

    شناسه‌ی بازخورد، به شکل fbk_…، از پاسخ ثبت بازخورد.

بدنه‌ی درخواست

  • valueinteger

    نمره‌ی تازه، از ۱۰- تا ۱۰.

  • weightnumber

    وزن تازه، از ۰ تا ۱۰۰.

  • commentstring

    توضیح تازه، تا ۵۰۰۰ نویسه.

خطاها

  • invalid_request400

    مقداری بیرون از بازه است یا فیلد غیرمجاز فرستاده‌اید.

  • feedback_not_found404

    بازخوردی از شما با این شناسه نیست.

صفحه‌های مرتبط