توثيق API

اكتب لي توثيق (Documentation) واضح لـ API/Endpoint التالي. المطلوب لكل Endpoint: - الوصف والغرض منه. - الـ Method والمسار (Path). - المعاملات (Parameters) المطلوبة والاختيارية مع نوع كل واحد. - مثال Request ومثال Response. - الأخطاء المحتملة وأكوادها. تفاصيل الـ API/الكود: [الصق هنا]