مرجع API لـ listing | AppointmentTrader

GET

/v1/listing/get_competing_listings

#

Lists competing listings in a certain timeframe, along with pricing information

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing IDs to provide competing listing information for which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/listing/get_competing_listings' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_get_competing_listings_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.Name`	`= "Competing Listings"`	`نعم`
`$.oneOf[0].allOf[1].Payload.MetaInformation`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.MetaInformation.ListingCount`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingID`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].locationAlias`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].inventoryTypeName`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingDetailStatement`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingRespondByTime`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].inventoryTypeID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingCurrentAskingPrice`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingViewsOneDay`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingViewsAllTime`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingPopularityScoreBracket`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingStartHour`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingStartHour.anyOf[0]`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingStartHour.anyOf[0].anyOf[0]`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingStartHour.anyOf[0].anyOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].listingStartHour.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].isRequestingUserListing`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList[]`	`string`	`لا`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/get_competing_listings",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Name": "Competing Listings",
        "MetaInformation": {
            "ListingCount": 0
        },
        "KeyValueList": [],
        "KeyValueFieldList": []
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

GET

/v1/listing/get_discount_viewers

#

List eligible signed-in viewers from the last 30 days. Only the current listing owner may read this audience.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	Listing UUID.
`searchText`	`string`	`لا`	`""`	Optional alias search.
`page`	`int`	`لا`	`1`	One-based page; 50 viewers per page.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/listing/get_discount_viewers' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'searchText={{searchText}}' \
  --data-urlencode 'page={{page}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_get_discount_viewers_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.viewers`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.viewers[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.viewers[].userID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.viewers[].alias`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.viewers[].avatarEmoji`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.viewers[].lastViewedAt`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.total`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.page`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/get_discount_viewers",
    "RequestUserAlias": "example-user",
    "Payload": {
        "viewers": [],
        "total": 0,
        "page": 0,
        "hasMore": false
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

GET

/v1/listing/get_portfolio_listings

#

Legacy alias for /v1/portfolio/get_listings

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`getPopularityScoreBracket`	`bool`	`لا`	`false`	if true, the popularity score for all listings will be returned

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/listing/get_portfolio_listings' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'getPopularityScoreBracket={{getPopularityScoreBracket}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب	الوصف
`$`	`listing_get_portfolio_listings_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.Name`	`= "Portfolio Listing Items"`	`نعم`
`$.oneOf[0].allOf[1].Payload.MetaInformation`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].Name`	`string ["AppointmentDrafts","ApprovedAppointments","PrivateAppointments","UnlockedAppointments","SubmittedListings_Rejections","SubmittedListings_InReview","SubmittedListings_WaitingForReview"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].MetaInformation`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].MetaInformation.ListingCount`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingID`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationAlias`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingRespondByTime`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingRespondByTime.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingRespondByTime.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationCitySlug`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationCitySlug.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].locationCitySlug.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].creatorUserAlias`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].creatorUserAlias.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].creatorUserAlias.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeName`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeName.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].inventoryTypeName.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingTime`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingStartHour`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingStartHour.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingStartHour.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingCurrentAskingPrice`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingCurrentAskingPrice.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingCurrentAskingPrice.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].bid-communityPostID`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].bid-communityPostID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].bid-communityPostID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].bid-communityPostID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].bid-communityPostID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingDetailStatement`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingStatus`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingPublicConfirmationNumber`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].orderListID`		`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].orderListID.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].orderListID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingPopularityScoreBracket`		`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingPopularityScoreBracket.anyOf[0]`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingPopularityScoreBracket.anyOf[1]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingPopularityScoreBracket.anyOf[2]`	`null`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsOneDay`	`DatabaseInteger`	`لا`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsOneDay.oneOf[0]`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsOneDay.oneOf[1]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsAllTime`	`DatabaseInteger`	`لا`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsAllTime.oneOf[0]`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueList[].listingViewsAllTime.oneOf[1]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueFieldList`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.KeyValueList[].KeyValueFieldList[]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.KeyValueFieldList`	`= []`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/get_portfolio_listings",
    "RequestUserAlias": "example-user",
    "Payload": {
        "Name": "Portfolio Listing Items",
        "MetaInformation": [],
        "KeyValueList": [],
        "KeyValueFieldList": []
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

GET

/v1/listing/get_viewer_discount_preview

#

Preview a seller-funded fixed-amount offer. Public price stays unchanged; fees use the discounted price.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	Listing UUID.
`discountAmountInSmallestUnit`	`int`	`نعم`	`—`	Positive USD cents.
`currencyCode`	`string`	`لا`	`"USD"`	Listing discount currency; USD.
`durationHours`	`int`	`لا`	`24`	One of 1, 6, 24, 48, capped by listing expiry.
`allViewers`	`bool`	`لا`	`true`	Include all eligible viewers across every page.
`recipientUserIDList`	`string`	`لا`	`""`	Comma-separated selected IDs when allViewers is false.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/listing/get_viewer_discount_preview' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'discountAmountInSmallestUnit={{discountAmountInSmallestUnit}}' \
  --data-urlencode 'currencyCode={{currencyCode}}' \
  --data-urlencode 'durationHours={{durationHours}}' \
  --data-urlencode 'allViewers={{allViewers}}' \
  --data-urlencode 'recipientUserIDList={{recipientUserIDList}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_get_viewer_discount_preview_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.currencyCode`	`= "USD"`	`نعم`
`$.oneOf[0].allOf[1].Payload.originalPriceCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.discountCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.buyerPriceCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.feeCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sellerProceedsCents`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.recipientCount`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.expiresAtISO`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.previewToken`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/get_viewer_discount_preview",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "currencyCode": "USD",
        "originalPriceCents": 0,
        "discountCents": 0,
        "buyerPriceCents": 0,
        "feeCents": 0,
        "sellerProceedsCents": 0,
        "recipientCount": 0,
        "expiresAt": "synthetic-example",
        "expiresAtISO": "synthetic-example",
        "previewToken": "synthetic-example"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

GET

/v1/listing/get_viewer_discount_status

#

Read delivery progress for an offer belonging to the current listing owner.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	Listing UUID.
`offerID`	`int`	`نعم`	`—`	Offer returned by /v1/listing/set_send_viewer_discount.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/listing/get_viewer_discount_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'offerID={{offerID}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_get_viewer_discount_status_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.offerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.queued`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.sent`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.skipped`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.failed`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.active`	`boolean`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/get_viewer_discount_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "offerID": 0,
        "counts": {
            "queued": 0,
            "sent": 0,
            "skipped": 0,
            "failed": 0
        },
        "expiresAt": "synthetic-example",
        "active": false
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_archive

#

Archive Listing

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingUUID`	`string`	`نعم`	`—`	Unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings or /v1/location/set_listing
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_archive' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingUUID={{listingUUID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_archive_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`= true`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_archive",
    "RequestUserAlias": "example-user",
    "Payload": true
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_begin_transfer

#

Start working on a transfer-service listing.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_begin_transfer' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_begin_transfer_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.success`	`= true`	`نعم`
`$.oneOf[0].allOf[1].Payload.message`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_begin_transfer",
    "RequestUserAlias": "example-user",
    "Payload": {
        "success": true,
        "message": "synthetic-example"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_cancel_bid

#

Cancels a bid

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`bidID`	`int`	`نعم`	`—`	unique bid ID
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_cancel_bid' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_cancel_bid_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`= true`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_cancel_bid",
    "RequestUserAlias": "example-user",
    "Payload": true
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_cancel_transfer_service

#

Cancel transfer service for a seller-owned listing.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_cancel_transfer_service' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_cancel_transfer_service_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.success`	`= true`	`نعم`
`$.oneOf[0].allOf[1].Payload.message`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_cancel_transfer_service",
    "RequestUserAlias": "example-user",
    "Payload": {
        "success": true,
        "message": "synthetic-example"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_complete_transfer

#

Mark a transfer-service listing as successfully transferred.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings
`givenName`	`string`	`نعم`	`—`	first name now on the reservation
`familyName`	`string`	`نعم`	`—`	last name now on the reservation
`dynamicFieldsJson`	`string`	`لا`	`""`	optional JSON object of location field id to value
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_complete_transfer' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'givenName={{givenName}}' \
  --data-urlencode 'familyName={{familyName}}' \
  --data-urlencode 'dynamicFieldsJson={{dynamicFieldsJson}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

المعلمات: dynamicFieldsJson

الحقل	النوع	مطلوب
`dynamicFieldsJson`	`string (application/json)`	`لا`
`dynamicFieldsJson`	`object (JSON بعد فك الترميز)`	`لا`
`dynamicFieldsJson.*`	`string`	`لا`

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_complete_transfer_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.success`	`= true`	`نعم`
`$.oneOf[0].allOf[1].Payload.message`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.currencyReceived`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.newBalance`		`نعم`
`$.oneOf[0].allOf[1].Payload.newBalance.anyOf[0]`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.newBalance.anyOf[1]`	`null`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_complete_transfer",
    "RequestUserAlias": "example-user",
    "Payload": {
        "success": true,
        "message": "synthetic-example",
        "currencyReceived": 0,
        "newBalance": 0
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_create_from_template

#

Creates an appointment from a template, only appointments owned by api user may be copied. With publishListing and discardTemplateListing true, a locked Private reservation is relisted in place at the selected price in unrestricted markets only. Owner, permission, listing-limit, future-date, and refund/no-show checks still apply. An Approved original may be retried without duplicating the reservation or status history.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`templateListingID`	`string`	`نعم`	`—`	unique listing ID which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing
`publishListing`	`bool`	`لا`	`false`	if true, the listing will be published to the market, if false it will be taken private
`bidID`	`int`	`لا`	`-1`	optional matching bid to fill when publishListing is true; -1 leaves the listing unlinked
`discardTemplateListing`	`bool`	`لا`	`false`	archive the original after copying; with publishListing true, Private and Approved originals are updated in place instead
`priceAmountInSmallestUnit`	`int`	`لا`	`-1`	optional asking price for the relisted or copied listing in the smallest currency unit; rounded to USD 5 steps within the configured minimum and USD 10000 maximum
`isWritingRequest`	`bool`	`لا`	`false`	false (default) prevents writes; set true to publish or copy the listing

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_create_from_template' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'templateListingID={{templateListingID}}' \
  --data-urlencode 'publishListing={{publishListing}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'discardTemplateListing={{discardTemplateListing}}' \
  --data-urlencode 'priceAmountInSmallestUnit={{priceAmountInSmallestUnit}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب	الوصف
`$`	`listing_set_create_from_template_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`string`	`نعم`	UUID of the resulting listing.
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_create_from_template",
    "RequestUserAlias": "example-user",
    "Payload": "synthetic-example"
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_delete_review

#

Take a listing out of review and delete it.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingUUID`	`string`	`نعم`	`—`	Unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings or /v1/location/set_listing
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_delete_review' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingUUID={{listingUUID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_delete_review_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.status`	`= "deleted"`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_delete_review",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "status": "deleted"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_fail_transfer

#

Mark a transfer-service listing as failed.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings
`failedOption`	`string`	`نعم`	`—`	Unlock if the buyer can still use the listing, Failed otherwise
`reason`	`string`	`نعم`	`—`	transfer failure note
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_fail_transfer' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'failedOption={{failedOption}}' \
  --data-urlencode 'reason={{reason}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_fail_transfer_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.success`	`= true`	`نعم`
`$.oneOf[0].allOf[1].Payload.message`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_fail_transfer",
    "RequestUserAlias": "example-user",
    "Payload": {
        "success": true,
        "message": "synthetic-example"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_fill_bid

#

Fills a bid with a portfolio bid answer that is either off market or publicly available to fill a bid with a new bid answer please use /v1/location/set_listing An ordinary pickup requiring an auction returns auctionRequired and auctionURL instead of filling. Ready inventory must win the auction first; the winner can attach this listing to their awarded hold. Available normal bids also accept complete inventory without FillBids or a prior hold, after response selection finishes. A submitted listing claims the bid for review; approved inventory completes the fill. Buyer-selected, unexpired direct hires also accept Premium confirmations without FillBids or HoldPremiumBids. This grants no pickup or round access.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing
`bidID`	`int`	`نعم`	`—`	Requested bid. Complete inventory must match its accepted terms and seller-selection policy.
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request
`outsideRequestedTimeframeAcknowledged`	`bool`	`لا`	`false`	Set true only after the concierge accepts the held answer's out-of-timeframe warning. Recorded against this answer and current bid terms for completion or later review; does not waive non-time requirements or direct-fill matching.
`selfReviewConfirmed`	`bool`	`لا`	`false`	Explicit final confirmation for eligible self-review of an unapproved confirmation; defaults to false.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_fill_bid' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}' \
  --data-urlencode 'outsideRequestedTimeframeAcknowledged={{outsideRequestedTimeframeAcknowledged}}' \
  --data-urlencode 'selfReviewConfirmed={{selfReviewConfirmed}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب	الوصف
`$`	`listing_set_fill_bid_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`string`	`نعم`	UUID of the resulting listing.
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_fill_bid",
    "RequestUserAlias": "example-user",
    "Payload": "synthetic-example"
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_market_visibility

#

Changes the visibility in the market. In the portal private listings appear in the private section and public in 'Publicly traded listings'

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing
`publishListing`	`bool`	`نعم`	`—`	if true, the listing will be published to the market, if false it will be taken private
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_market_visibility' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'publishListing={{publishListing}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_market_visibility_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`= true`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_market_visibility",
    "RequestUserAlias": "example-user",
    "Payload": true
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_price

#

Changes the current listing price

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing
`priceAmountInSmallestUnit`	`int`	`نعم`	`—`	Smallest possible currency unit, for example USD 100 would be 10000 (usd-cents), amounts will be rounded to next 5 increment. Refer to the MetaInformation of the return object of /v1/location/get_comparable_trades for pricing information. Endpoint will also return if there is an available bid - if available bid price is matched in your upload, bid will automatically be filled.
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_price' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'priceAmountInSmallestUnit={{priceAmountInSmallestUnit}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_price_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`= true`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_price",
    "RequestUserAlias": "example-user",
    "Payload": true
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_purchase

#

Purchase a listing

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`fundingAccountID`	`int`	`نعم`	`—`	ID of the account that will fund the bid, accountIDs can be found in /v1/account/get_list
`listingID`	`string`	`نعم`	`—`	the unique listing ID that shall be purchased
`orderListID`	`string`	`لا`	`""`	If this bid is part of an orderList, set the ID here.
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_purchase' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'fundingAccountID={{fundingAccountID}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'orderListID={{orderListID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_purchase_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`= true`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_purchase",
    "RequestUserAlias": "example-user",
    "Payload": true
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_send_viewer_discount

#

Send one private offer per viewer per listing through normal notifications. Reuse requestID for uncertain retries.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	Listing UUID.
`discountAmountInSmallestUnit`	`int`	`نعم`	`—`	Fixed discount in USD cents.
`previewToken`	`string`	`نعم`	`—`	Unchanged token from /v1/listing/get_viewer_discount_preview.
`requestID`	`string`	`نعم`	`—`	Unique request identifier, 16-64 letters/digits/hyphens. Reusing it with different parameters fails.
`currencyCode`	`string`	`لا`	`"USD"`	USD.
`durationHours`	`int`	`لا`	`24`	1, 6, 24 or 48.
`allViewers`	`bool`	`لا`	`true`	Send to all eligible viewers, not just the visible page.
`recipientUserIDList`	`string`	`لا`	`""`	Comma-separated selected user IDs when allViewers is false.
`isWritingRequest`	`bool`	`لا`	`false`	Must be true to queue notifications.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_send_viewer_discount' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'discountAmountInSmallestUnit={{discountAmountInSmallestUnit}}' \
  --data-urlencode 'previewToken={{previewToken}}' \
  --data-urlencode 'requestID={{requestID}}' \
  --data-urlencode 'currencyCode={{currencyCode}}' \
  --data-urlencode 'durationHours={{durationHours}}' \
  --data-urlencode 'allViewers={{allViewers}}' \
  --data-urlencode 'recipientUserIDList={{recipientUserIDList}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_send_viewer_discount_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.offerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.queued`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.sent`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.skipped`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.counts.failed`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.active`	`boolean`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_send_viewer_discount",
    "RequestUserAlias": "example-user",
    "Payload": {
        "offerID": 0,
        "counts": {
            "queued": 0,
            "sent": 0,
            "skipped": 0,
            "failed": 0
        },
        "expiresAt": "synthetic-example",
        "active": false
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_unarchive

#

Restore an archived listing to its previous market visibility.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingUUID`	`string`	`نعم`	`—`	Unique listing ID that can be retrieved by /v1/listing/get_portfolio_listings or /v1/location/set_listing
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_unarchive' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingUUID={{listingUUID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_unarchive_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.status`	`string ["Approved","Private","Unlocked","Transfer Failed But Unlocked"]`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_unarchive",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "status": "Approved"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا

POST

/v1/listing/set_update

#

Updates an off-market seller listing using the same structured listing fields as the v2 listing composer.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`listingID`	`string`	`نعم`	`—`	unique listing ID which can be retrieved by /v1/listing/get_portfolio_listings or when creating a new listing with /v1/location/set_listing
`locationAlias`	`string`	`نعم`	`—`	Slug found after the slash when opening a location in the portal
`inventoryTypeID`	`int`	`نعم`	`—`	inventoryTypeID found in /v1/location/get_inventory_types
`priceAmountInSmallestUnit`	`int`	`نعم`	`—`	Smallest possible currency unit, for example USD 100 would be 10000 (usd-cents).
`currencyCode`	`string`	`نعم`	`—`	3 digit currency code, currently all prices will be converted to USD and rounded
`dateTime`	`string`	`نعم`	`—`	Date and Time of listing. Date format: YYYY-MM-DD HH:MM:SS
`firstName`	`string`	`نعم`	`—`	First name of listing
`lastName`	`string`	`نعم`	`—`	Last name of listing
`emailAddress`	`string`	`نعم`	`—`	Email address associated with the listing
`phoneNumber`	`string`	`نعم`	`—`	Phone number associated with the listing
`locationCategoryFieldIDValueList`	`array`	`نعم`	`—`	Refer to /v1/location/get_category to identify the required and optional field list for the location you are submitting for.
`isWritingRequest`	`bool`	`لا`	`false`	all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request
`resubmitRejectedListing`	`bool`	`لا`	`false`	Set true when fixing a rejected listing and resubmitting it for review.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/listing/set_update' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'locationAlias={{locationAlias}}' \
  --data-urlencode 'inventoryTypeID={{inventoryTypeID}}' \
  --data-urlencode 'priceAmountInSmallestUnit={{priceAmountInSmallestUnit}}' \
  --data-urlencode 'currencyCode={{currencyCode}}' \
  --data-urlencode 'dateTime={{dateTime}}' \
  --data-urlencode 'firstName={{firstName}}' \
  --data-urlencode 'lastName={{lastName}}' \
  --data-urlencode 'emailAddress={{emailAddress}}' \
  --data-urlencode 'phoneNumber={{phoneNumber}}' \
  --data-urlencode 'locationCategoryFieldIDValueList={{locationCategoryFieldIDValueList}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}' \
  --data-urlencode 'resubmitRejectedListing={{resubmitRejectedListing}}'

القيمة المُرجعة

JSON

See the shared response schema and synthetic example.

المعلمات: locationCategoryFieldIDValueList

الحقل	النوع	مطلوب	الوصف
`locationCategoryFieldIDValueList`	`string (application/json)`	`نعم`	Pass a JSON-encoded string, not nested form fields.
`locationCategoryFieldIDValueList`	`array (JSON بعد فك الترميز)`	`نعم`
`locationCategoryFieldIDValueList[]`		`لا`
`locationCategoryFieldIDValueList[].oneOf[0]`	`object`	`لا`
`locationCategoryFieldIDValueList[].oneOf[0].fieldID`	`integer`	`نعم`
`locationCategoryFieldIDValueList[].oneOf[0].fieldValue`	`string`	`نعم`
`locationCategoryFieldIDValueList[].oneOf[1]`	`object`	`لا`
`locationCategoryFieldIDValueList[].oneOf[1].ID`		`نعم`
`locationCategoryFieldIDValueList[].oneOf[1].ID.anyOf[0]`	`integer`	`نعم`
`locationCategoryFieldIDValueList[].oneOf[1].ID.anyOf[1]`	`string`	`نعم`
`locationCategoryFieldIDValueList[].oneOf[1].Value`	`string`	`نعم`

حقول الاستجابة

الحقل	النوع	مطلوب
`$`	`listing_set_update_Response`	`نعم`
`$.oneOf[0]`		`نعم`
`$.oneOf[0].allOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`نعم`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`نعم`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`نعم`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`نعم`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`
`$.oneOf[0].allOf[1]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.appointmentID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.status`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.locationName`	`string`	`نعم`
`$.oneOf[1]`	`object`	`نعم`
`$.oneOf[1].RequestUserAlias`	`string`	`نعم`
`$.oneOf[1].RequestPath`	`string \| null`	`نعم`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`نعم`
`$.oneOf[1].ResponseCode`	`integer`	`نعم`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`نعم`
`$.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].RequestImpersonatedByUserAlias`	`string`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/listing/set_update",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "appointmentID": 0,
        "status": "synthetic-example",
        "locationName": "synthetic-example"
    }
}

توثيق نقطة النهاية القابل للقراءة آليًا