مرجع API لـ customer_survey

GET

/v1/customer_survey/get_catalog

#

List AT and private templates, reusable fields, and optional chat recipient/sales context. Never returns customer answers.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`chatID`	`int`	`لا`	`0`	Accepted direct or bid chat; zero lists the acting seller's catalog.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/customer_survey/get_catalog' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'chatID={{chatID}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب	الوصف
`$`	`customer_survey_get_catalog_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.fields`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].CreatedDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].OwnerUserID`		`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].OwnerUserID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].OwnerUserID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].OwnerUserID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].OwnerUserID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].FieldKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].FieldGroup`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].FieldType`	`string ["text","number","boolean","single_select","multi_select","longtext"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ValueScope`	`string ["customer","booking"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON`	`string (application/json)`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON`	`SurveyValidation (JSON بعد فك الترميز)`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[0].maxLength`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[0].integer`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[0].min`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[0].max`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].ValidationJSON.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].IsActive`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].IsActive.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].IsActive.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].Options[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].FieldID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].Options[].FieldID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].FieldID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].OptionKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].SortOrder`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.fields[].Options[].SortOrder.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.fields[].Options[].SortOrder.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.templates[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.templates[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].CreatedDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].OwnerUserID`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].OwnerUserID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.templates[].OwnerUserID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].OwnerUserID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].OwnerUserID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].StarterKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].StarterKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].StarterKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].SourceTemplateID`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].SourceTemplateID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.templates[].SourceTemplateID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].SourceTemplateID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].SourceTemplateID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].CurrentVersionID`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].CurrentVersionID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.templates[].CurrentVersionID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].CurrentVersionID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].CurrentVersionID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].ArchivedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].ArchivedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].ArchivedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].Title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].TitleKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].TitleKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].TitleKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].VersionNumber`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.templates[].VersionNumber.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.templates[].VersionNumber.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.context`		`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].canSend`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].writable`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].chatID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].customerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].bidID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].reasonCode`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].reason`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].otherUserID`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].buyerIdentityHidden`	`boolean`	`لا`	True when the authenticated viewer cannot see the buyer during the current response race.
`$.oneOf[0].allOf[1].Payload.context.anyOf[0].buyerIdentityHiddenUntil`	`integer \| null`	`لا`	Saved current-round ClosesAt as Unix seconds; null when identity is visible. Reveal is authoritative only on a new response.
`$.oneOf[0].allOf[1].Payload.context.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer`		`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].alias`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].avatar`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].avatarEmoji`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImageUrl`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImageURL`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileUrl`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileURL`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].customColor`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].customTextColor`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].avatarMode`	`string \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].html`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].id`	`integer \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].userID`	`integer \| null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].isRich`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage`		`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].thumbUrl`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].mediaUrl`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].mediaType`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].width`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].height`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].isImage`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].isEmbedded`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].frame`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].frame.positionXPercent`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].frame.positionYPercent`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].frame.zoomPercent`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[0].backgroundUrl`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].profileImage.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].medals`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].medals[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].medals[].Name`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].medals[].URL`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].identityHidden`	`boolean`	`لا`	An anonymized author has no profile or follow action.
`$.oneOf[0].allOf[1].Payload.customer.anyOf[0].identityHiddenUntil`	`integer \| null`	`لا`	Current response-race closing timestamp in Unix seconds.
`$.oneOf[0].allOf[1].Payload.customer.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.sales[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/get_catalog",
    "RequestUserAlias": "example-user",
    "Payload": {
        "fields": [],
        "templates": [],
        "context": {
            "canSend": false,
            "writable": false,
            "chatID": 0,
            "customerID": 0,
            "bidID": 0
        },
        "customer": {
            "alias": "synthetic-example",
            "avatar": "synthetic-example",
            "avatarEmoji": "synthetic-example",
            "profileImageUrl": "synthetic-example",
            "profileImageURL": "synthetic-example",
            "label": "synthetic-example",
            "profileUrl": "synthetic-example",
            "profileURL": "synthetic-example",
            "title": "synthetic-example",
            "customColor": "synthetic-example",
            "customTextColor": "synthetic-example",
            "avatarMode": "synthetic-example",
            "html": "synthetic-example",
            "id": 0,
            "userID": 0,
            "isRich": false,
            "profileImage": {
                "id": 0,
                "thumbUrl": "synthetic-example",
                "mediaUrl": "synthetic-example",
                "mediaType": "synthetic-example",
                "width": 0,
                "height": 0,
                "title": "synthetic-example",
                "isImage": false,
                "isEmbedded": false,
                "frame": {
                    "positionXPercent": 0,
                    "positionYPercent": 0,
                    "zoomPercent": 100
                }
            },
            "medals": []
        },
        "sales": []
    }
}

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

GET

/v1/customer_survey/get_customer_fields

#

Read own remembered values, or values this customer explicitly shared with the acting seller. Other sellers' responses are never returned.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`customerID`	`int`	`نعم`	`—`	Customer user ID.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/customer_survey/get_customer_fields' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'customerID={{customerID}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب	الوصف
`$`	`customer_survey_get_customer_fields_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.canForget`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.items`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.items[].fieldID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].type`	`string ["text","longtext","number","boolean","single_select","multi_select"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value`	`SurveyAnswerValue`	`نعم`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[0]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[2]`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[3]`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[4]`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].value.anyOf[4][]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.items[].options`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].options[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.items[].options[].key`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].options[].label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].confirmedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.items[].confirmedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].confirmedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].sourceTitle`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].revision`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/get_customer_fields",
    "RequestUserAlias": "example-user",
    "Payload": {
        "canForget": false,
        "items": []
    }
}

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

GET

/v1/customer_survey/get_request

#

Read a questionnaire. Only its customer receives drafts, remembered prefills and memory revisions. Sellers receive submitted history only.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`requestID`	`int`	`نعم`	`—`	Sent questionnaire identifier.
`adminInspection`	`bool`	`لا`	`false`	Explicit read-only inspection requiring AccessSpecialFunctions; logged with actor and request.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/customer_survey/get_request' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'requestID={{requestID}}' \
  --data-urlencode 'adminInspection={{adminInspection}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب	الوصف
`$`	`customer_survey_get_request_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.request`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.customerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.sellerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.chatID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.bidID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.transactionID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.status`	`string ["sent","in_progress","submitted","cancelled"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.submittedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.request.submittedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.submittedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.url`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.request.buyerIdentityHidden`	`boolean`	`لا`	True when the authenticated viewer cannot see the buyer during the current response race.
`$.oneOf[0].allOf[1].Payload.request.buyerIdentityHiddenUntil`	`integer \| null`	`لا`	Saved current-round ClosesAt as Unix seconds; null when identity is visible. Reveal is authoritative only on a new response.
`$.oneOf[0].allOf[1].Payload.title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.introduction`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].VersionID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].VersionID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].VersionID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].QuestionKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].HelpText`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldType`	`string ["text","number","boolean","single_select","multi_select","longtext"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Required`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Required.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Required.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON`	`string (application/json)`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON`	`SurveyValidation (JSON بعد فك الترميز)`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].maxLength`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].integer`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].min`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].max`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope.anyOf[0]`	`string ["customer","booking"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation`	`SurveyValidation`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].maxLength`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].integer`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].min`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].max`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].OptionKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.history`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[].revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[].submittedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.history[].submittedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[].submittedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[].answers`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.history[].answers.*`	`SurveyAnswerValue`	`لا`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[0]`	`null`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[1]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[2]`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[3]`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[4]`	`array`	`لا`
`$.oneOf[0].allOf[1].Payload.history[].answers.*.anyOf[4][]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.draft`		`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].submittedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].submittedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].submittedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*`	`SurveyAnswerValue`	`لا`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[0]`	`null`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[1]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[2]`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[3]`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[4]`	`array`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[0].answers.*.anyOf[4][]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.draft.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.prefill.*.value`	`SurveyAnswerValue`	`نعم`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[0]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[2]`	`number`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[3]`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[4]`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.prefill.*.value.anyOf[4][]`	`string`	`لا`
`$.oneOf[0].allOf[1].Payload.prefill.*.source`	`string ["saved","booking"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.memoryRevisions`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.memoryRevisions.*`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.canAnswer`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.canCancel`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.canAttach`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.isCustomer`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.sales[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].BidID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].AppointmentID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].TransactionCompletedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName`		`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.sales[].LocationName.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/get_request",
    "RequestUserAlias": "example-user",
    "Payload": {
        "request": {
            "id": 0,
            "revision": 0,
            "customerID": 0,
            "sellerID": 0,
            "chatID": 0,
            "bidID": 0,
            "transactionID": 0,
            "title": "synthetic-example",
            "status": "sent",
            "submittedDate": "synthetic-example",
            "url": "synthetic-example"
        },
        "title": "synthetic-example",
        "introduction": "synthetic-example",
        "questions": [],
        "history": [],
        "draft": {
            "id": 0,
            "revision": 0,
            "submittedDate": "synthetic-example",
            "answers": []
        },
        "prefill": [],
        "memoryRevisions": [],
        "canAnswer": false,
        "canCancel": false,
        "canAttach": false,
        "isCustomer": false,
        "sales": []
    }
}

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

GET

/v1/customer_survey/get_requests

#

List only questionnaires sent or received by the acting user. Context filters never widen that access.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`customerID`	`int`	`لا`	`0`	Filter recipient.
`transactionID`	`int`	`لا`	`0`	Filter a sale, including surveys for its bid and same original pair.
`bidID`	`int`	`لا`	`0`	Filter bid.
`beforeID`	`int`	`لا`	`0`	Pagination cursor.
`sentOnly`	`bool`	`لا`	`false`	Seller dashboard filter.
`completedOnly`	`bool`	`لا`	`false`	Only requests with a submitted response; excludes unanswered requests and private drafts.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/customer_survey/get_requests' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'customerID={{customerID}}' \
  --data-urlencode 'transactionID={{transactionID}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'beforeID={{beforeID}}' \
  --data-urlencode 'sentOnly={{sentOnly}}' \
  --data-urlencode 'completedOnly={{completedOnly}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب	الوصف
`$`	`customer_survey_get_requests_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.items`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.items[].id`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].customerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].sellerID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].chatID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].bidID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].transactionID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].status`	`string ["sent","in_progress","submitted","cancelled"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].submittedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.items[].submittedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].submittedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].url`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.items[].buyerIdentityHidden`	`boolean`	`لا`	True when the authenticated viewer cannot see the buyer during the current response race.
`$.oneOf[0].allOf[1].Payload.items[].buyerIdentityHiddenUntil`	`integer \| null`	`لا`	Saved current-round ClosesAt as Unix seconds; null when identity is visible. Reveal is authoritative only on a new response.
`$.oneOf[0].allOf[1].Payload.hasMore`	`boolean`	`نعم`
`$.oneOf[0].allOf[1].Payload.beforeID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/get_requests",
    "RequestUserAlias": "example-user",
    "Payload": {
        "items": [],
        "hasMore": false,
        "beforeID": 0
    }
}

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

GET

/v1/customer_survey/get_template

#

Read a versioned AT or seller-owned template for preview/edit/copy.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`templateID`	`int`	`نعم`	`—`	Template identifier.

مثال طلب (cURL)

curl --get \
  'https://ar.appointmenttrader.com/v1/customer_survey/get_template' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'templateID={{templateID}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب	الوصف
`$`	`customer_survey_get_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`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.CreatedDate`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.OwnerUserID`		`نعم`
`$.oneOf[0].allOf[1].Payload.OwnerUserID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.OwnerUserID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.OwnerUserID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.OwnerUserID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.StarterKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.StarterKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.StarterKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.SourceTemplateID`		`نعم`
`$.oneOf[0].allOf[1].Payload.SourceTemplateID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.SourceTemplateID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.SourceTemplateID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.SourceTemplateID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.CurrentVersionID`		`نعم`
`$.oneOf[0].allOf[1].Payload.CurrentVersionID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.CurrentVersionID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.CurrentVersionID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.CurrentVersionID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.ArchivedDate`		`نعم`
`$.oneOf[0].allOf[1].Payload.ArchivedDate.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.ArchivedDate.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.Title`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.TitleKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.TitleKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.TitleKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.VersionNumber`		`نعم`
`$.oneOf[0].allOf[1].Payload.VersionNumber.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.VersionNumber.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.VersionNumber.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.VersionNumber.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.Introduction`		`نعم`
`$.oneOf[0].allOf[1].Payload.Introduction.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.Introduction.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].VersionID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].VersionID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].VersionID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].QuestionKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].HelpText`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldType`	`string ["text","number","boolean","single_select","multi_select","longtext"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Required`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Required.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Required.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].SortOrder.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON`	`string (application/json)`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON`	`SurveyValidation (JSON بعد فك الترميز)`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].maxLength`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].integer`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].min`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[0].max`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].ValidationJSON.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldOwnerUserID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope.anyOf[0]`	`string ["customer","booking"]`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].ValueScope.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].FieldKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation`	`SurveyValidation`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0]`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].maxLength`	`integer`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].integer`	`boolean`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].min`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[0].max`	`number`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].validation.anyOf[1]`	`= []`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options`	`array`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[]`	`object`	`لا`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].ID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].QuestionID.oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0]`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0].oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[0].oneOf[1]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].FieldOptionID.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].OptionKey`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].Label`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey`		`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey.anyOf[0]`	`string`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].LabelKey.anyOf[1]`	`null`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder`	`DatabaseInteger`	`نعم`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder.oneOf[0]`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.questions[].Options[].SortOrder.oneOf[1]`	`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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/get_template",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ID": 0,
        "CreatedDate": "synthetic-example",
        "OwnerUserID": 0,
        "StarterKey": "synthetic-example",
        "SourceTemplateID": 0,
        "CurrentVersionID": 0,
        "ArchivedDate": "synthetic-example",
        "Title": "synthetic-example",
        "TitleKey": "synthetic-example",
        "VersionNumber": 0,
        "Introduction": "synthetic-example",
        "questions": []
    }
}

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

POST

/v1/customer_survey/set_attach

#

Attach a customer/bid questionnaire to a completed sale between its original seller and customer. Existing sale links cannot be moved.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`requestID`	`int`	`نعم`	`—`	Questionnaire identifier.
`transactionID`	`int`	`نعم`	`—`	Completed sale identifier.
`expectedRevision`	`int`	`نعم`	`—`	Last observed request revision.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_attach' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'requestID={{requestID}}' \
  --data-urlencode 'transactionID={{transactionID}}' \
  --data-urlencode 'expectedRevision={{expectedRevision}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_attach_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.requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_attach",
    "RequestUserAlias": "example-user",
    "Payload": {
        "requestID": 0,
        "chatID": 0
    }
}

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

POST

/v1/customer_survey/set_cancel

#

Cancel an unanswered questionnaire as its sending seller.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`requestID`	`int`	`نعم`	`—`	Questionnaire identifier.
`expectedRevision`	`int`	`نعم`	`—`	Last observed request revision.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'requestID={{requestID}}' \
  --data-urlencode 'expectedRevision={{expectedRevision}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_cancel_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.requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_cancel",
    "RequestUserAlias": "example-user",
    "Payload": {
        "requestID": 0,
        "chatID": 0
    }
}

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

POST

/v1/customer_survey/set_draft

#

Save a customer-only draft. Drafts never update seller CRM or remembered values.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`dataJSON`	`string`	`نعم`	`—`	UTF-8 JSON object, preferably encoded as base64url: followed by unpadded URL-safe base64 to preserve authored text. Object: requestID, expectedRevision, operationKey, answers keyed by question ID, memoryRevisions keyed by field ID. Null means unanswered; false and zero are answers.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_draft' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'dataJSON={{dataJSON}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

المعلمات: dataJSON

الحقل	النوع	مطلوب	الوصف
`dataJSON`	`string (application/json)`	`نعم`
`dataJSON`	`object (JSON بعد فك الترميز)`	`نعم`
`dataJSON.requestID`	`integer`	`نعم`
`dataJSON.operationKey`	`string`	`نعم`
`dataJSON.expectedRevision`	`integer`	`نعم`
`dataJSON.answers`	`object`	`نعم`
`dataJSON.answers.*`	`SurveyAnswerValue`	`لا`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`dataJSON.answers.*.anyOf[0]`	`null`	`لا`
`dataJSON.answers.*.anyOf[1]`	`string`	`لا`
`dataJSON.answers.*.anyOf[2]`	`number`	`لا`
`dataJSON.answers.*.anyOf[3]`	`boolean`	`لا`
`dataJSON.answers.*.anyOf[4]`	`array`	`لا`
`dataJSON.answers.*.anyOf[4][]`	`string`	`لا`
`dataJSON.memoryRevisions`	`object`	`نعم`
`dataJSON.memoryRevisions.*`	`integer`	`لا`

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_draft_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.requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`لا`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_draft",
    "RequestUserAlias": "example-user",
    "Payload": {
        "requestID": 0,
        "revision": 0
    }
}

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

POST

/v1/customer_survey/set_forget

#

Forget an own remembered value for future prefills. Existing seller-shared submissions remain unchanged.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`fieldID`	`int`	`نعم`	`—`	Remembered field identifier.
`expectedRevision`	`int`	`نعم`	`—`	Memory revision returned by get_customer_fields.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_forget' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'fieldID={{fieldID}}' \
  --data-urlencode 'expectedRevision={{expectedRevision}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_forget_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.fieldID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_forget",
    "RequestUserAlias": "example-user",
    "Payload": {
        "fieldID": 0
    }
}

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

POST

/v1/customer_survey/set_send

#

Send one questionnaire to the server-resolved customer in an accepted chat. Reuse operationKey for retries only. Active bid selection pauses incoming questionnaires unless the sender has GlobalCommunityAdministration; ErrorReason=active_bid_selection.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`dataJSON`	`string`	`نعم`	`—`	UTF-8 JSON object, preferably encoded as base64url: followed by unpadded URL-safe base64 to preserve authored text. Object: chatID, templateID, versionID, transactionID (optional), operationKey (16-80 ASCII letters/digits/hyphens/underscores).
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_send' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'dataJSON={{dataJSON}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

المعلمات: dataJSON

الحقل	النوع	مطلوب
`dataJSON`	`string (application/json)`	`نعم`
`dataJSON`	`object (JSON بعد فك الترميز)`	`نعم`
`dataJSON.chatID`	`integer`	`نعم`
`dataJSON.templateID`	`integer`	`نعم`
`dataJSON.versionID`	`integer`	`نعم`
`dataJSON.transactionID`	`integer`	`لا`
`dataJSON.operationKey`	`string`	`نعم`

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_send_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.requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`لا`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_send",
    "RequestUserAlias": "example-user",
    "Payload": {
        "requestID": 0
    }
}

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

POST

/v1/customer_survey/set_submit

#

Confirm and share a new immutable response revision with this seller. Also updates customer memory and this seller's CRM pointers atomically.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`dataJSON`	`string`	`نعم`	`—`	UTF-8 JSON object, preferably encoded with the base64url: prefix. Same object as /v1/customer_survey/set_draft; required answers and memory revisions are enforced.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm customer sharing.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_submit' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'dataJSON={{dataJSON}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

المعلمات: dataJSON

الحقل	النوع	مطلوب	الوصف
`dataJSON`	`string (application/json)`	`نعم`
`dataJSON`	`object (JSON بعد فك الترميز)`	`نعم`
`dataJSON.requestID`	`integer`	`نعم`
`dataJSON.operationKey`	`string`	`نعم`
`dataJSON.expectedRevision`	`integer`	`نعم`
`dataJSON.answers`	`object`	`نعم`
`dataJSON.answers.*`	`SurveyAnswerValue`	`لا`	Value follows the question type: text or selected key, decimal numeric string, boolean, selected-key list, or null when unanswered.
`dataJSON.answers.*.anyOf[0]`	`null`	`لا`
`dataJSON.answers.*.anyOf[1]`	`string`	`لا`
`dataJSON.answers.*.anyOf[2]`	`number`	`لا`
`dataJSON.answers.*.anyOf[3]`	`boolean`	`لا`
`dataJSON.answers.*.anyOf[4]`	`array`	`لا`
`dataJSON.answers.*.anyOf[4][]`	`string`	`لا`
`dataJSON.memoryRevisions`	`object`	`نعم`
`dataJSON.memoryRevisions.*`	`integer`	`لا`

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_submit_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.requestID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.revision`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.chatID`	`integer`	`لا`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_submit",
    "RequestUserAlias": "example-user",
    "Payload": {
        "requestID": 0,
        "revision": 0
    }
}

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

POST

/v1/customer_survey/set_template

#

Create or append an immutable template version. A system-field ID owns type, label and options; clients cannot redefine them. Answer types: text (single-line input), longtext (multiline textarea), number, boolean, single_select, multi_select. Both text types preserve nonblank string values up to 4000 characters by default; empty or whitespace-only text is unanswered.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`dataJSON`	`string`	`نعم`	`—`	UTF-8 JSON object, preferably encoded as base64url: followed by unpadded URL-safe base64 to preserve authored text. Object: templateID (zero creates), expectedVersionID, sourceTemplateID, title, introduction, questions [{fieldID, label, help, type, required, remember, integer, min, max, options:[{key,label}]}].
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_template' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'dataJSON={{dataJSON}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

المعلمات: dataJSON

الحقل	النوع	مطلوب	الوصف
`dataJSON`	`string (application/json)`	`نعم`
`dataJSON`	`object (JSON بعد فك الترميز)`	`نعم`
`dataJSON.title`	`string`	`نعم`
`dataJSON.introduction`	`string`	`لا`
`dataJSON.templateID`	`integer`	`لا`
`dataJSON.sourceTemplateID`	`integer`	`لا`
`dataJSON.expectedVersionID`	`integer`	`لا`
`dataJSON.questions`	`array`	`نعم`
`dataJSON.questions[]`		`لا`
`dataJSON.questions[].anyOf[0]`	`object`	`لا`
`dataJSON.questions[].anyOf[0].fieldID`	`integer`	`نعم`
`dataJSON.questions[].anyOf[0].label`	`string`	`لا`
`dataJSON.questions[].anyOf[0].type`	`string ["text","longtext","number","boolean","single_select","multi_select"]`	`لا`
`dataJSON.questions[].anyOf[0].help`	`string`	`لا`
`dataJSON.questions[].anyOf[0].required`	`boolean`	`لا`
`dataJSON.questions[].anyOf[0].remember`	`boolean`	`لا`
`dataJSON.questions[].anyOf[0].integer`	`boolean`	`لا`
`dataJSON.questions[].anyOf[0].min`	`DatabaseNumber`	`لا`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`dataJSON.questions[].anyOf[0].min.oneOf[0]`	`number`	`لا`
`dataJSON.questions[].anyOf[0].min.oneOf[1]`	`string`	`لا`
`dataJSON.questions[].anyOf[0].max`	`DatabaseNumber`	`لا`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`dataJSON.questions[].anyOf[0].max.oneOf[0]`	`number`	`لا`
`dataJSON.questions[].anyOf[0].max.oneOf[1]`	`string`	`لا`
`dataJSON.questions[].anyOf[0].options`	`array`	`لا`
`dataJSON.questions[].anyOf[0].options[]`	`object`	`لا`
`dataJSON.questions[].anyOf[0].options[].key`	`string`	`لا`
`dataJSON.questions[].anyOf[0].options[].label`	`string`	`نعم`
`dataJSON.questions[].anyOf[1]`	`object`	`لا`
`dataJSON.questions[].anyOf[1].fieldID`	`integer`	`لا`
`dataJSON.questions[].anyOf[1].label`	`string`	`نعم`
`dataJSON.questions[].anyOf[1].type`	`string ["text","longtext","number","boolean","single_select","multi_select"]`	`نعم`
`dataJSON.questions[].anyOf[1].help`	`string`	`لا`
`dataJSON.questions[].anyOf[1].required`	`boolean`	`لا`
`dataJSON.questions[].anyOf[1].remember`	`boolean`	`لا`
`dataJSON.questions[].anyOf[1].integer`	`boolean`	`لا`
`dataJSON.questions[].anyOf[1].min`	`DatabaseNumber`	`لا`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`dataJSON.questions[].anyOf[1].min.oneOf[0]`	`number`	`لا`
`dataJSON.questions[].anyOf[1].min.oneOf[1]`	`string`	`لا`
`dataJSON.questions[].anyOf[1].max`	`DatabaseNumber`	`لا`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`dataJSON.questions[].anyOf[1].max.oneOf[0]`	`number`	`لا`
`dataJSON.questions[].anyOf[1].max.oneOf[1]`	`string`	`لا`
`dataJSON.questions[].anyOf[1].options`	`array`	`لا`
`dataJSON.questions[].anyOf[1].options[]`	`object`	`لا`
`dataJSON.questions[].anyOf[1].options[].key`	`string`	`لا`
`dataJSON.questions[].anyOf[1].options[].label`	`string`	`نعم`

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_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`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.templateID`	`integer`	`نعم`
`$.oneOf[0].allOf[1].Payload.versionID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_template",
    "RequestUserAlias": "example-user",
    "Payload": {
        "templateID": 0,
        "versionID": 0
    }
}

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

POST

/v1/customer_survey/set_template_archive

#

Archive an owned template without changing sent questionnaires.

المعلمات

الاسم	النوع	مطلوب	الافتراضي	الوصف
`templateID`	`int`	`نعم`	`—`	Template identifier.
`expectedVersionID`	`int`	`نعم`	`—`	Last observed current version ID.
`isWritingRequest`	`bool`	`لا`	`false`	Confirm write.

مثال طلب (cURL)

curl --request POST \
  'https://ar.appointmenttrader.com/v1/customer_survey/set_template_archive' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'templateID={{templateID}}' \
  --data-urlencode 'expectedVersionID={{expectedVersionID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

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

JSON

See the shared response schema and synthetic example.

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

الحقل	النوع	مطلوب
`$`	`customer_survey_set_template_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`	`object`	`نعم`
`$.oneOf[0].allOf[1].Payload.templateID`	`integer`	`نعم`
`$.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`	`لا`
`$.oneOf[1].ErrorReason`	`string ["active_bid_selection","chat_permission_unavailable"]`	`لا`

مثال استجابة

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/customer_survey/set_template_archive",
    "RequestUserAlias": "example-user",
    "Payload": {
        "templateID": 0
    }
}

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