מדריך API של checkout | AppointmentTrader

חיפוש בכל נקודות הקצה

/v1/checkout/

GET

/v1/checkout/get_context

Public-by-design: same-origin guest payment preparation uses a session-bound anti-forgery token.

דוגמת בקשה (cURL)

curl --get \
  'https://he.appointmenttrader.com/v1/checkout/get_context' \
  --data-urlencode 'key={{API_KEY}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`checkout_get_context_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.csrf`	`string`	`כן`	Opaque anti-forgery token bound to the browser session. Synthetic examples never contain a usable token.
`$.oneOf[0].allOf[1].Payload.settings`	`object`	`כן`
`$.oneOf[0].allOf[1].Payload.settings.listing`	`boolean`	`כן`
`$.oneOf[0].allOf[1].Payload.settings.bid`	`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/checkout/get_context",
    "RequestUserAlias": "example-user",
    "Payload": {
        "csrf": "FAKE_CSRF_TOKEN",
        "settings": {
            "listing": false,
            "bid": false
        }
    }
}

תיעוד נקודת קצה קריא למכונה

GET

/v1/checkout/get_status

Public-by-design: only the originating browser or verified intended buyer can read this attempt.

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`attempt`	`string`	`כן`	`—`	Opaque checkout attempt.

דוגמת בקשה (cURL)

curl --get \
  'https://he.appointmenttrader.com/v1/checkout/get_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה
`$`	`checkout_get_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.attempt`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`כן`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.state`	`string ["prepared","authorized","completing","completed","canceling","canceled","expired","recovery"]`	`כן`
`$.oneOf[0].allOf[1].Payload.paymentState`		`כן`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[0]`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`כן`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[1]`	`null`	`כן`
`$.oneOf[0].allOf[1].Payload.resultURL`		`כן`
`$.oneOf[0].allOf[1].Payload.resultURL.anyOf[0]`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.resultURL.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/checkout/get_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "state": "prepared",
        "paymentState": "requires_payment_method",
        "resultURL": "synthetic-example"
    }
}

תיעוד נקודת קצה קריא למכונה

POST

/v1/checkout/set_cancel

Public-by-design: cancellation requires the originating browser's token and attempt ownership.

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`attempt`	`string`	`כן`	`—`	Opaque checkout attempt.
`csrf`	`string`	`כן`	`—`	Browser token from get_context. POST required.

דוגמת בקשה (cURL)

curl --request POST \
  'https://he.appointmenttrader.com/v1/checkout/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}' \
  --data-urlencode 'csrf={{csrf}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

שדות התגובה

שדה	סוג	חובה
`$`	`checkout_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`	`= 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/checkout/set_cancel",
    "RequestUserAlias": "example-user",
    "Payload": true
}

תיעוד נקודת קצה קריא למכונה

POST

/v1/checkout/set_prepare

Public-by-design: prepares a session-owned manual-capture payment; never purchases or creates a bid.

פרמטרים

שם	סוג	חובה	ברירת מחדל	תיאור
`payloadJSON`	`string`	`כן`	`—`	Listing UUID or canonical composer checkout fields and the selected reward.
`requestKey`	`string`	`כן`	`—`	Random 64-character hexadecimal retry identity.
`csrf`	`string`	`כן`	`—`	Browser token from get_context. POST required.

דוגמת בקשה (cURL)

curl --request POST \
  'https://he.appointmenttrader.com/v1/checkout/set_prepare' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'payloadJSON={{payloadJSON}}' \
  --data-urlencode 'requestKey={{requestKey}}' \
  --data-urlencode 'csrf={{csrf}}'

ערך מוחזר

JSON

See the shared response schema and synthetic example.

פרמטרים: payloadJSON

שדה	סוג	חובה	תיאור
`payloadJSON`	`string (application/json)`	`כן`
`payloadJSON`	`GuestCheckoutPrepareInput (JSON מפוענח)`	`כן`
`payloadJSON.oneOf[0]`	`object`	`כן`
`payloadJSON.oneOf[0].listingUUID`	`string`	`כן`
`payloadJSON.oneOf[0].expectedAmount`	`integer`	`כן`
`payloadJSON.oneOf[1]`	`object`	`כן`	Canonical fields must match the session-owned frozen composer snapshot. composersnapshot is an opaque token, not serialized request content. expectedAmount is the displayed total in USD cents; bidamount is the displayed principal in the active currency. Unknown fields are discarded.
`payloadJSON.oneOf[1].lid`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].lid.oneOf[0]`	`integer`	`כן`
`payloadJSON.oneOf[1].lid.oneOf[1]`	`string`	`כן`
`payloadJSON.oneOf[1].inventorytypeid`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].inventorytypeid.oneOf[0]`	`integer`	`כן`
`payloadJSON.oneOf[1].inventorytypeid.oneOf[1]`	`string`	`כן`
`payloadJSON.oneOf[1].unit`	`DatabaseInteger`	`כן`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].unit.oneOf[0]`	`integer`	`כן`
`payloadJSON.oneOf[1].unit.oneOf[1]`	`string`	`כן`
`payloadJSON.oneOf[1].bidamount`	`DatabaseNumber`	`כן`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`payloadJSON.oneOf[1].bidamount.oneOf[0]`	`number`	`כן`
`payloadJSON.oneOf[1].bidamount.oneOf[1]`	`string`	`כן`
`payloadJSON.oneOf[1].startdate`	`string`	`כן`
`payloadJSON.oneOf[1].enddate`	`string`	`כן`
`payloadJSON.oneOf[1].starttime`	`string`	`לא`
`payloadJSON.oneOf[1].enddtime`	`string`	`לא`
`payloadJSON.oneOf[1].exactstarttime`	`string`	`כן`
`payloadJSON.oneOf[1].exactendtime`	`string`	`כן`
`payloadJSON.oneOf[1].cuidl`	`string`	`לא`
`payloadJSON.oneOf[1].composersnapshot`	`string`	`כן`
`payloadJSON.oneOf[1].atv2ComposerDraftInstanceKey`	`string`	`לא`
`payloadJSON.oneOf[1].atv2ComposerDraftViewerKey`	`string`	`לא`
`payloadJSON.oneOf[1].urid`	`DatabaseInteger`	`לא`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].urid.oneOf[0]`	`integer`	`לא`
`payloadJSON.oneOf[1].urid.oneOf[1]`	`string`	`לא`
`payloadJSON.oneOf[1].composerurid`	`DatabaseInteger`	`לא`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].composerurid.oneOf[0]`	`integer`	`לא`
`payloadJSON.oneOf[1].composerurid.oneOf[1]`	`string`	`לא`
`payloadJSON.oneOf[1].premiumbid`		`לא`	Presence selects the premium fee; omit entirely for standard pricing.
`payloadJSON.oneOf[1].premiumbid.anyOf[0]`	`string`	`לא`
`payloadJSON.oneOf[1].premiumbid.anyOf[1]`	`boolean`	`לא`
`payloadJSON.oneOf[1].premiumbid.anyOf[2]`	`integer`	`לא`
`payloadJSON.oneOf[1].expectedAmount`	`integer`	`כן`

שדות התגובה

שדה	סוג	חובה	תיאור
`$`	`checkout_set_prepare_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.attempt`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`כן`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`כן`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.clientSecret`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.paymentIntentID`	`string`	`כן`
`$.oneOf[0].allOf[1].Payload.paymentState`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`כן`
`$.oneOf[0].allOf[1].Payload.amount`	`integer`	`כן`	Total payable USD cents including the applicable publishing fee.
`$.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/checkout/set_prepare",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "clientSecret": "pi_FAKE_secret_PLACEHOLDER",
        "paymentIntentID": "pi_FAKE",
        "paymentState": "requires_payment_method",
        "amount": 0
    }
}

תיעוד נקודת קצה קריא למכונה