media API başvurusu | AppointmentTrader

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.

İstek örneği (cURL)

curl --get \
  'https://tr.appointmenttrader.com/v1/media/get_ftp_credentials' \
  --data-urlencode 'key={{API_KEY}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli	Açıklama
`$`	`media_get_ftp_credentials_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials`		`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].credentialID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label`		`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].username`	`string`	`Evet`	Owner FTP username; examples are deliberately fictitious.
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password`		`Evet`	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`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].enabled`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].notifyOnImport`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].requiresReset`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`logDate`	`string`	`HAYIR`	`""`	UTC log date, or empty for the latest available log.

İstek örneği (cURL)

curl --get \
  'https://tr.appointmenttrader.com/v1/media/get_ftp_logs' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'logDate={{logDate}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_get_ftp_logs_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.dates`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.dates[]`	`string`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.date`		`Evet`
`$.oneOf[0].allOf[1].Payload.date.anyOf[0]`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.date.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.text`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.truncated`	`boolean`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

GET

/v1/media/get_labels

#

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

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`afterID`	`int`	`HAYIR`	`0`	Previous nextID, or zero for the first page.
`search`	`string`	`HAYIR`	`""`	Optional name search; restart afterID when changing search.
`labelID`	`int`	`HAYIR`	`0`	Resolve one owned label for an existing selection; zero browses the catalog.

İstek örneği (cURL)

curl --get \
  'https://tr.appointmenttrader.com/v1/media/get_labels' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'afterID={{afterID}}' \
  --data-urlencode 'search={{search}}' \
  --data-urlencode 'labelID={{labelID}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_get_labels_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.labels`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.labels[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.labels[].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.labels[].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.labels[].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.labels[].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextID`		`Evet`
`$.oneOf[0].allOf[1].Payload.nextID.anyOf[0]`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextID.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_labels",
    "RequestUserAlias": "example-user",
    "Payload": {
        "labels": [],
        "nextID": 0
    }
}

Makine tarafından okunabilir uç nokta belgeleri

GET

/v1/media/get_my_media

#

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

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`search`	`string`	`HAYIR`	`""`	Filename, title or description search.
`kind`	`string`	`HAYIR`	`""`	Empty, image, video, audio or document.
`usage`	`string`	`HAYIR`	`""`	Empty, unattached, post, profile, message, request or preview.
`month`	`string`	`HAYIR`	`""`	Creation month YYYY-MM, or empty for all dates.
`order`	`string`	`HAYIR`	`"newest"`	newest or oldest.
`cursor`	`string`	`HAYIR`	`""`	Opaque continuation returned by the previous page.
`pageSize`	`int`	`HAYIR`	`60`	Items per page, capped at 100.
`labelID`	`int`	`HAYIR`	`0`	Owned label ID, including archives; zero means all.
`unlabeled`	`bool`	`HAYIR`	`false`	Only media without labels; mutually exclusive with labelID.

İstek örneği (cURL)

curl --get \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_get_my_media_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.items`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.items[].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].thumbUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].mediaUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].mediaType`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].width`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].height`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].title`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].isImage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].isEmbedded`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].kind`	`string ["image","video","audio","document"]`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].createdDate`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].filename`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].size`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].duration`		`Evet`
`$.oneOf[0].allOf[1].Payload.items[].duration.anyOf[0]`	`number`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].duration.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].downloadUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].labels`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].labels[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.items[].labels[].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].labels[].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].labels[].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].labels[].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.items[].hasUsage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextCursor`		`Evet`
`$.oneOf[0].allOf[1].Payload.nextCursor.anyOf[0]`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextCursor.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.lastMediaID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.pageSignature`		`Evet`
`$.oneOf[0].allOf[1].Payload.pageSignature.anyOf[0]`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.pageSignature.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`mediaID`	`int`	`Evet`	`—`	Owned ATMedia ID.
`afterUsageID`	`int`	`HAYIR`	`0`	Continuation returned as nextUsageID.
`afterLabelPostID`	`int`	`HAYIR`	`0`	Dynamic usage continuation, -1 when exhausted.

İstek örneği (cURL)

curl --get \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_get_my_media_item_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.thumbUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaType`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.width`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.height`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.title`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isImage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isEmbedded`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.kind`	`string ["image","video","audio","document"]`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.createdDate`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.filename`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.size`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration`		`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]`	`number`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.downloadUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.labels`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.labels[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.item.labels[].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.labels[].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.labels[].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.labels[].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.usages[].type`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages[].role`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages[].title`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages[].url`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.usages[].chatID`	`integer`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.usages[].notificationBodyID`	`integer`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.usages[].versionId`	`integer`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.usages[].postId`	`integer`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.hasUnavailableUsage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextUsageID`		`Evet`
`$.oneOf[0].allOf[1].Payload.nextUsageID.anyOf[0]`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextUsageID.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextLabelPostID`		`Evet`
`$.oneOf[0].allOf[1].Payload.nextLabelPostID.anyOf[0]`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.nextLabelPostID.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

GET

/v1/media/get_my_media_timeline

#

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

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`search`	`string`	`HAYIR`	`""`	Filename, title or description search.
`kind`	`string`	`HAYIR`	`""`	Empty, image, video, audio or document.
`usage`	`string`	`HAYIR`	`""`	Empty, unattached, post, profile, message, request or preview.
`labelID`	`int`	`HAYIR`	`0`	Owned label ID, including archives; zero means all.
`unlabeled`	`bool`	`HAYIR`	`false`	Only media without labels; mutually exclusive with labelID.

İstek örneği (cURL)

curl --get \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli	Açıklama
`$`	`media_get_my_media_timeline_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.months`	`array`	`Evet`
`$.oneOf[0].allOf[1].Payload.months[]`	`object`	`HAYIR`
`$.oneOf[0].allOf[1].Payload.months[].month`		`Evet`
`$.oneOf[0].allOf[1].Payload.months[].month.anyOf[0]`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.months[].month.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.months[].count`	`DatabaseInteger`	`Evet`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.months[].count.oneOf[0]`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.months[].count.oneOf[1]`	`string`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/get_my_media_timeline",
    "RequestUserAlias": "example-user",
    "Payload": {
        "months": []
    }
}

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`postID`	`int`	`Evet`	`—`	Accessible source post containing the image.
`mediaID`	`int`	`Evet`	`—`	Retained image attached to that post.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_copy_post_photo_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.thumbUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaType`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.width`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.height`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.title`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isImage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isEmbedded`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.kind`	`string ["image","video","audio","document"]`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.createdDate`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.filename`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.size`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration`		`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]`	`number`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.downloadUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.boardID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.slug`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.city`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.cityGroupCode`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.intent`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.callback`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.count`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.unitLabel`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.createsRegularBoardPost`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.isDefaultRequestBoard`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.isDefaultListingBoard`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.routingEnabled`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.routingDescription`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.selected`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.viewerCanRead`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.viewerCanWrite`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.wallBoard.hasAccessMetadata`	`= true`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`mediaID`	`int`	`Evet`	`—`	Owned ATMedia ID.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.appointmenttrader.com/v1/media/set_delete_file' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'mediaID={{mediaID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_delete_file_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.mediaID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.deleted`	`= true`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_delete_file",
    "RequestUserAlias": "example-user",
    "Payload": {
        "mediaID": 0,
        "deleted": true
    }
}

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`reset`	`bool`	`HAYIR`	`false`	Replace the password and shorten a legacy username if needed.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.appointmenttrader.com/v1/media/set_ftp_credentials' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'reset={{reset}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli	Açıklama
`$`	`media_set_ftp_credentials_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials`		`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].credentialID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label`		`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[0].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].label.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].username`	`string`	`Evet`	Owner FTP username; examples are deliberately fictitious.
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password`		`Evet`	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`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].password.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].enabled`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].notifyOnImport`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[0].requiresReset`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentials.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`credentialID`	`int`	`Evet`	`—`	Owned FTP credential ID.
`labelID`	`int`	`HAYIR`	`0`	Owned active label ID; zero clears.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.appointmenttrader.com/v1/media/set_ftp_label' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'credentialID={{credentialID}}' \
  --data-urlencode 'labelID={{labelID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_ftp_label_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentialID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.label`		`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`credentialID`	`int`	`Evet`	`—`	Owned FTP credential ID.
`notifyOnImport`	`bool`	`Evet`	`—`	Whether successful imports create a priority notification.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.appointmenttrader.com/v1/media/set_ftp_notifications' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'credentialID={{credentialID}}' \
  --data-urlencode 'notifyOnImport={{notifyOnImport}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_ftp_notifications_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.credentialID`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.notifyOnImport`	`boolean`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_ftp_notifications",
    "RequestUserAlias": "example-user",
    "Payload": {
        "credentialID": 0,
        "notifyOnImport": false
    }
}

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`sourceURL`	`string`	`Evet`	`—`	Absolute public media URL. Private-network addresses and credentials are rejected.
`importID`	`string`	`Evet`	`—`	Caller-generated stable delivery ID, 8-128 letters, numbers, underscores or hyphens.
`title`	`string`	`HAYIR`	`""`	Optional media title, up to 250 characters.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_import_from_url_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.thumbUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.mediaType`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.width`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.height`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.title`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isImage`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.isEmbedded`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.kind`	`string ["image","video","audio","document"]`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.createdDate`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.filename`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.size`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration`		`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[0]`	`number`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.duration.anyOf[1]`	`null`	`Evet`
`$.oneOf[0].allOf[1].Payload.item.downloadUrl`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.reused`	`boolean`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

POST

/v1/media/set_label

#

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

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`name`	`string`	`Evet`	`—`	Trimmed label name, 1–100 characters, case-insensitively unique per account.
`labelID`	`int`	`HAYIR`	`0`	Zero creates a label; otherwise renames without changing its ID.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.
`emoji`	`string`	`HAYIR`	`null`	One emoji; omitted preserves the existing value.

İstek örneği (cURL)

curl --request POST \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_label_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.label`		`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`labelID`	`int`	`Evet`	`—`	Owned label ID.
`archived`	`bool`	`Evet`	`—`	True archives; false restores.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.
`confirmDetach`	`bool`	`HAYIR`	`false`	Acknowledge permanent removal from linked posts.

İstek örneği (cURL)

curl --request POST \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_label_archived_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.label`		`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].id`	`integer`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].name`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].emoji`	`string`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[0].archived`	`boolean`	`Evet`
`$.oneOf[0].allOf[1].Payload.label.anyOf[1]`	`null`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

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

Makine tarafından okunabilir uç nokta belgeleri

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.

Parametreler

Ad	Tür	Gerekli	Varsayılan	Açıklama
`mediaIDs`	`string`	`Evet`	`—`	JSON array of 1–100 media IDs.
`labelIDs`	`string`	`Evet`	`—`	JSON array of 1–100 owned label IDs.
`remove`	`bool`	`HAYIR`	`false`	True removes; false adds. Repeating an operation is harmless.
`isWritingRequest`	`bool`	`HAYIR`	`false`	Explicit write acknowledgement.

İstek örneği (cURL)

curl --request POST \
  'https://tr.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}}'

Dönen değer

JSON

See the shared response schema and synthetic example.

Parametreler: mediaIDs

Alan	Tür	Gerekli
`mediaIDs`	`string (application/json)`	`Evet`
`mediaIDs`	`array (çözümlenmiş JSON)`	`Evet`
`mediaIDs[]`	`integer`	`HAYIR`

Parametreler: labelIDs

Alan	Tür	Gerekli
`labelIDs`	`string (application/json)`	`Evet`
`labelIDs`	`array (çözümlenmiş JSON)`	`Evet`
`labelIDs[]`	`integer`	`HAYIR`

Yanıt alanları

Alan	Tür	Gerekli
`$`	`media_set_media_labels_Response`	`Evet`
`$.oneOf[0]`		`Evet`
`$.oneOf[0].allOf[0]`	`object`	`Evet`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Evet`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Evet`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Evet`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`HAYIR`
`$.oneOf[0].allOf[1]`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload`	`object`	`Evet`
`$.oneOf[0].allOf[1].Payload.updated`	`integer`	`Evet`
`$.oneOf[1]`	`object`	`Evet`
`$.oneOf[1].RequestUserAlias`	`string`	`Evet`
`$.oneOf[1].RequestPath`	`string \| null`	`Evet`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Evet`
`$.oneOf[1].ResponseCode`	`integer`	`Evet`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Evet`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`HAYIR`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`HAYIR`

Yanıt örneği

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/media/set_media_labels",
    "RequestUserAlias": "example-user",
    "Payload": {
        "updated": 0
    }
}

Makine tarafından okunabilir uç nokta belgeleri