API 이름

Create User API

API 개요

이 API는 새로운 사용자를 생성하는 데 사용됩니다.

엔드포인트

POST /users

요청

요청 헤더

Content-Type: application/json
Authorization: Bearer {access_token}

요청 바디

{
  "name": "John Doe",
  "email": "johndoe@example.com",
  "password": "secretpassword"
}

매개변수

없음

응답

응답 헤더

Content-Type: application/json

응답 바디

{
  "id": 123,
  "name": "John Doe",
  "email": "johndoe@example.com"
}

상태 코드

• 201: 성공적으로 사용자를 생성함
• 401: 인증되지 않은 요청. 액세스 토큰이 누락되었거나 유효하지 않습니다.
• 400: 잘못된 요청 형식으로 인해 사용자를 생성할 수 없음
• 500: 서버 오류

예시

요청 예시

POST /users
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "name": "John Doe",
  "email": "johndoe@example.com",
  "password": "secretpassword"
}

응답 예시

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": 123,
  "name": "John Doe",
  "email": "johndoe@example.com"
}

오류 처리

• 401: 인증되지 않은 요청. 액세스 토큰이 누락되었거나 유효하지 않습니다.
• 400: 잘못된 요청 형식으로 인해 사용자를 생성할 수 없음. 요청 바디에 필수 필드가 누락되었거나 잘못된 형식으로 제공됨.
• 500: 서버 오류. 사용자 생성 중에 내부 서버 오류가 발생함

보안

이 API는 SSL/TLS를 통해 암호화된 연결을 사용합니다.

인증

이 API는 인증이 필요합니다. 액세스 토큰을 요청 헤더의 Authorization 필드에 Bearer 스키마와 함께 제공해야 합니다.

Rate Limiting

이 API는 1분당 최대 1000개의 요청을 허용합니다.

버전 관리

현재 버전: v1

변경 이력

• v1 (2023-06-01): 초기 버전