Image
νΉμ μ μ μ μ΄λ―Έμ§λ₯Ό μ
λ‘λν©λλ€.
POST https://service-stage.pic-origin.com/api/v1/users/{user_id}/images
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Headers
Authorization*
String
User ${Token}
Request Body
folder_id
String
μ΄λ―Έμ§κ° λ€μ΄κ° ν΄λμ id (default = None)
ex) Bm9XRCT48C
latitude
String
μλ(default = None)
ex) 37.3595316
longitude
String
κ²½λ(default = None)
ex) 127.1052133
address_det
String
λ, νΈμ(default = None)
ex) 101λ 1101
image_data*
String
μ΄λ―Έμ§ λ°μ΄λ리
created_at
String
μ΄λ―Έμ§ μμ± λ μ§(default = None)
ex)20240102_111043
has_det
String
μ΄λ―Έμ§ μμΈ μ£Όμ μ‘΄μ¬ (λμλ¬Έμ κ΅¬λΆ μμ΄ 'true' or 'false') (default=None)
ex) None
is_shared
String
μ΄λ―Έμ§ 곡μ μ¬λΆ (λμλ¬Έμ κ΅¬λΆ μμ΄ 'true' or 'false') (default = False)
ex)False
message
String
λ©λͺ¨ λ©μμ§
ex)ν μ€νΈ λ©μμ§
{
"status_code": 200,
"message": "μ±κ³΅",
"result": {
"id": "05be0bc8-ea54-4260-9d56-a46eca2635c3",
"user_id": "B227FBWvKJ",
"folder_id": null,
"filename": "20240327_130910_675_20240327_130910_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG",
"org_path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_130910_675_20240327_130910_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T040910Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=2dfcfbabad58f8acf008cf3ca25cd694fde084fadb1c04b3a43ae424ae60ef16",
"path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_130910_675_20240327_130910_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T040910Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=2dfcfbabad58f8acf008cf3ca25cd694fde084fadb1c04b3a43ae424ae60ef16",
"lat": 37.3595316,
"lng": 127.1052133,
"address_road": "κ²½κΈ° μ±λ¨μ λΆλΉκ΅¬ λΆμ λ‘ 6",
"address_land": "κ²½κΈ° μ±λ¨μ λΆλΉκ΅¬ μ μλ",
"address_land_number": "178-1",
"building_name": "NAVERκ·Έλ¦°ν©ν 리",
"address_det": "test",
"created_at": "20240327_130910",
"updated_at": "20240327_130910",
"delete_at": null,
"filedata_total": 1,
"is_signed": false,
"is_shared": true,
"has_det": null,
"filesize_mb": 0.92,
"image_resource_type": "PNG",
"resolution": "1023x540",
"memos": [
{
"id": "DN4GdbhkSs",
"image_id": "05be0bc8-ea54-4260-9d56-a46eca2635c3",
"message": "ν
μ€νΈ λ©μμ§\nν
μ€νΈ \nλ©μμ§",
"is_client": true,
"created_at": "20240327_130910",
"updated_at": "20240327_130910"
}
],
"filedatas": [
{
"original_image_id": "05be0bc8-ea54-4260-9d56-a46eca2635c3",
"id": "db1f94fd-3afe-4c2d-a2b5-c59681e09a95",
"path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_130910_675_20240327_130910_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T040910Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=2dfcfbabad58f8acf008cf3ca25cd694fde084fadb1c04b3a43ae424ae60ef16",
"created_at": "20240327_130910",
"hashdata": "be901b8cf6d81a7c833dd82edc242fbd",
"filesize_mb": 0.92,
"image_resource_type": "PNG",
"resolution": "1023x540"
}
]
}
}νΉμ μ μ μ μλ³Έ μ΄λ―Έμ§ ID 리μ€νΈλ₯Ό μ
λ ₯ λ°μ, ν΄λΉ μ΄λ―Έμ§λ€μ μ΅μ μ 보λ₯Ό λ°νν©λλ€. (μ΄λ―Έμ§ 곡μ )
POST https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/share
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Headers
Authorization*
String
User ${Token}
Request Body
image_ids*
List[str]
μ΄λ―Έμ§ uuid 리μ€νΈ
ex) ["c84a180e-599c-4787-8972-aed430e157be", "d7aa7944-cb2b-498f-8327-8ae9e27f38c4"]
νΉμ μ μ μ μ΄λ―Έμ§λ₯Ό μ‘°νν©λλ€.
GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Query Parameters
with_history
Bool
μ΄λ―Έμ§ μμ λ΄μ κ³΅κ° μ¬λΆ (default=False)
ex)True
last_index
Int
νμ΄μ§ μμ μΈλ±μ€ (default=None)
ex) 10
page_size
Int
ν νμ΄μ§ λΉ ν¬κΈ° (default=60)
ex)60
sort_by
String
μ λ ¬ κΈ°μ€(default=created_at) [created_at, updated_at, name]
ex)created_at
sort_order
String
μ λ ¬ λ°©μ(default=asc)[asc, desc]
ex)desc
search
String
κ²μμ΄ (default=None)
view_type*
String
μ΄λ―Έμ§ λ·° λ°©μ(default=None)[grid, list, grid_sep, map]
grid : 그리λ
list : 리μ€νΈ
grid_sep: μ£Όμλ‘ λλ μ§ κ·Έλ¦¬λ
map: 맡
latitude
Float
μλ(default=None)
ex)37.135551
longitude
Float
κ²½λ(default=None)
ex)128.133414
has_delete_at
Bool
ν΄μ§ν΅(default=None)
ex)True
download
Bool
view_type listμ download(default=None)
ex)True
has_det
Bool
μμΈμ£Όμμ¬λΆ(default=None)
date
String
λ μ§(default=None)
ex)20240118
search_type
String
κ²μνμ (default=None)[folder_name, address_all, address_sort, days_range, date_range]
folder_name : ν΄λΉ ν΄λμ νμ μ΄λ―Έμ§
address_all : λͺ¨λ μ£Όμ
address_sort: 컀μ€ν μ£Όμ(ex) λ§κ³‘λ λ§κ³‘μ 밸리14λ¨μ§ 302νΈ)
days_range
Int
search_type == days_range μμμ κΈ°ν(μΌμ) (default=90)
ex) 90 (90μΌ)
search_date_by
String
κΈ°νμ λν κ²μ(search_type == days_range or date_range) μμμ νν°λ§ κΈ°μ€ λ μ§ (default=created_at) [created_at, updated_at]
ex) created_at
start_date
String
search_type == date_range μμμ μμ λ μ§ (default=None)
ex) 20240301
end_date
String
search_type == date_range μμμ μ’ λ£ λ μ§ (default=None)
ex) 20240305
with_custom
Bool
μ΄λ―Έμ§ 컀μ€ν κ³΅κ° μ¬λΆ (default=None)
ex) True
with_memo
Bool
μ΄λ―Έμ§ λ©λͺ¨ κ³΅κ° μ¬λΆ (default=None)
ex) True
days_or_date_range
String
λ μ§νμ (default=None)
days_range: μ£Όμ΄μ§ κΈ°ν(days_range) μ΄μ (current_time - days_range)λΆν° νμ¬κΉμ§ date_range: start_date(ν΄λΉ λ μ§μ00:00:00) ~ end_date(ν΄λΉ λ μ§μ 23:59:59)
Headers
Authorization*
String
User ${Token}
νΉμ μ μ μ μ΄λ―Έμ§ κ·Έλ£Ήμ μ‘°νν©λλ€.
GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/group
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Query Parameters
last_index
int
νμ΄μ§ μμ μΈλ±μ€ (default=None)
ex) 10
page_size
int
ν νμ΄μ§ λΉ ν¬κΈ° (default=60)
ex)60
sort_by
String
μ λ ¬ κΈ°μ€(default=created_at) [created_at, updated_at, name]
ex)created_at
sort_order
String
μ λ ¬ λ°©μ(default=asc)[asc, desc]
ex)desc
search
String
κ²μμ΄ (default=None)
search_type
String
κ²μνμ (default=None)[folder_name, address_all, address_sort, days_range, date_range]
folder_name : ν΄λΉ ν΄λμ νμ μ΄λ―Έμ§
address_all : λͺ¨λ μ£Όμ
address_sort: 컀μ€ν μ£Όμ(ex) λ§κ³‘λ λ§κ³‘μ 밸리14λ¨μ§ 302νΈ)
days_range
Int
search_type == days_range μμμ κΈ°ν(μΌμ) (default=90)
ex) 90 (90μΌ)
search_date_by
String
κΈ°νμ λν κ²μ(search_type == days_range or date_range) μμμ νν°λ§ κΈ°μ€ λ μ§ (default=created_at) [created_at, updated_at]
ex) created_at
start_date
String
search_type == date_range μμμ μμ λ μ§ (default=None)
ex) 20240301
end_date
String
search_type == date_range μμμ μ’ λ£ λ μ§ (default=None)
ex) 20240305
with_custom
Bool
μ΄λ―Έμ§ 컀μ€ν κ³΅κ° μ¬λΆ (default=None)
ex) True
with_memo
Bool
μ΄λ―Έμ§ λ©λͺ¨ κ³΅κ° μ¬λΆ (default=None)
ex) True
days_or_date_range
String
λ μ§νμ (default=None)
days_range: μ£Όμ΄μ§ κΈ°ν(days_range) μ΄μ (current_time - days_range)λΆν° νμ¬κΉμ§ date_range: start_date(ν΄λΉ λ μ§μ00:00:00) ~ end_date(ν΄λΉ λ μ§μ 23:59:59)
latitude
Float
μλ(default=None)
ex) 37.135551
longitude
Float
κ²½λ(default=None)
ex) 127.1052133
use_radius
Bool
λ°κ²½ μ μ© μ¬λΆ(default=False) ex)False
radius
Int
λ°κ²½(default=100) (λ―Έν° λ¨μ) ex) 5000
Headers
Authorization*
String
User ${Token}
νΉμ μ μ μ νμ΄μ§ μ²λ¦¬λ μ΄λ―Έμ§ κ·Έλ£Ήμ μ‘°νν©λλ€.
GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/group/paged
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Query Parameters
page
int
νμ΄μ§ λ²νΈ (default=1)
ex) 1
page_size
int
ν νμ΄μ§ λΉ ν¬κΈ° (default=60)
ex)60
sort_by
String
μ λ ¬ κΈ°μ€(default=created_at) [created_at, updated_at, name]
ex)created_at
sort_order
String
μ λ ¬ λ°©μ(default=asc)[asc, desc]
ex)desc
search
String
κ²μμ΄ (default=None)
search_type
String
κ²μνμ (default=None)[folder_name, address_all, address_sort, days_range, date_range]
folder_name : ν΄λΉ ν΄λμ νμ μ΄λ―Έμ§
address_all : λͺ¨λ μ£Όμ
address_sort: 컀μ€ν μ£Όμ(ex) λ§κ³‘λ λ§κ³‘μ 밸리14λ¨μ§ 302νΈ)
days_range
Int
search_type == days_range μμμ κΈ°ν(μΌμ) (default=90)
ex) 90 (90μΌ)
search_date_by
String
κΈ°νμ λν κ²μ(search_type == days_range or date_range) μμμ νν°λ§ κΈ°μ€ λ μ§ (default=created_at) [created_at, updated_at]
ex) created_at
start_date
String
search_type == date_range μμμ μμ λ μ§ (default=None)
ex) 20240301
end_date
String
search_type == date_range μμμ μ’ λ£ λ μ§ (default=None)
ex) 20240305
with_custom
Bool
μ΄λ―Έμ§ 컀μ€ν κ³΅κ° μ¬λΆ (default=None)
ex) True
with_memo
Bool
μ΄λ―Έμ§ λ©λͺ¨ κ³΅κ° μ¬λΆ (default=None)
ex) True
days_or_date_range
String
λ μ§νμ (default=None)
days_range: μ£Όμ΄μ§ κΈ°ν(days_range) μ΄μ (current_time - days_range)λΆν° νμ¬κΉμ§ date_range: start_date(ν΄λΉ λ μ§μ00:00:00) ~ end_date(ν΄λΉ λ μ§μ 23:59:59)
latitude
Float
μλ(default=None)
ex) 37.135551
longitude
Float
κ²½λ(default=None)
ex) 127.1052133
use_radius
Bool
λ°κ²½ μ μ© μ¬λΆ(default=False) ex)False
radius
Int
λ°κ²½(default=100) (λ―Έν° λ¨μ) ex) 5000
Headers
Authorization*
String
User ${Token}
νΉμ μ μ μ μ΄λ―Έμ§ κ°μλ₯Ό μ‘°νν©λλ€.
GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/count
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
Headers
Authorization*
String
User ${Token}
νΉμ μ μ μ νΉμ μ΄λ―Έμ§λ₯Ό μ‘°νν©λλ€.
GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
image_id*
String
μ΄λ―Έμ§μ id
ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6
Query Parameters
with_history
Bool
μ΄λ―Έμ§μμ λ΄μ κ³΅κ° μ¬λΆ(default=False)
ex)True
with_memo
Bool
μ΄λ―Έμ§ λ©λͺ¨ κ³΅κ° μ¬λΆ (default=None)
ex) True
with_custom
Bool
μ΄λ―Έμ§ 컀μ€ν κ³΅κ° μ¬λΆ (default=None)
ex) True
Headers
Authorization*
String
User ${Token}
νΉμ μ μ μ νΉμ μ΄λ―Έμ§λ₯Ό μμ ν©λλ€.
PUT https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
image_id*
String
μ΄λ―Έμ§μ id
ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6
Query Parameters
delete
String
μ΄λ―Έμ§ μμ μ¬λΆ(Soft delete) (λμλ¬Έμ κ΅¬λΆ μμ΄ 'true' or 'false') (default = None)
ex) True
has_det
String
μμΈμ£Όμμ¬λΆ (λμλ¬Έμ κ΅¬λΆ μμ΄ 'true' or 'false') (default=None)
ex)True
Headers
Authorization*
String
User ${Token}
Request Body
folder_id
String
ν΄λμ id(default="UNSET")
ex)924CjmgLLk
address_det
String
μμΈ μ£Όμ(λ, νΈμ)(default=None)
ex) 101λ 1101
longitude
String
κ²½λ(default=None)
latitude
String
μλ(default=None)
νΉμ μ μ μ νΉμ μ΄λ―Έμ§λ₯Ό μμ ν©λλ€.
DELETE https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}
Path Parameters
user_id*
String
μ μ μ id
ex)8BfE96V8Xc
image_id*
String
μ΄λ―Έμ§μ id
ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6
Headers
Authorization*
String
User ${Token}
Last updated