search

Image

hashtag
νŠΉμ • μœ μ €μ˜ 이미지λ₯Ό μ—…λ‘œλ“œν•©λ‹ˆλ‹€.

POST https://service-stage.pic-origin.com/api/v1/users/{user_id}/images

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
Request Body

Name
Type
Description

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

hashtag
νŠΉμ • μœ μ €μ˜ 원본 이미지 ID 리슀트λ₯Ό μž…λ ₯ λ°›μ•„, ν•΄λ‹Ή μ΄λ―Έμ§€λ“€μ˜ μ΅œμ‹  정보λ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€. (이미지 곡유)

POST https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/share

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
Request Body

Name
Type
Description

image_ids*

List[str]

이미지 uuid 리슀트

ex) ["c84a180e-599c-4787-8972-aed430e157be", "d7aa7944-cb2b-498f-8327-8ae9e27f38c4"]

hashtag
νŠΉμ • μœ μ €μ˜ 이미지λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Query Parameters

Name
Type
Description

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)

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
νŠΉμ • μœ μ €μ˜ 이미지 그룹을 μ‘°νšŒν•©λ‹ˆλ‹€.

GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/group

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Query Parameters

Name
Type
Description

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

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
νŠΉμ • μœ μ €μ˜ νŽ˜μ΄μ§€ 처리된 이미지 그룹을 μ‘°νšŒν•©λ‹ˆλ‹€.

GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/group/paged

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Query Parameters

Name
Type
Description

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

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
νŠΉμ • μœ μ €μ˜ 이미지 개수λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/count

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
νŠΉμ • μœ μ €μ˜ νŠΉμ • 이미지λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€.

GET https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

image_id*

String

μ΄λ―Έμ§€μ˜ id

ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6

hashtag
Query Parameters

Name
Type
Description

with_history

Bool

μ΄λ―Έμ§€μˆ˜μ • λ‚΄μ—­ 곡개 μ—¬λΆ€(default=False)

ex)True

with_memo

Bool

이미지 λ©”λͺ¨ 곡개 μ—¬λΆ€ (default=None)

ex) True

with_custom

Bool

이미지 μ»€μŠ€ν…€ 곡개 μ—¬λΆ€ (default=None)

ex) True

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
νŠΉμ • μœ μ €μ˜ νŠΉμ • 이미지λ₯Ό μˆ˜μ •ν•©λ‹ˆλ‹€.

PUT https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

image_id*

String

μ΄λ―Έμ§€μ˜ id

ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6

hashtag
Query Parameters

Name
Type
Description

delete

String

이미지 μ‚­μ œ μ—¬λΆ€(Soft delete) (λŒ€μ†Œλ¬Έμž ꡬ뢄 없이 'true' or 'false') (default = None)

ex) True

has_det

String

μƒμ„Έμ£Όμ†Œμ—¬λΆ€ (λŒ€μ†Œλ¬Έμž ꡬ뢄 없이 'true' or 'false') (default=None)

ex)True

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

hashtag
Request Body

Name
Type
Description

folder_id

String

ν΄λ”μ˜ id(default="UNSET")

ex)924CjmgLLk

address_det

String

상세 μ£Όμ†Œ(동, 호수)(default=None)

ex) 101동 1101

longitude

String

경도(default=None)

latitude

String

μœ„λ„(default=None)

hashtag
νŠΉμ • μœ μ €μ˜ νŠΉμ • 이미지λ₯Ό μ‚­μ œν•©λ‹ˆλ‹€.

DELETE https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/{image_id}

hashtag
Path Parameters

Name
Type
Description

user_id*

String

μœ μ €μ˜ id

ex)8BfE96V8Xc

image_id*

String

μ΄λ―Έμ§€μ˜ id

ex)90a350b4-9b00-4f87-9dd7-451eaf35f2e6

hashtag
Headers

Name
Type
Description

Authorization*

String

User ${Token}

PreviousUserNextFiledata

Last updated