AT AppointmentTrader
로그인
현재 온라인  

/v1/media/

The signed-in account's private lifetime media library and reusable picker.
GET

/v1/media/get_ftp_credentials

#
Read the acting account's generated FTP login. Passwords are recoverable only by the app. Send POST with X-AT-Media-Request: 1. Never put credentials in URLs or client storage.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_ftp_credentials' \
  --data-urlencode 'key={{API_KEY}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_ftp_credentials_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.credentials 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].credentialIDinteger 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].emojistring 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].archivedboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].usernamestring 예Owner FTP username; examples are deliberately fictitious.
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password 예Owner FTP password, or null when reset is required. Never use response data as documentation examples.
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].enabledboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].notifyOnImportboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].requiresResetboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_ftp_credentials",
    "RequestUserAlias": "example-user",
    "Payload": {
        "credentials": {
            "credentialID": 1,
            "label": null,
            "username": "SYNTHETIC_USERNAME",
            "password": "SYNTHETIC_PASSWORD",
            "enabled": false,
            "notifyOnImport": false,
            "requiresReset": false
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/media/get_ftp_logs

#
Read upload logs through the acting account's FTPS connection. Latest 30 UTC dates, up to 64 KiB of the selected log's tail. Send POST with X-AT-Media-Request: 1. No credentials or owner IDs are accepted.

매개변수

이름유형필수기본값설명
logDate string 아니요 "" UTC log date, or empty for the latest available log.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_ftp_logs' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'logDate={{logDate}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_ftp_logs_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.datesarray 예
$.oneOf[0].allOf[1].Payload.dates[]string 아니요
$.oneOf[0].allOf[1].Payload.date 예
$.oneOf[0].allOf[1].Payload.date.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.date.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.textstring 예
$.oneOf[0].allOf[1].Payload.truncatedboolean 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_ftp_logs",
    "RequestUserAlias": "example-user",
    "Payload": {
        "dates": [
            "2030-01-01"
        ],
        "date": "2030-01-01",
        "text": "Synthetic upload log.",
        "truncated": false
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/media/get_labels

#
Private label catalog, including archived labels. Never accepts another account ID.

매개변수

이름유형필수기본값설명
afterID int 아니요 0 Previous nextID, or zero for the first page.
search string 아니요 "" Optional name search; restart afterID when changing search.
labelID int 아니요 0 Resolve one owned label for an existing selection; zero browses the catalog.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_labels' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'afterID={{afterID}}' \
  --data-urlencode 'search={{search}}' \
  --data-urlencode 'labelID={{labelID}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_labels_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.labelsarray 예
$.oneOf[0].allOf[1].Payload.labels[]object 아니요
$.oneOf[0].allOf[1].Payload.labels[].idinteger 예
$.oneOf[0].allOf[1].Payload.labels[].namestring 예
$.oneOf[0].allOf[1].Payload.labels[].emojistring 예
$.oneOf[0].allOf[1].Payload.labels[].archivedboolean 예
$.oneOf[0].allOf[1].Payload.nextID 예
$.oneOf[0].allOf[1].Payload.nextID.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.nextID.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_labels",
    "RequestUserAlias": "example-user",
    "Payload": {
        "labels": [],
        "nextID": 0
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/media/get_my_media

#
Browse retained media owned by the acting account. Never accepts another account ID.

매개변수

이름유형필수기본값설명
search string 아니요 "" Filename, title or description search.
kind string 아니요 "" Empty, image, video, audio or document.
usage string 아니요 "" Empty, unattached, post, profile, message, request or preview.
month string 아니요 "" Creation month YYYY-MM, or empty for all dates.
order string 아니요 "newest" newest or oldest.
cursor string 아니요 "" Opaque continuation returned by the previous page.
pageSize int 아니요 60 Items per page, capped at 100.
labelID int 아니요 0 Owned label ID, including archives; zero means all.
unlabeled bool 아니요 false Only media without labels; mutually exclusive with labelID.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_my_media' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'search={{search}}' \
  --data-urlencode 'kind={{kind}}' \
  --data-urlencode 'usage={{usage}}' \
  --data-urlencode 'month={{month}}' \
  --data-urlencode 'order={{order}}' \
  --data-urlencode 'cursor={{cursor}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'unlabeled={{unlabeled}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_my_media_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.itemsarray 예
$.oneOf[0].allOf[1].Payload.items[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].idinteger 예
$.oneOf[0].allOf[1].Payload.items[].thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].mediaTypestring 예
$.oneOf[0].allOf[1].Payload.items[].widthinteger 예
$.oneOf[0].allOf[1].Payload.items[].heightinteger 예
$.oneOf[0].allOf[1].Payload.items[].titlestring 예
$.oneOf[0].allOf[1].Payload.items[].isImageboolean 예
$.oneOf[0].allOf[1].Payload.items[].isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.items[].kindstring ["image","video","audio","document"] 예
$.oneOf[0].allOf[1].Payload.items[].createdDatestring 예
$.oneOf[0].allOf[1].Payload.items[].filenamestring 예
$.oneOf[0].allOf[1].Payload.items[].sizeinteger 예
$.oneOf[0].allOf[1].Payload.items[].duration 예
$.oneOf[0].allOf[1].Payload.items[].duration.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.items[].duration.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.items[].downloadUrlstring 예
$.oneOf[0].allOf[1].Payload.items[].labelsarray 예
$.oneOf[0].allOf[1].Payload.items[].labels[]object 아니요
$.oneOf[0].allOf[1].Payload.items[].labels[].idinteger 예
$.oneOf[0].allOf[1].Payload.items[].labels[].namestring 예
$.oneOf[0].allOf[1].Payload.items[].labels[].emojistring 예
$.oneOf[0].allOf[1].Payload.items[].labels[].archivedboolean 예
$.oneOf[0].allOf[1].Payload.items[].hasUsageboolean 예
$.oneOf[0].allOf[1].Payload.nextCursor 예
$.oneOf[0].allOf[1].Payload.nextCursor.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.nextCursor.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.lastMediaIDinteger 예
$.oneOf[0].allOf[1].Payload.pageSignature 예
$.oneOf[0].allOf[1].Payload.pageSignature.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.pageSignature.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_my_media",
    "RequestUserAlias": "example-user",
    "Payload": {
        "items": [],
        "nextCursor": "synthetic-example",
        "lastMediaID": 0,
        "pageSignature": "synthetic-example"
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/media/get_my_media_item

#
Preview one owned file with current permission-checked usage references. Chat usages include chatID only after current chat and message access checks; their URL opens the conversation. File ownership alone never grants access.

매개변수

이름유형필수기본값설명
mediaID int 예 — Owned ATMedia ID.
afterUsageID int 아니요 0 Continuation returned as nextUsageID.
afterLabelPostID int 아니요 0 Dynamic usage continuation, -1 when exhausted.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_my_media_item' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'mediaID={{mediaID}}' \
  --data-urlencode 'afterUsageID={{afterUsageID}}' \
  --data-urlencode 'afterLabelPostID={{afterLabelPostID}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_my_media_item_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.itemobject 예
$.oneOf[0].allOf[1].Payload.item.idinteger 예
$.oneOf[0].allOf[1].Payload.item.thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaTypestring 예
$.oneOf[0].allOf[1].Payload.item.widthinteger 예
$.oneOf[0].allOf[1].Payload.item.heightinteger 예
$.oneOf[0].allOf[1].Payload.item.titlestring 예
$.oneOf[0].allOf[1].Payload.item.isImageboolean 예
$.oneOf[0].allOf[1].Payload.item.isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.item.kindstring ["image","video","audio","document"] 예
$.oneOf[0].allOf[1].Payload.item.createdDatestring 예
$.oneOf[0].allOf[1].Payload.item.filenamestring 예
$.oneOf[0].allOf[1].Payload.item.sizeinteger 예
$.oneOf[0].allOf[1].Payload.item.duration 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.item.downloadUrlstring 예
$.oneOf[0].allOf[1].Payload.item.labelsarray 예
$.oneOf[0].allOf[1].Payload.item.labels[]object 아니요
$.oneOf[0].allOf[1].Payload.item.labels[].idinteger 예
$.oneOf[0].allOf[1].Payload.item.labels[].namestring 예
$.oneOf[0].allOf[1].Payload.item.labels[].emojistring 예
$.oneOf[0].allOf[1].Payload.item.labels[].archivedboolean 예
$.oneOf[0].allOf[1].Payload.usagesarray 예
$.oneOf[0].allOf[1].Payload.usages[]object 아니요
$.oneOf[0].allOf[1].Payload.usages[].typestring 예
$.oneOf[0].allOf[1].Payload.usages[].rolestring 예
$.oneOf[0].allOf[1].Payload.usages[].titlestring 예
$.oneOf[0].allOf[1].Payload.usages[].urlstring 예
$.oneOf[0].allOf[1].Payload.usages[].chatIDinteger 아니요
$.oneOf[0].allOf[1].Payload.usages[].notificationBodyIDinteger 아니요
$.oneOf[0].allOf[1].Payload.usages[].versionIdinteger 아니요
$.oneOf[0].allOf[1].Payload.usages[].postIdinteger 아니요
$.oneOf[0].allOf[1].Payload.hasUnavailableUsageboolean 예
$.oneOf[0].allOf[1].Payload.nextUsageID 예
$.oneOf[0].allOf[1].Payload.nextUsageID.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.nextUsageID.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.nextLabelPostID 예
$.oneOf[0].allOf[1].Payload.nextLabelPostID.anyOf[0]integer 예
$.oneOf[0].allOf[1].Payload.nextLabelPostID.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_my_media_item",
    "RequestUserAlias": "example-user",
    "Payload": {
        "item": {
            "id": 0,
            "thumbUrl": "synthetic-example",
            "mediaUrl": "synthetic-example",
            "mediaType": "synthetic-example",
            "width": 0,
            "height": 0,
            "title": "synthetic-example",
            "isImage": false,
            "isEmbedded": false,
            "kind": "image",
            "createdDate": "synthetic-example",
            "filename": "synthetic-example",
            "size": 0,
            "duration": 0,
            "downloadUrl": "synthetic-example",
            "labels": []
        },
        "usages": [],
        "hasUnavailableUsage": false,
        "nextUsageID": 0,
        "nextLabelPostID": 0
    }
}
기계가 읽을 수 있는 엔드포인트 문서
GET

/v1/media/get_my_media_timeline

#
Return creation months for the account's current media filters.

매개변수

이름유형필수기본값설명
search string 아니요 "" Filename, title or description search.
kind string 아니요 "" Empty, image, video, audio or document.
usage string 아니요 "" Empty, unattached, post, profile, message, request or preview.
labelID int 아니요 0 Owned label ID, including archives; zero means all.
unlabeled bool 아니요 false Only media without labels; mutually exclusive with labelID.
요청 예제(cURL) 
curl --get \
  'https://kr.appointmenttrader.com/v1/media/get_my_media_timeline' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'search={{search}}' \
  --data-urlencode 'kind={{kind}}' \
  --data-urlencode 'usage={{usage}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'unlabeled={{unlabeled}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_get_my_media_timeline_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.monthsarray 예
$.oneOf[0].allOf[1].Payload.months[]object 아니요
$.oneOf[0].allOf[1].Payload.months[].month 예
$.oneOf[0].allOf[1].Payload.months[].month.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.months[].month.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.months[].countDatabaseInteger 예Integer value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.months[].count.oneOf[0]integer 예
$.oneOf[0].allOf[1].Payload.months[].count.oneOf[1]string 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_my_media_timeline",
    "RequestUserAlias": "example-user",
    "Payload": {
        "months": []
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_copy_post_photo

#
Copy an accessible post photo into the acting user's media library with a new ID and the same file URLs. Also resolves the acting user's wall for the About Me composer; creates that wall if needed. Does not publish a post or change the profile. POST with X-AT-Media-Request: 1 required.

매개변수

이름유형필수기본값설명
postID int 예 — Accessible source post containing the image.
mediaID int 예 — Retained image attached to that post.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_copy_post_photo' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'postID={{postID}}' \
  --data-urlencode 'mediaID={{mediaID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_copy_post_photo_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.itemobject 예
$.oneOf[0].allOf[1].Payload.item.idinteger 예
$.oneOf[0].allOf[1].Payload.item.thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaTypestring 예
$.oneOf[0].allOf[1].Payload.item.widthinteger 예
$.oneOf[0].allOf[1].Payload.item.heightinteger 예
$.oneOf[0].allOf[1].Payload.item.titlestring 예
$.oneOf[0].allOf[1].Payload.item.isImageboolean 예
$.oneOf[0].allOf[1].Payload.item.isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.item.kindstring ["image","video","audio","document"] 예
$.oneOf[0].allOf[1].Payload.item.createdDatestring 예
$.oneOf[0].allOf[1].Payload.item.filenamestring 예
$.oneOf[0].allOf[1].Payload.item.sizeinteger 예
$.oneOf[0].allOf[1].Payload.item.duration 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.item.downloadUrlstring 예
$.oneOf[0].allOf[1].Payload.wallBoardobject 예
$.oneOf[0].allOf[1].Payload.wallBoard.idinteger 예
$.oneOf[0].allOf[1].Payload.wallBoard.boardIDinteger 예
$.oneOf[0].allOf[1].Payload.wallBoard.slugstring 예
$.oneOf[0].allOf[1].Payload.wallBoard.namestring 예
$.oneOf[0].allOf[1].Payload.wallBoard.citystring 예
$.oneOf[0].allOf[1].Payload.wallBoard.cityGroupCodestring 예
$.oneOf[0].allOf[1].Payload.wallBoard.intentstring 예
$.oneOf[0].allOf[1].Payload.wallBoard.callbackstring 예
$.oneOf[0].allOf[1].Payload.wallBoard.countinteger 예
$.oneOf[0].allOf[1].Payload.wallBoard.unitLabelstring 예
$.oneOf[0].allOf[1].Payload.wallBoard.createsRegularBoardPostboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.isDefaultRequestBoardboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.isDefaultListingBoardboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.routingEnabledboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.routingDescriptionstring 예
$.oneOf[0].allOf[1].Payload.wallBoard.selectedboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.viewerCanReadboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.viewerCanWriteboolean 예
$.oneOf[0].allOf[1].Payload.wallBoard.hasAccessMetadata = true 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_copy_post_photo",
    "RequestUserAlias": "example-user",
    "Payload": {
        "item": {
            "id": 0,
            "thumbUrl": "synthetic-example",
            "mediaUrl": "synthetic-example",
            "mediaType": "synthetic-example",
            "width": 0,
            "height": 0,
            "title": "synthetic-example",
            "isImage": false,
            "isEmbedded": false,
            "kind": "image",
            "createdDate": "synthetic-example",
            "filename": "synthetic-example",
            "size": 0,
            "duration": 0,
            "downloadUrl": "synthetic-example"
        },
        "wallBoard": {
            "id": 0,
            "boardID": 0,
            "slug": "synthetic-example",
            "name": "synthetic-example",
            "city": "synthetic-example",
            "cityGroupCode": "synthetic-example",
            "intent": "synthetic-example",
            "callback": "synthetic-example",
            "count": 0,
            "unitLabel": "synthetic-example",
            "createsRegularBoardPost": false,
            "isDefaultRequestBoard": false,
            "isDefaultListingBoard": false,
            "routingEnabled": false,
            "routingDescription": "synthetic-example",
            "selected": false,
            "viewerCanRead": false,
            "viewerCanWrite": false,
            "hasAccessMetadata": true
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_delete_file

#
Soft-delete a file owned by the acting account by setting ATMedia.DeletedDate. The stored file and reference rows are retained. Deleted media is excluded from My Media, attachment selection and owner downloads. Repeating deletion is safe. POST with X-AT-Media-Request: 1 required; no other account ID is accepted.

매개변수

이름유형필수기본값설명
mediaID int 예 — Owned ATMedia ID.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_delete_file' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'mediaID={{mediaID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_delete_file_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.mediaIDinteger 예
$.oneOf[0].allOf[1].Payload.deleted = true 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_delete_file",
    "RequestUserAlias": "example-user",
    "Payload": {
        "mediaID": 0,
        "deleted": true
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_ftp_credentials

#
Create a random FTP login with six uppercase A-Z letters in each field, or reset it. Reset preserves an existing six-letter uppercase username; legacy names are shortened. The home-directory slug, virtual identity, default label, notification preference and enabled state survive reset. New accounts stay disabled until the FTP server provisions their home directory. Send POST with X-AT-Media-Request: 1. No user ID, username or password is accepted.

매개변수

이름유형필수기본값설명
reset bool 아니요 false Replace the password and shorten a legacy username if needed.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_ftp_credentials' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'reset={{reset}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_ftp_credentials_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.credentials 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].credentialIDinteger 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].emojistring 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].archivedboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].usernamestring 예Owner FTP username; examples are deliberately fictitious.
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password 예Owner FTP password, or null when reset is required. Never use response data as documentation examples.
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[0]string 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].enabledboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].notifyOnImportboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].requiresResetboolean 예
$.oneOf[0].allOf[1].Payload.credentials.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_ftp_credentials",
    "RequestUserAlias": "example-user",
    "Payload": {
        "credentials": {
            "credentialID": 1,
            "label": null,
            "username": "SYNTHETIC_USERNAME",
            "password": "SYNTHETIC_PASSWORD",
            "enabled": false,
            "notifyOnImport": false,
            "requiresReset": false
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_ftp_label

#
Set a credential's default label independently of its password. Records upload-time history atomically. POST with X-AT-Media-Request: 1 required. Resetting credentials preserves this setting and upload directory.

매개변수

이름유형필수기본값설명
credentialID int 예 — Owned FTP credential ID.
labelID int 아니요 0 Owned active label ID; zero clears.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_ftp_label' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'credentialID={{credentialID}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_ftp_label_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.credentialIDinteger 예
$.oneOf[0].allOf[1].Payload.label 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].emojistring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].archivedboolean 예
$.oneOf[0].allOf[1].Payload.label.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_ftp_label",
    "RequestUserAlias": "example-user",
    "Payload": {
        "credentialID": 0,
        "label": {
            "id": 0,
            "name": "synthetic-example",
            "emoji": "synthetic-example",
            "archived": false
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_ftp_notifications

#
Enable/disable priority alerts for successful FTP imports. Defaults to on for new and existing credentials. Changes apply to future imports, including uploads awaiting delivery. Existing alerts and replayed imports are unchanged. POST with X-AT-Media-Request: 1 required. Does not reset the login or change the default label/directory.

매개변수

이름유형필수기본값설명
credentialID int 예 — Owned FTP credential ID.
notifyOnImport bool 예 — Whether successful imports create a priority notification.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_ftp_notifications' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'credentialID={{credentialID}}' \
  --data-urlencode 'notifyOnImport={{notifyOnImport}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_ftp_notifications_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.credentialIDinteger 예
$.oneOf[0].allOf[1].Payload.notifyOnImportboolean 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_ftp_notifications",
    "RequestUserAlias": "example-user",
    "Payload": {
        "credentialID": 0,
        "notifyOnImport": false
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_import_from_url

#
Download one public HTTP(S) media URL into the acting account's My Media library. Accepts JPEG, PNG, GIF, WebP, AVIF, MP4, MOV, WebM and PDF, up to 25 MiB. Send POST with X-AT-Media-Request: 1. Authenticated session or owner API key required. Retry with the same importID and identical parameters to receive the original media. Future FTP delivery adapters can call this endpoint with an owner-authorized API identity and a public HTTPS delivery URL. FTP slugs/passwords alone never authorize imports.

매개변수

이름유형필수기본값설명
sourceURL string 예 — Absolute public media URL. Private-network addresses and credentials are rejected.
importID string 예 — Caller-generated stable delivery ID, 8-128 letters, numbers, underscores or hyphens.
title string 아니요 "" Optional media title, up to 250 characters.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_import_from_url' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'sourceURL={{sourceURL}}' \
  --data-urlencode 'importID={{importID}}' \
  --data-urlencode 'title={{title}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_import_from_url_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.itemobject 예
$.oneOf[0].allOf[1].Payload.item.idinteger 예
$.oneOf[0].allOf[1].Payload.item.thumbUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaUrlstring 예
$.oneOf[0].allOf[1].Payload.item.mediaTypestring 예
$.oneOf[0].allOf[1].Payload.item.widthinteger 예
$.oneOf[0].allOf[1].Payload.item.heightinteger 예
$.oneOf[0].allOf[1].Payload.item.titlestring 예
$.oneOf[0].allOf[1].Payload.item.isImageboolean 예
$.oneOf[0].allOf[1].Payload.item.isEmbeddedboolean 예
$.oneOf[0].allOf[1].Payload.item.kindstring ["image","video","audio","document"] 예
$.oneOf[0].allOf[1].Payload.item.createdDatestring 예
$.oneOf[0].allOf[1].Payload.item.filenamestring 예
$.oneOf[0].allOf[1].Payload.item.sizeinteger 예
$.oneOf[0].allOf[1].Payload.item.duration 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]number 예
$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]null 예
$.oneOf[0].allOf[1].Payload.item.downloadUrlstring 예
$.oneOf[0].allOf[1].Payload.reusedboolean 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_import_from_url",
    "RequestUserAlias": "example-user",
    "Payload": {
        "item": {
            "id": 0,
            "thumbUrl": "synthetic-example",
            "mediaUrl": "synthetic-example",
            "mediaType": "synthetic-example",
            "width": 0,
            "height": 0,
            "title": "synthetic-example",
            "isImage": false,
            "isEmbedded": false,
            "kind": "image",
            "createdDate": "synthetic-example",
            "filename": "synthetic-example",
            "size": 0,
            "duration": 0,
            "downloadUrl": "synthetic-example"
        },
        "reused": false
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_label

#
Create or rename an owned label; archived names remain reserved. POST with X-AT-Media-Request: 1.

매개변수

이름유형필수기본값설명
name string 예 — Trimmed label name, 1–100 characters, case-insensitively unique per account.
labelID int 아니요 0 Zero creates a label; otherwise renames without changing its ID.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
emoji string 아니요 null One emoji; omitted preserves the existing value.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_label' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'name={{name}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}' \
  --data-urlencode 'emoji={{emoji}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_label_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.label 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].emojistring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].archivedboolean 예
$.oneOf[0].allOf[1].Payload.label.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_label",
    "RequestUserAlias": "example-user",
    "Payload": {
        "label": {
            "id": 0,
            "name": "synthetic-example",
            "emoji": "synthetic-example",
            "archived": false
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_label_archived

#
Archive or restore a label. Archiving atomically clears FTP defaults and records history; existing links remain. POST with X-AT-Media-Request: 1 required.

매개변수

이름유형필수기본값설명
labelID int 예 — Owned label ID.
archived bool 예 — True archives; false restores.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
confirmDetach bool 아니요 false Acknowledge permanent removal from linked posts.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_label_archived' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'archived={{archived}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}' \
  --data-urlencode 'confirmDetach={{confirmDetach}}'

반환값

JSON
See the shared response schema and synthetic example.
응답 필드
필드유형필수설명
$media_set_label_archived_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.label 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0]object 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].idinteger 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].namestring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].emojistring 예
$.oneOf[0].allOf[1].Payload.label.anyOf[0].archivedboolean 예
$.oneOf[0].allOf[1].Payload.label.anyOf[1]null 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_label_archived",
    "RequestUserAlias": "example-user",
    "Payload": {
        "label": {
            "id": 0,
            "name": "synthetic-example",
            "emoji": "synthetic-example",
            "archived": false
        }
    }
}
기계가 읽을 수 있는 엔드포인트 문서
POST

/v1/media/set_media_labels

#
Atomically add/remove labels on up to 100 owned, retained media. Unrelated links are preserved. Archived labels may be removed but never manually added. POST with X-AT-Media-Request: 1 required.

매개변수

이름유형필수기본값설명
mediaIDs string 예 — JSON array of 1–100 media IDs.
labelIDs string 예 — JSON array of 1–100 owned label IDs.
remove bool 아니요 false True removes; false adds. Repeating an operation is harmless.
isWritingRequest bool 아니요 false Explicit write acknowledgement.
요청 예제(cURL) 
curl --request POST \
  'https://kr.appointmenttrader.com/v1/media/set_media_labels' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'mediaIDs={{mediaIDs}}' \
  --data-urlencode 'labelIDs={{labelIDs}}' \
  --data-urlencode 'remove={{remove}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

반환값

JSON
See the shared response schema and synthetic example.
매개변수: mediaIDs
필드유형필수설명
mediaIDsstring (application/json) 예
mediaIDsarray (디코딩된 JSON) 예
mediaIDs[]integer 아니요
매개변수: labelIDs
필드유형필수설명
labelIDsstring (application/json) 예
labelIDsarray (디코딩된 JSON) 예
labelIDs[]integer 아니요
응답 필드
필드유형필수설명
$media_set_media_labels_Response 예
$.oneOf[0] 예
$.oneOf[0].allOf[0]object 예
$.oneOf[0].allOf[0].RequestUserAliasstring 예
$.oneOf[0].allOf[0].RequestPathstring | null 예
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" 예
$.oneOf[0].allOf[0].ResponseCodeinteger 예
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object 예
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring 아니요
$.oneOf[0].allOf[1]object 예
$.oneOf[0].allOf[1].Payloadobject 예
$.oneOf[0].allOf[1].Payload.updatedinteger 예
$.oneOf[1]object 예
$.oneOf[1].RequestUserAliasstring 예
$.oneOf[1].RequestPathstring | null 예
$.oneOf[1].RequestStatus = "Failed" 예
$.oneOf[1].ResponseCodeinteger 예
$.oneOf[1].ResponseMessageAPIResponseMessage 예
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null 예
$.oneOf[1].ResponseMessage.oneOf[1]array 예
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage 아니요
$.oneOf[1].ResponseMessage.oneOf[2]object 예
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage 아니요
$.oneOf[1].RequestImpersonatedByUserAliasstring 아니요
응답 예제 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_media_labels",
    "RequestUserAlias": "example-user",
    "Payload": {
        "updated": 0
    }
}
기계가 읽을 수 있는 엔드포인트 문서