사용자

/v1/users/{username}

이 엔드포인트를 사용하여 사용자 계정을 검색, 삭제 또는 업데이트합니다.

읽기

특정 사용자 계정에 대한 정보를 가져옵니다.

예

사용자 계정 정보를 가져오려면 /users/{username} 엔드포인트에서 GET 요청을 사용합니다.

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"
   }]
}

오류 코드