Folder

특정 유저의 폴더를 생성합니다.

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

Path Parameters

Name

Type

Description

user_id*

String

유저의 id

ex)8BfE96V8Xc

Headers

Name

Type

Description

Authorization*

String

User ${Token}

Request Body

Name

Type

Description

title*

String

폴더의 제목(default=None)

ex)강남구

parent_id

String

해당 폴더의 상위 폴더의 id(default=None)

ex)JC4Ub4EZo7

{
    "status_code": 200,
    "message": "성공",
    "result": {
        "id": "4tb42KfHHB",
        "user_id": "EabHTVpYYm",
        "title": "test_biz",
        "parent_id": null,
        "created_at": "20240110_150924",
        "updated_at": "20240110_150924",
        "delete_at": null
    }
}

curl --location --request POST 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/folders' \
--header 'Authorization: User {YOUR_TOKEN}' \
--form 'title="{YOUR_TITLE}"' \
--form 'parent_id="{YOUR_PARENT_ID}"'

특정 유저의 모든 폴더를 조회합니다.

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

Path Parameters

Name

Type

Description

user_id*

String

유저의 id

ex)8BfE96V8Xc

Query Parameters

Name

Type

Description

has_delete_at

Bool

휴지통 여부(default=None)

ex)True

Headers

Name

Type

Description

Authorization*

String

User ${Token}

{
    "status_code": 200,
    "message": "성공",
    "result": [
        {
            "id": "KumR7WKAUA",
            "user_id": "EabHTVpYYm",
            "title": "logun1",
            "parent_id": null,
            "created_at": "20240103_133924",
            "updated_at": "20240103_133924",
            "delete_at": null,
            "child_folders": []
        },
        {
            "id": "HxiGzpvV6m",
            "user_id": "EabHTVpYYm",
            "title": "test_biz1",
            "parent_id": null,
            "created_at": "20240117_230920",
            "updated_at": "20240214_145446",
            "delete_at": null,
            "child_folders": [
                {
                    "id": "JC4Ub4EZo7",
                    "user_id": "EabHTVpYYm",
                    "title": "logun2",
                    "parent_id": "HxiGzpvV6m",
                    "created_at": "20231019_132322",
                    "updated_at": "20231019_132322",
                    "delete_at": null,
                    "child_folders": [
                        {
                            "id": "HiBLQb9TyC",
                            "user_id": "EabHTVpYYm",
                            "title": "맹보관",
                            "parent_id": "JC4Ub4EZo7",
                            "created_at": "20231024_150645",
                            "updated_at": "20240221_144449",
                            "delete_at": null,
                            "child_folders": []
                        }
                    ]
                },
                {
                    "id": "4tb42KfHHB",
                    "user_id": "EabHTVpYYm",
                    "title": "test_biz",
                    "parent_id": "HxiGzpvV6m",
                    "created_at": "20240110_150924",
                    "updated_at": "20240110_150924",
                    "delete_at": null,
                    "child_folders": []
                }
            ]
        },
        {
            "id": "Aqtfi55uqc",
            "user_id": "EabHTVpYYm",
            "title": "test_biz4",
            "parent_id": null,
            "created_at": "20231024_153016",
            "updated_at": "20240214_151243",
            "delete_at": null,
            "child_folders": []
        }
    ]
}

curl --location --request GET 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/folders' \
--header 'Authorization: User {YOUR_TOKEN}'

특정 유저의 특정 폴더를 조회합니다.

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

Path Parameters

Name

Type

Description

user_id*

String

유저의 id

ex)8BfE96V8Xc

folder_id*

String

해당 폴더의 id

ex)JC4Ub4EZo7

Query Parameters

Name

Type

Description

sort_by

String

정렬 기준(default=created_at)[created_at, updated_at,name]

ex)created_at

sort_order

String

정렬 방식(default=asc)[asc, desc]

ex)desc

get_image

Bool

이미지 포함 여부(default=True)

ex)True

last_index

Int

페이지 시작 인덱스 (default=None)

ex) 10

page_size

Int

한 페이지 당 크기(default=60)

ex)60

with_history

Bool

이미지수정 내역 공개 여부(default=False)

ex)True

has_delete_at

Bool

휴지통 여부(default=None)

ex)True

with_custom

Bool

이미지 커스텀 공개 여부 (default=None)

ex) True

with_memo

Bool

이미지 메모 공개 여부 (default=None)

ex) True

Headers

Name

Type

Description

Authorization*

String

User ${Token}

{
    "status_code": 200,
    "message": "성공",
    "result": {
        "count": 2,
        "total_count": 32,
        "last_index": 32,
        "page_size": 100,
        "total_filesize_mb": 0.12,
        "current_path": "/",
        "current_path_id": "/",
        "items": [
            {
                "is_folder": false,
                "data": {
                    "id": "de8c49f1-b153-49eb-8ecd-38b8957b4070",
                    "user_id": "EabHTVpYYm",
                    "folder_id": null,
                    "filename": "20231221_170923_5bcd01602b62b5256e1da8b248d631de_V00.JPEG",
                    "path_url": "https://pillo-app-dev.s3.amazonaws.com/EabHTVpYYm/images/edit/20231221_170923_5bcd01602b62b5256e1da8b248d631de_V00.JPEG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T044247Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=dc68cc5ac8af6c8ba404cecdf46b5155e1258b19c07f7f42d080daccfaa65a49",
                    "org_path_url": "https://pillo-app-dev.s3.amazonaws.com/EabHTVpYYm/images/edit/20231221_170923_5bcd01602b62b5256e1da8b248d631de_V00.JPEG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T044247Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=dc68cc5ac8af6c8ba404cecdf46b5155e1258b19c07f7f42d080daccfaa65a49",
                    "lat": 127.1052133,
                    "lng": 37.3595316,
                    "address_road": "경기 성남시 분당구 불정로 6",
                    "address_land": "경기 성남시 분당구 정자동 178 - 1",
                    "address_land_number": "0-0",
                    "building_name": "NAVER그린팩토리",
                    "address_sort": null,
                    "address_det": "d",
                    "created_at": "20231221_170923",
                    "updated_at": "20231221_170923",
                    "delete_at": null,
                    "filedata_total": 1,
                    "is_signed": true,
                    "is_shared": false,
                    "has_det": null,
                    "image_resource_type": "JPEG",
                    "resolution": null,
                    "image_filesize_mb": 0.04,
                    "memos": [],
                    "customs": [],
                    "filedatas": []
                }
            },
            {
                "is_folder": false,
                "data": {
                    "id": "9af1afa3-e710-4858-b18b-de81559a9571",
                    "user_id": "EabHTVpYYm",
                    "folder_id": null,
                    "filename": "20231221_173159_5bcd01602b62b5256e1da8b248d631de_V00.JPEG",
                    "path_url": "https://pillo-app-dev.s3.amazonaws.com/EabHTVpYYm/images/edit/20231221_173159_4b37f9c3b4066dc76e55de0a3750911a_V25.JPEG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T044247Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=79dccf6a2db0852c5627949efc9c0491aba29cd2fc325653805ca2c0fb657d7f",
                    "org_path_url": "https://pillo-app-dev.s3.amazonaws.com/EabHTVpYYm/images/edit/20231221_173159_5bcd01602b62b5256e1da8b248d631de_V00.JPEG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAZEHAPJW7UBG2TATL%2F20240327%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20240327T044247Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=a73bca54d86a255f059f77893d81bc768636ac295b08c07c2bcacb148a876a4d",
                    "lat": 37.3595316,
                    "lng": 127.1052133,
                    "address_road": "경기 성남시 분당구 불정로 6",
                    "address_land": "경기 성남시 분당구 정자동 178 - 1",
                    "address_land_number": "0-0",
                    "building_name": "NAVER그린팩토리",
                    "address_sort": null,
                    "address_det": "d",
                    "created_at": "20231221_173159",
                    "updated_at": "20240311_151113",
                    "delete_at": null,
                    "filedata_total": 26,
                    "is_signed": true,
                    "is_shared": false,
                    "has_det": null,
                    "image_resource_type": "JPEG",
                    "resolution": "576x1024",
                    "image_filesize_mb": 0.08,
                    "memos": [],
                    "customs": [],
                    "filedatas": []
                }
            }
        ]
    }
}

curl --location --request GET 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/folders/{folder_id}' \
--header 'Authorization: User {YOUR_TOKEN}'

특정 유저의 특정 폴더를 수정합니다.

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

Path Parameters

Name

Type

Description

user_id*

String

유저의 id

ex)8BfE96V8Xc

folder_id*

String

해당 폴더의 id

ex)JC4Ub4EZo7

Query Parameters

Name

Type

Description

delete

String

폴더 삭제 여부 (대소문자 구분 없이 'true' or 'false') (default=None)

ex)True

Headers

Name

Type

Description

Authorization*

String

User ${Token}

Request Body

Name

Type

Description

parent_id

String

상위 폴더의 id(default="UNSET")

ex)JC4Ub4EZo7

title

String

폴더의 제목(default=None)

ex)강남구

{
    "status_code": 200,
    "message": "성공",
    "result": {
        "id": "HiBLQb9TyC",
        "user_id": "EabHTVpYYm",
        "title": "강남구",
        "parent_id": null,
        "created_at": "20231024_150645",
        "updated_at": "20231024_150645",
        "delete_at": "20240209_151705"
    }
}

curl --location --request PUT 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/folders/{folder_id}' \
--header 'Authorization: User {YOUR_TOKEN}' \
--form 'parent_id={PARENT_ID}'

특정 유저의 특정 폴더를 삭제합니다.

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

Path Parameters

Name

Type

Description

user_id*

String

유저의 id

ex)8BfE96V8Xc

folder_id*

String

해당 폴더의 id

ex)JC4Ub4EZo7

Headers

Name

Type

Description

Authorization*

String

User ${Token}

{
  "status_code": 200,
  "message": "성공",
  "result": {
    "deleted_folders": [
      "FJiqmSDY5j",
      "GbBkh7cB6u"
    ],
    "deleted_images": []
  }
}

curl --location --request DELETE 'https://service-stage.pic-origin.com/api/v1/users/{user_id}/folders/{folder_id}'' \
--header 'Authorization: User {YOUR_TOKEN}'

PreviousFiledata NextMemo

Last updated 1 year ago

hashtag특정 유저의 폴더를 생성합니다.

hashtagPath Parameters

hashtagHeaders

hashtagRequest Body

hashtag특정 유저의 모든 폴더를 조회합니다.

hashtagPath Parameters

hashtagQuery Parameters

hashtagHeaders

hashtag특정 유저의 특정 폴더를 조회합니다.

hashtagPath Parameters

hashtagQuery Parameters

hashtagHeaders

hashtag특정 유저의 특정 폴더를 수정합니다.

hashtagPath Parameters

hashtagQuery Parameters

hashtagHeaders

hashtagRequest Body

hashtag특정 유저의 특정 폴더를 삭제합니다.

hashtagPath Parameters

hashtagHeaders

특정 유저의 폴더를 생성합니다.

Path Parameters

Headers

Request Body

특정 유저의 모든 폴더를 조회합니다.

Path Parameters

Query Parameters

Headers

특정 유저의 특정 폴더를 조회합니다.

Path Parameters

Query Parameters

Headers

특정 유저의 특정 폴더를 수정합니다.

Path Parameters

Query Parameters

Headers

Request Body

특정 유저의 특정 폴더를 삭제합니다.

Path Parameters

Headers