Riferimento API auction | AppointmentTrader

Cerca in tutti gli endpoint

/v1/auction/

GET

/v1/auction/get_bid_status

Read one checkout attempt belonging to the acting buyer, including pending funding.

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`bidID`	`int`	`Sì`	`—`	Auction bid ID returned by /v1/auction/set_bid_checkout.

Esempio di richiesta (cURL)

curl --get \
  'https://it.appointmenttrader.com/v1/auction/get_bid_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'bidID={{bidID}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio	Descrizione
`$`	`auction_get_bid_status_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload.bidID`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.amountCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.status`	`string ["PendingFunding","Leading","Outbid","Won","Returned"]`	`Sì`
`$.oneOf[0].allOf[1].Payload.buyerIdentityHidden`	`boolean`	`No`	Response projection adds this flag when a bid context is present; true hides the buyer while any of their qualifying response races is open.
`$.oneOf[0].allOf[1].Payload.buyerIdentityHiddenUntil`	`integer \| null`	`No`	Latest saved closing timestamp among the buyer's qualifying open response races, in Unix seconds, or null when identity is visible.
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auction/get_bid_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "bidID": 0,
        "listingID": "synthetic-example",
        "amountCents": 0,
        "status": "PendingFunding"
    }
}

Documentazione dell’endpoint leggibile dalle macchine

GET

/v1/auction/get_detail

Public-by-design: public auction information excludes reservation secrets, bidder identities and funding records.

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`listingID`	`string`	`Sì`	`—`	Listing UUID.

Esempio di richiesta (cURL)

curl --get \
  'https://it.appointmenttrader.com/v1/auction/get_detail' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio
`$`	`auction_get_detail_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.locationName`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.imageUrl`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.inventoryTypeName`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.timezone`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.statusLabel`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.cardPriceLabel`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.cardSummary`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.url`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.auctionID`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.startingPriceCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.currentBidCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.minimumNextBidCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.bidCount`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.revision`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.isOpen`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.isLeading`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canAdministrativelyCancel`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canBid`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canManage`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.isSeller`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart`		`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime`		`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt`		`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL`		`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.saleMode`	`string ["FixedPrice","Auction"]`	`Sì`
`$.oneOf[0].allOf[1].Payload.status`	`string ["PendingApproval","Open","Settling","Sold","Unsold","Cancelled"]`	`Sì`
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auction/get_detail",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "locationName": "synthetic-example",
        "imageUrl": "synthetic-example",
        "inventoryTypeName": "synthetic-example",
        "timezone": "synthetic-example",
        "statusLabel": "synthetic-example",
        "cardPriceLabel": "synthetic-example",
        "cardSummary": "synthetic-example",
        "url": "synthetic-example",
        "auctionID": 0,
        "startingPriceCents": 0,
        "currentBidCents": 0,
        "minimumNextBidCents": 0,
        "bidCount": 0,
        "revision": 0,
        "isOpen": false,
        "isLeading": false,
        "canAdministrativelyCancel": false,
        "canBid": false,
        "canManage": false,
        "isSeller": false,
        "listingStart": "synthetic-example",
        "serverTime": "synthetic-example",
        "endsAt": "synthetic-example",
        "purchaseURL": "synthetic-example",
        "saleMode": "FixedPrice",
        "status": "PendingApproval"
    }
}

Documentazione dell’endpoint leggibile dalle macchine

GET

/v1/auction/get_my_bids

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`pageNumber`	`int`	`No`	`1`	One-based page number.
`activeOnly`	`bool`	`No`	`false`	Only the latest participation per open or settling auction.

Esempio di richiesta (cURL)

curl --get \
  'https://it.appointmenttrader.com/v1/auction/get_my_bids' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'pageNumber={{pageNumber}}' \
  --data-urlencode 'activeOnly={{activeOnly}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio	Descrizione
`$`	`auction_get_my_bids_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`array`	`Sì`
`$.oneOf[0].allOf[1].Payload[]`	`object`	`No`
`$.oneOf[0].allOf[1].Payload[].ID`	`DatabaseInteger`	`Sì`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload[].ID.oneOf[0]`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ID.oneOf[1]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ATListingAuctions_ID`	`DatabaseInteger`	`Sì`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload[].ATListingAuctions_ID.oneOf[0]`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ATListingAuctions_ID.oneOf[1]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].AmountCents`	`DatabaseInteger`	`Sì`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload[].AmountCents.oneOf[0]`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload[].AmountCents.oneOf[1]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].Status`	`string ["Leading","Outbid","Won","Returned"]`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ReturnLedger_ID`		`Sì`
`$.oneOf[0].allOf[1].Payload[].ReturnLedger_ID.anyOf[0]`	`DatabaseInteger`	`Sì`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload[].ReturnLedger_ID.anyOf[0].oneOf[0]`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ReturnLedger_ID.anyOf[0].oneOf[1]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ReturnLedger_ID.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ATAppointment_ID`	`DatabaseInteger`	`Sì`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`$.oneOf[0].allOf[1].Payload[].ATAppointment_ID.oneOf[0]`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ATAppointment_ID.oneOf[1]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].AuctionStatus`	`string ["PendingApproval","Open","Settling","Sold","Unsold","Cancelled"]`	`Sì`
`$.oneOf[0].allOf[1].Payload[].EndsAt`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].ListingUUID`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload[].LocationName`	`string`	`Sì`
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

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

Documentazione dell’endpoint leggibile dalle macchine

POST

/v1/auction/set_bid_checkout

Prepare a funded auction bid. Opening checkout does not reserve inventory or extend the deadline.

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`listingID`	`string`	`Sì`	`—`	Listing UUID.
`amountCents`	`int`	`Sì`	`—`	Bid in USD cents.
`requestID`	`string`	`Sì`	`—`	Unique 16-64 character retry identifier.
`isWritingRequest`	`bool`	`No`	`false`	Explicit writing guard.

Esempio di richiesta (cURL)

curl --request POST \
  'https://it.appointmenttrader.com/v1/auction/set_bid_checkout' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'amountCents={{amountCents}}' \
  --data-urlencode 'requestID={{requestID}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio	Descrizione
`$`	`auction_set_bid_checkout_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload.checkoutURL`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.bidID`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.buyerIdentityHidden`	`boolean`	`No`	Response projection adds this flag when a bid context is present; true hides the buyer while any of their qualifying response races is open.
`$.oneOf[0].allOf[1].Payload.buyerIdentityHiddenUntil`	`integer \| null`	`No`	Latest saved closing timestamp among the buyer's qualifying open response races, in Unix seconds, or null when identity is visible.
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auction/set_bid_checkout",
    "RequestUserAlias": "example-user",
    "Payload": {
        "checkoutURL": "/modules/bid/bid.php?customarticle=auctionbid&parameters=FAKE_CHECKOUT_TOKEN&donotapply&inline",
        "bidID": 1001
    }
}

Documentazione dell’endpoint leggibile dalle macchine

POST

/v1/auction/set_cancel

Cancel a bid-free owned auction, or administratively cancel invalid inventory and return deposits.

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`listingID`	`string`	`Sì`	`—`	Listing UUID.
`administrative`	`bool`	`No`	`false`	Requires listing approval permission.
`isWritingRequest`	`bool`	`No`	`false`	Explicit writing guard.

Esempio di richiesta (cURL)

curl --request POST \
  'https://it.appointmenttrader.com/v1/auction/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'administrative={{administrative}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio
`$`	`auction_set_cancel_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`= true`	`Sì`
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

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

Documentazione dell’endpoint leggibile dalle macchine

POST

/v1/auction/set_save

Configure an owned listing's sale format before its first funded bid.

Parametri

Nome	Tipo	Obbligatorio	Predefinito	Descrizione
`listingID`	`string`	`Sì`	`—`	Listing UUID.
`startingPriceCents`	`int`	`Sì`	`—`	Starting price in USD cents.
`endsAt`	`string`	`No`	`""`	ISO timestamp with offset, or venue-local date and time. Empty defaults to 24 hours capped at listing start.
`saleMode`	`string`	`No`	`"Auction"`	Auction or FixedPrice.
`isWritingRequest`	`bool`	`No`	`false`	Explicit writing guard.

Esempio di richiesta (cURL)

curl --request POST \
  'https://it.appointmenttrader.com/v1/auction/set_save' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'listingID={{listingID}}' \
  --data-urlencode 'startingPriceCents={{startingPriceCents}}' \
  --data-urlencode 'endsAt={{endsAt}}' \
  --data-urlencode 'saleMode={{saleMode}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Risposta

JSON

See the shared response schema and synthetic example.

Campi della risposta

Campo	Tipo	Obbligatorio
`$`	`auction_set_save_Response`	`Sì`
`$.oneOf[0]`		`Sì`
`$.oneOf[0].allOf[0]`	`object`	`Sì`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`Sì`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`Sì`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`Sì`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`No`
`$.oneOf[0].allOf[1]`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload`	`object`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingID`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.locationName`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.imageUrl`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.inventoryTypeName`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.timezone`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.statusLabel`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.cardPriceLabel`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.cardSummary`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.url`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.auctionID`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.startingPriceCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.currentBidCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.minimumNextBidCents`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.bidCount`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.revision`	`integer`	`Sì`
`$.oneOf[0].allOf[1].Payload.isOpen`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.isLeading`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canAdministrativelyCancel`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canBid`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.canManage`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.isSeller`	`boolean`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart`		`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.listingStart.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime`		`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.serverTime.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt`		`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.endsAt.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL`		`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL.anyOf[0]`	`string`	`Sì`
`$.oneOf[0].allOf[1].Payload.purchaseURL.anyOf[1]`	`null`	`Sì`
`$.oneOf[0].allOf[1].Payload.saleMode`	`string ["FixedPrice","Auction"]`	`Sì`
`$.oneOf[0].allOf[1].Payload.status`	`string ["PendingApproval","Open","Settling","Sold","Unsold","Cancelled"]`	`Sì`
`$.oneOf[1]`	`object`	`Sì`
`$.oneOf[1].RequestUserAlias`	`string`	`Sì`
`$.oneOf[1].RequestPath`	`string \| null`	`Sì`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`Sì`
`$.oneOf[1].ResponseCode`	`integer`	`Sì`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`No`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`Sì`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`No`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`No`

Esempio di risposta

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/auction/set_save",
    "RequestUserAlias": "example-user",
    "Payload": {
        "listingID": "synthetic-example",
        "locationName": "synthetic-example",
        "imageUrl": "synthetic-example",
        "inventoryTypeName": "synthetic-example",
        "timezone": "synthetic-example",
        "statusLabel": "synthetic-example",
        "cardPriceLabel": "synthetic-example",
        "cardSummary": "synthetic-example",
        "url": "synthetic-example",
        "auctionID": 0,
        "startingPriceCents": 0,
        "currentBidCents": 0,
        "minimumNextBidCents": 0,
        "bidCount": 0,
        "revision": 0,
        "isOpen": false,
        "isLeading": false,
        "canAdministrativelyCancel": false,
        "canBid": false,
        "canManage": false,
        "isSeller": false,
        "listingStart": "synthetic-example",
        "serverTime": "synthetic-example",
        "endsAt": "synthetic-example",
        "purchaseURL": "synthetic-example",
        "saleMode": "FixedPrice",
        "status": "PendingApproval"
    }
}

Documentazione dell’endpoint leggibile dalle macchine