Image

ํŠน์ • ์œ ์ €์˜ ์ด๋ฏธ์ง€๋ฅผ ์—…๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค.

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

Path Parameters

Name
Type
Description

user_id*

String

์œ ์ €์˜ id

ex)8BfE96V8Xc

Headers

Name
Type
Description

Authorization*

String

User ${Token}

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"
            }
        ]
    }
}
curl --location --request POST 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/images' \
--header 'Authorization: User {YOUR_TOKEN}' \
--form 'folder_id="{YOUR_FOLDER_ID}"' \
--form 'latitude="{YOUR_LATITUDE}"' \
--form 'longitude="{YOUR_LONGITUDE}"' \
--form 'address_det="{YOUR_ADDRESS_DET}"' \
--form 'created_at="{YOUR_CREATED_AT}"' \
--form 'is_shared="{YOUR_IS_SHARED}"' \
--form 'has_det="{YOUR_HAS_DET}"' \
--form 'image_data=@"/{YOUR_PATH_TO_IMAGE}/{YOUR_IMAGE_FILE}"'

ํŠน์ • ์œ ์ €์˜ ์›๋ณธ ์ด๋ฏธ์ง€ ID ๋ฆฌ์ŠคํŠธ๋ฅผ ์ž…๋ ฅ ๋ฐ›์•„, ํ•ด๋‹น ์ด๋ฏธ์ง€๋“ค์˜ ์ตœ์‹  ์ •๋ณด๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. (์ด๋ฏธ์ง€ ๊ณต์œ )

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

Path Parameters

Name
Type
Description

user_id*

String

์œ ์ €์˜ id

ex)8BfE96V8Xc

Headers

Name
Type
Description

Authorization*

String

User ${Token}

Request Body

Name
Type
Description

image_ids*

List[str]

์ด๋ฏธ์ง€ uuid ๋ฆฌ์ŠคํŠธ

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

{
    "status_code": 200,
    "message": "์„ฑ๊ณต",
    "result": [
        {
            "original_image_id": "8bcf4981-9b26-45e8-954c-447dfa6b4068",
            "id": "596e7bee-06f2-49dd-956b-c62e3d9bff4d",
            "path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20231227_165822_5bcd01602b62b5256e1da8b248d631de_V00.JPEG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240311%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240311T051544Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=cdafc865e3d149d9b4587a09020173020a0a127e138c60e5f4cad2649fbb6c4d",
            "created_at": "20231227_165822",
            "hashdata": "5bcd01602b62b5256e1da8b248d631de",
            "filesize_mb": 0.04,
            "image_resource_type": "JPEG",
            "resolution": null
        }
    ]
}
curl --location ''https://service-stage.pic-origin.com/api/v1/users/{user_id}/images/share' \
--header 'Authorization: user {YOUR_TOKEN}' \
--data '{
    "image_ids": [
        "{YOUR_IMAGE_UUID}",
        ...
    ]
}'

ํŠน์ • ์œ ์ €์˜ ์ด๋ฏธ์ง€๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

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

Path Parameters

Name
Type
Description

user_id*

String

์œ ์ €์˜ id

ex)8BfE96V8Xc

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)

Headers

Name
Type
Description

Authorization*

String

User ${Token}

{
    "status_code": 200,
    "message": "์„ฑ๊ณต",
    "result": {
        "count": 3,
        "total_count": 68,
        "last_index": 68,
        "page_size": 60,
        "total_filesize_mb": 2.75,
        "items": [
            {
                "id": "21951986-67c9-41c5-a982-1199ecf3a79e",
                "user_id": "B227FBWvKJ",
                "folder_id": null,
                "filename": "20240327_103737_276_20240327_103737_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG",
                "path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_103737_276_20240327_103737_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=969e2184d50621ab6eb479fccdf13f2b5f62ea56ebdb412f1774949d84b4b188",
                "org_path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_103737_276_20240327_103737_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=969e2184d50621ab6eb479fccdf13f2b5f62ea56ebdb412f1774949d84b4b188",
                "lat": 37.3595316,
                "lng": 127.1052133,
                "address_road": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ๋ถˆ์ •๋กœ 6",
                "address_land": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ์ •์ž๋™",
                "address_land_number": "178-1",
                "building_name": "NAVER๊ทธ๋ฆฐํŒฉํ† ๋ฆฌ",
                "address_sort": "๋ถ„๋‹น๊ตฌ NAVER๊ทธ๋ฆฐํŒฉํ† ๋ฆฌ",
                "address_det": "test",
                "created_at": "20240327_103737",
                "updated_at": "20240327_103737",
                "delete_at": null,
                "filedata_total": 1,
                "is_signed": false,
                "is_shared": false,
                "has_det": null,
                "image_resource_type": "PNG",
                "resolution": "1023x540",
                "image_filesize_mb": 0.92,
                "memos": null,
                "customs": null,
                "filedatas": []
            },
            {
                "id": "115af6cc-2ac0-48be-83d8-719c2eb7ed88",
                "user_id": "B227FBWvKJ",
                "folder_id": null,
                "filename": "20240327_130513_521_20240327_130513_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG",
                "path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_130513_521_20240327_130513_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=622a1c1f96d0d0a9d3a62bdc98559a0ca1594997672de6ec09f6ae3be3f7032d",
                "org_path_url": "https://pillo-app-dev.s3.amazonaws.com/B227FBWvKJ/images/edit/20240327_130513_521_20240327_130513_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=622a1c1f96d0d0a9d3a62bdc98559a0ca1594997672de6ec09f6ae3be3f7032d",
                "lat": 37.3595316,
                "lng": 127.1052133,
                "address_road": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ๋ถˆ์ •๋กœ 6",
                "address_land": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ์ •์ž๋™",
                "address_land_number": "178-1",
                "building_name": "NAVER๊ทธ๋ฆฐํŒฉํ† ๋ฆฌ",
                "address_sort": "๋ถ„๋‹น๊ตฌ NAVER๊ทธ๋ฆฐํŒฉํ† ๋ฆฌ",
                "address_det": "test",
                "created_at": "20240327_130513",
                "updated_at": "20240327_130513",
                "delete_at": null,
                "filedata_total": 1,
                "is_signed": false,
                "is_shared": true,
                "has_det": null,
                "image_resource_type": "PNG",
                "resolution": "1023x540",
                "image_filesize_mb": 0.92,
                "memos": null,
                "customs": null,
                "filedatas": []
            },
            {
                "id": "05be0bc8-ea54-4260-9d56-a46eca2635c3",
                "user_id": "B227FBWvKJ",
                "folder_id": null,
                "filename": "20240327_130910_675_20240327_130910_be901b8cf6d81a7c833dd82edc242fbd_V00.PNG",
                "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=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=92aa17710e4e1568cf1ea21faf74ae6cd3f3fb46ee967981a7cebd7a8e00efb8",
                "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=20240327T043912Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=92aa17710e4e1568cf1ea21faf74ae6cd3f3fb46ee967981a7cebd7a8e00efb8",
                "lat": 37.3595316,
                "lng": 127.1052133,
                "address_road": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ๋ถˆ์ •๋กœ 6",
                "address_land": "๊ฒฝ๊ธฐ ์„ฑ๋‚จ์‹œ ๋ถ„๋‹น๊ตฌ ์ •์ž๋™",
                "address_land_number": "178-1",
                "building_name": "NAVER๊ทธ๋ฆฐํŒฉํ† ๋ฆฌ",
                "address_sort": "๋ถ„๋‹น๊ตฌ 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,
                "image_resource_type": "PNG",
                "resolution": "1023x540",
                "image_filesize_mb": 0.92,
                "memos": null,
                "customs": null,
                "filedatas": []
            }
        ]
    }
}