ผู้ใช้

/v1/users/{username}

ใช้ตำแหน่งข้อมูลนี้เพื่อเรียกใช้ ลบ หรืออัพเดตบัญชีผู้ใช้

อ่าน

เรียกดูข้อมูลเกี่ยวกับบัญชีผู้ใช้ที่เฉพาะเจาะจง

ตัวอย่าง

หากต้องการเรียกใช้บัญชีผู้ใช้ ให้ใช้คำขอ GET ที่ตำแหน่งข้อมูล /users/{username}

GET /v1/users/username
Authorization: Bearer your-auth-token

เมื่อสำเร็จ การตอบกลับของคุณจะเป็นรหัสสถานะ HTTP 200 OK และเพย์โหลดที่คล้ายคลึงกับด้านล่างนี้

{
   "users": [{
     "ROLES": "ROLE_ADMIN | ROLE_USER",
     "username": "username"
   }]
}

การอัพเดต

ผู้ใช้ที่มีบทบาทเป็น ROLE_ADMIN สามารถอัพเดตรหัสผ่านที่เชื่อมโยงกับบัญชีผู้ใช้ที่มีบทบาท ROLE_ADMIN และ ROLE_USER ได้ ผู้ใช้รายบุคคลก็สามารถอัพเดตรหัสผ่านสำหรับบัญชีผู้ใช้ของตนเองได้เช่นกัน การอัพเดตรหัสผ่านของบัญชีผู้ใช้จะไม่ยกเลิกโทเค็นการเข้าถึงใดๆ ที่เชื่อมโยงกับผู้ใช้ดังกล่าว ขณะนี้ เฉพาะผู้ใช้ที่เป็น admin เท่านั้นที่จะมีบทบาทเป็น ROLE_ADMIN ส่วนผู้ใช้รายอื่นจะมีบทบาทเป็น ROLE_USER

ตัวอย่าง

หากต้องการอัพเดตรหัสผ่านของบัญชี ให้ระบุโทเค็น Bearer พร้อมกับชื่อผู้ใช้และรหัสผ่านใหม่

PUT /v1/users/username
Authorization: Bearer your-auth-token
   
{
  "password": "new-password"
}

หากสำเร็จ รหัสผ่านที่เชื่อมโยงกับชื่อผู้ใช้จะได้รับการอัพเดต ระบบจะส่งคืนรหัสสถานะ HTTP 200 OK พร้อมเพย์โหลดที่คล้ายคลึงกับด้านล่างนี้

{
   "users": [{
      "username": "username"
   }]
}

การลบ

หากบัญชีผู้ใช้ถูกบุกรุกหรือมีสาเหตุอื่นที่ทำให้ต้องลบบัญชี admin จะต้องลบบัญชีนั้น หลังจากที่คุณลบบัญชีผู้ใช้สำเร็จแล้ว โทเค็นทั้งหมดที่ผูกกับบัญชีผู้ใช้นั้นจะถูกลบออกจากระบบด้วย

ตัวอย่าง

ใช้การเรียกใช้ API ต่อไปนี้เพื่อลบบัญชีผู้ใช้ โดยที่ username เป็นชื่อของบัญชีผู้ใช้ที่คุณต้องการลบ โทเค็น Bearer คือโทเค็นที่เป็นของบัญชี admin

DELETE /v1/users/username
Authorization: Bearer your-auth-token

หากสำเร็จ บัญชีผู้ใช้จะถูกลบ การตอบกลับจะมีรหัสสถานะ HTTP 200 OK และเพย์โหลดดังต่อไปนี้

{
   "users": [{
      "username": "username"
   }]
}

รหัสข้อผิดพลาด