التعليقات

يمثل كائن التعليق التعليقات المقدمة بشأن الأفكار.

كائن التعليق

{
  "id": "b0373e42-2ac9-4c5b-9dae-0e0be53f4320",
  "createdAt": "2025-03-07T13:22:12.557Z",
  "updatedAt": "2025-03-07T13:22:12.557Z",
  "text": "Hello World",
  "phase": {
    "name": "Grow",
    "kind": "GROW"
  },
  "sender": {
    "email": "test@test.com",
    "firstName": "Test"
  }
}

الحقول

الحقل

النوع

الوصف

المعرّف

string

المعرّف الفريد للتعليق.

createdAt

ISODate

تاريخ إنشاء التعليق.

updatedAt

ISODate

تاريخ آخر تحديث للتعليق.

النص

string

محتوى التعليق

المرحلة

المرحلة

المرحلة التي أُنشئ فيها التعليق

المرسل

المستخدم

المستخدم الذي أنشأ هذا التعليق

سرد التعليقات على فكرة

curl -X GET "https://api.ideanote.io/v1/ideas/c469e730-043d-4bda-a3a0-5e029f56c027/comments?fields=id,text,sender.firstName" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/ideas/c469e730-043d-4bda-a3a0-5e029f56c027/comments?fields=id,text,sender.firstName", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const comment = await result.json();
يعيد الأمر أعلاه JSON منظّمًا على النحو التالي:
[
  {
    "sender": {}
  },
  {
    "sender": {}
  },
  {
    "sender": {}
  }
]

تعرض نقطة النهاية هذه جميع التعليقات على فكرة.

HTTP طلب

GET /v1/ideas/:idea_id/comments

معلمات الاستعلام

المعلمة

الوصف

idea_id

معرّف الفكرة المطلوب عرض تعليقاتها

الحصول على التعليق

curl -X GET "https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320?fields=id,text,sender.firstName" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320?fields=id,text,sender.firstName", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const comment = await result.json();
يعيد الأمر أعلاه بيانات JSON منظمة على النحو التالي:
{
  "sender": {}
}

تسترجع نقطة النهاية هذه تعليقًا محددًا.

HTTP طلب

GET /v1/comments/:comment_id

معلمات الاستعلام

المَعلمة

الوصف

comment_id

معرّف التعليق المراد استرجاعه

تحديث تعليق

curl -X PUT "https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320?fields=id,text,sender.firstName" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>" \
     -d '{"text":"This is an edited comment"}'
const result = await fetch("https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320?fields=id,text,sender.firstName", {
  method: "PUT",
  body: {
    "text": "This is an edited comment"
  },
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const comment = await result.json();
يعيد الأمر أعلاه بيانات JSON منظمة على النحو التالي:
{
  "sender": {}
}

تحدّث نقطة النهاية هذه تعليقًا محددًا.

HTTP طلب

PUT /v1/comments/:comment_id

معلمات الاستعلام

المَعلمة

الوصف

comment_id

معرّف التعليق المراد تحديثه

حذف تعليق

curl -X DELETE "https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/comments/b0373e42-2ac9-4c5b-9dae-0e0be53f4320", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

تحذف نقطة النهاية هذه تعليقًا محددًا.

HTTP طلب

DELETE /v1/comments/:comment_id

مَعلمات الاستعلام

المَعلمة

الوصف

comment_id

معرّف التعليق المراد حذفه