UserGrade API
CREMA 서버에 등록된 회원등급 정보를 확인하고, 등록/수정하는 방법을 제공합니다.
List User Grades
회원등급 목록을 가져옵니다.
GET /v1/user_grades HTTP/1.1
Parameters
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit |
integer | ✖ | 한 페이지의 회원등급 목록 길이. 범위: 1 ~ 100. 기본: 30 |
page |
integer | ✖ | 페이지 번호. 최대 페이지 수는 Link HTTP header의 rel="last"에 기재되어 있습니다. 기본: 1 |
Response
HTTP/1.1 200 OK
Link: <https://api.cre.ma/v1/user_grades?page=372>; rel="last", <https://api.cre.ma/v1/user_grades&page=2>; rel="next"
[
{
"id": 1,
"name": "새싹회원",
"icon_url": "https://assets.cre.ma/p/crema-me/brand_user_grades/00/00/00/00/01/icon/a21387c475095732.jpg",
"created_at": "2015-04-17T16:03:05.000+09:00",
"updated_at": "2015-04-17T16:03:05.000+09:00"
},
{
"id": 2,
"name": "나무회원",
"icon_url": "https://assets.cre.ma/p/crema-me/brand_user_grades/00/00/00/00/02/icon/a21387c47509573f.jpg",
"created_at": "2015-04-17T16:03:05.000+09:00",
"updated_at": "2015-11-12T23:22:06.000+09:00"
}
]
Get a user grade
회원등급 하나의 상세 정보를 가져옵니다.
GET /v1/user_grades/:id HTTP/1.1
Parameters
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
integer | ✔ | 회원등급 id |
Response
HTTP/1.1 200 OK
{
"id": 1,
"name": "새싹회원",
"icon_url": "https://assets.cre.ma/p/crema-me/brand_user_grades/00/00/00/00/01/icon/a21387c475095732.jpg",
"created_at": "2015-04-17T16:03:05.000+09:00",
"updated_at": "2015-04-17T16:03:05.000+09:00"
}
Create a user grade
새로운 회원등급을 생성합니다.
POST /v1/user_grades HTTP/1.1
access_token=$ACCESS_TOKEN&name=새싹회원&icon_url=http://my.icon.com/sprout_user_grade.jpg
Parameters
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
name |
string | ✔ | 회원등급명 |
icon_url |
string | ✖ | 회원등급 이미지 주소 (아이콘 크기는 가로 20px 또는 세로 20px) |
Response
HTTP/1.1 201 Created
Location: https://api.cre.ma/v1/user_grades
{
"id": 1,
"name": "새싹회원",
"icon_url": "https://assets.cre.ma/p/crema-me/brand_user_grades/00/00/00/00/01/icon/a21387c475095732.jpg",
"created_at": "2015-11-21T01:45:14.464+09:00",
"updated_at": "2015-11-21T01:45:14.464+09:00"
}
Update a user grade
회원등급을 수정합니다.
PATCH /v1/user_grades/:id HTTP/1.1
access_token=$ACCESS_TOKEN&name=일병
Parameters
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
string | ✔ | 회원등급 id |
name |
string | ✖ | 회원등급명 |
icon_url |
string | ✖ | 회원등급 이미지 주소 |
Response
HTTP/1.1 204 No Content
Location: https://api.cre.ma/v1/user_grades/:id
Delete a user grade
회원등급 하나를 삭제합니다.
DELETE /v1/user_grades/:id HTTP/1.1
Parameters
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
integer | ✔ | 회원등급 id |
Response
HTTP/1.1 204 No Content