الفرق

تُنشأ الفرق في مساحة العمل. ويمكن إسناد المستخدمين والمهام إلى الفرق.

كائن الفريق

{
  "id": "483b5713-37e4-4e55-bdca-77c122825a33",
  "createdAt": "2025-03-07T13:22:11.587Z",
  "updatedAt": "2025-03-07T13:22:11.587Z",
  "title": "Designers"
}

الحقول

الحقل

النوع

الوصف

المعرّف

string

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

createdAt

ISODate

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

updatedAt

ISODate

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

العنوان

string

اسم الفريق

سرد الفرق

curl -X GET "https://api.ideanote.io/v1/teams?fields=id,title" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/teams?fields=id,title", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const teams = await result.json();
يعرض الأمر أعلاه بيانات JSON منظّمة على النحو التالي:
[
  {},
  {}
]

تعرض نقطة النهاية هذه الفرق.

HTTP طلب

GET /v1/teams

الحصول على فريق

curl -X GET "https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33?fields=id,title" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33?fields=id,title", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

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

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

HTTP طلب

GET /v1/teams/:team_id

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

المعلمة

الوصف

team_id

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

إنشاء فريق

curl -X POST "https://api.ideanote.io/v1/teams?fields=id,title" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>" \
     -d '{"title":"Development"}'
const result = await fetch("https://api.ideanote.io/v1/teams?fields=id,title", {
  method: "POST",
  body: {
    "title": "Development"
  },
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

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

تنشئ نقطة النهاية هذه فريقًا جديدًا.

HTTP طلب

POST /v1/teams

تحديث الفريق

curl -X PUT "https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33?fields=id,title" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>" \
     -d '{"title":"Reviewers"}'
const result = await fetch("https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33?fields=id,title", {
  method: "PUT",
  body: {
    "title": "Reviewers"
  },
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

const team = await result.json();
يعيد الأمر أعلاه بيانات JSON بالهيكل التالي:
{}

تُحدّث نقطة النهاية هذه فريقًا محددًا

HTTP طلب

PUT /v1/teams/:team_id

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

المعلمة

الوصف

team_id

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

حذف الفريق

curl -X DELETE "https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API Token>"
const result = await fetch("https://api.ideanote.io/v1/teams/483b5713-37e4-4e55-bdca-77c122825a33", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <API Token>",
  }
});

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

HTTP طلب

DELETE /v1/teams/:team_id

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

المعلمة

الوصف

team_id

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