사용자 보유 패스포트 - 단일 조회
SMTOWN 회원의 보유 Passport 정보를 제공합니다.
passport scope가 필요합니다.
변경사항
- 버전 endpoint 제공 : v1/me/passports/{idx} , 기존 me/passports/{idx} 도 사용 가능 (2022-07-13)
https://openapi.smtown.com/api/v1/me/passports/{idx}
GET https://openapi.smtown.com/api/v1/me/passports/{idx}
Authorization: Bearer 2a324609ec94f18d614d4bc425de754| 파라메타 | 필수여부 | 설명 |
|---|---|---|
Authorization |
Header 필수 | 인증 섹션에서 받은 Bearer token 입니다. |
{idx} |
필수-Proxy | 숫자로 제공 된 패스포트 고유번호 예) https://openapi.smtown.com/api/me/passports/ 21
|
성공 응답
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"idx": 21,
"name": "Passport Name",
"issuedAt": "2022-05-27T02:55:50.000Z",
"image": {
"url": "https://path.of.image/image_name.jpg",
"width": 300,
"height": 420
}
}| 파라메타 | 타입 | 설명 |
|---|---|---|
idx |
Integer | 패스포트 고유번호 |
name |
String | 패스포트 이름 |
issuedAt |
String | 발급 일자 (yyyy-MM-ddTHH:mm:ss.SSSXXX => 2022-05-27T02:55:50.000Z) |
image |
Object | 이미지 정보 |
ㄴ url |
String | 이미지 URL |
ㄴ width |
Integer | 이미지 가로 |
ㄴ height |
Integer | 이미지 세로 |
실패 응답 - Invalid token
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
"path": "https://openapi.smtown.com/api/me",
"error": "Invalid Token",
"message": "2a324609ec94f==invalid token value==",
"timestamp": "2022-04-23T23:16:03.114Z",
"status": 401
}실패 응답 - 사용자가 허용하지 않음
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
"path": "https://openapi.smtown.com/api/me",
"error": "Access Denied",
"message": "Insufficient scope for this resource",
"timestamp": "2022-06-22T20:19:55.653+0000",
"status": 403
}실패 응답 - 해당 정보가 없음 (idx 불일치) : 해당 패스포트를 소유하지 않음
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
"timestamp": "2022-07-04T16:39:48.727+0000",
"status": 400,
"error": "Bad Request",
"message": "User does not have such a passport",
"path": "/api/me/passports/55"
}