AT AppointmentTrader
Giriş yap
Şu an çevrimiçi  

/v1/bidauction/

GET

/v1/bidauction/get_list

#
Visible paid live auctions, with the acting seller's accepted participation first, then earliest closing. Includes finalizing rounds. Returns 25 cards per page, serverTime, page and total. No competitor identities.

Parametreler

AdTürGerekliVarsayılanAçıklama
page int HAYIR 1 One-based page number.
İstek örneği (cURL) 
curl --get \
  'https://tr.appointmenttrader.com/v1/bidauction/get_list' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'page={{page}}'

Dönen değer

JSON
See the shared response schema and synthetic example.
Yanıt alanları
AlanTürGerekliAçıklama
$bidauction_get_list_Response Evet
$.oneOf[0] Evet
$.oneOf[0].allOf[0]object Evet
$.oneOf[0].allOf[0].RequestUserAliasstring Evet
$.oneOf[0].allOf[0].RequestPathstring | null Evet
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Evet
$.oneOf[0].allOf[0].ResponseCodeinteger Evet
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring HAYIR
$.oneOf[0].allOf[1]object Evet
$.oneOf[0].allOf[1].Payloadobject Evet
$.oneOf[0].allOf[1].Payload.itemsarray Evet
$.oneOf[0].allOf[1].Payload.items[]object HAYIR
$.oneOf[0].allOf[1].Payload.items[].roundIDinteger Evet
$.oneOf[0].allOf[1].Payload.items[].bidIDinteger Evet
$.oneOf[0].allOf[1].Payload.items[].venuestring Evet
$.oneOf[0].allOf[1].Payload.items[].requeststring Evet
$.oneOf[0].allOf[1].Payload.items[].startTimestring Evet
$.oneOf[0].allOf[1].Payload.items[].endTimestring Evet
$.oneOf[0].allOf[1].Payload.items[].bidAmountCentsinteger Evet
$.oneOf[0].allOf[1].Payload.items[].leadingCentsinteger Evet
$.oneOf[0].allOf[1].Payload.items[].nextCentsinteger Evet
$.oneOf[0].allOf[1].Payload.items[].closesAtinteger Evet
$.oneOf[0].allOf[1].Payload.items[].participatingboolean Evet
$.oneOf[0].allOf[1].Payload.items[].leadingboolean Evet
$.oneOf[0].allOf[1].Payload.items[].ownOffersarray Evet
$.oneOf[0].allOf[1].Payload.items[].ownOffers[]object HAYIR
$.oneOf[0].allOf[1].Payload.items[].ownOffers[].idinteger Evet
$.oneOf[0].allOf[1].Payload.items[].ownOffers[].amountCentsinteger Evet
$.oneOf[0].allOf[1].Payload.items[].ownOffers[].statestring Evet
$.oneOf[0].allOf[1].Payload.items[].ownOffers[].refundCentsinteger Evet
$.oneOf[0].allOf[1].Payload.items[].buyerIdentityHiddenboolean HAYIRTrue when the authenticated viewer cannot see the buyer during the current response race.
$.oneOf[0].allOf[1].Payload.items[].buyerIdentityHiddenUntilinteger | null HAYIRSaved current-round ClosesAt as Unix seconds; null when identity is visible. Reveal is authoritative only on a new response.
$.oneOf[0].allOf[1].Payload.pageinteger Evet
$.oneOf[0].allOf[1].Payload.pageSize = 25 Evet
$.oneOf[0].allOf[1].Payload.totalinteger Evet
$.oneOf[0].allOf[1].Payload.serverTimeinteger Evet
$.oneOf[1]object Evet
$.oneOf[1].RequestUserAliasstring Evet
$.oneOf[1].RequestPathstring | null Evet
$.oneOf[1].RequestStatus = "Failed" Evet
$.oneOf[1].ResponseCodeinteger Evet
$.oneOf[1].ResponseMessageAPIResponseMessage Evet
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[1].ResponseMessage.oneOf[1]array Evet
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[1].ResponseMessage.oneOf[2]object Evet
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[1].RequestImpersonatedByUserAliasstring HAYIR
Yanıt örneği 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/bidauction/get_list",
    "RequestUserAlias": "example-user",
    "Payload": {
        "items": [],
        "page": 1,
        "pageSize": 25,
        "total": 0,
        "serverTime": 0
    }
}
Makine tarafından okunabilir uç nokta belgeleri
GET

/v1/bidauction/get_state

#
Auction price, fixed deadline and the acting seller's own offers only. Cash amounts are USD cents.

Parametreler

AdTürGerekliVarsayılanAçıklama
bidID int Evet — Customer bid ID.
roundID int HAYIR 0 Optional round to retain its outcome after closing. Zero selects the active round.
İstek örneği (cURL) 
curl --get \
  'https://tr.appointmenttrader.com/v1/bidauction/get_state' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'roundID={{roundID}}'

Dönen değer

JSON
See the shared response schema and synthetic example.
Yanıt alanları
AlanTürGerekliAçıklama
$bidauction_get_state_Response Evet
$.oneOf[0] Evet
$.oneOf[0].allOf[0]object Evet
$.oneOf[0].allOf[0].RequestUserAliasstring Evet
$.oneOf[0].allOf[0].RequestPathstring | null Evet
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Evet
$.oneOf[0].allOf[0].ResponseCodeinteger Evet
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring HAYIR
$.oneOf[0].allOf[1]object Evet
$.oneOf[0].allOf[1].Payloadobject Evet
$.oneOf[0].allOf[1].Payload.venuestring Evet
$.oneOf[0].allOf[1].Payload.startTimestring Evet
$.oneOf[0].allOf[1].Payload.endTimestring Evet
$.oneOf[0].allOf[1].Payload.bidIDinteger Evet
$.oneOf[0].allOf[1].Payload.bidAmountCentsinteger Evet
$.oneOf[0].allOf[1].Payload.roundID Evet
$.oneOf[0].allOf[1].Payload.roundID.anyOf[0]integer Evet
$.oneOf[0].allOf[1].Payload.roundID.anyOf[1]null Evet
$.oneOf[0].allOf[1].Payload.statestring Evet
$.oneOf[0].allOf[1].Payload.serverTimeinteger Evet
$.oneOf[0].allOf[1].Payload.closesAt Evet
$.oneOf[0].allOf[1].Payload.closesAt.anyOf[0]DatabaseInteger EvetInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.closesAt.anyOf[0].oneOf[0]integer Evet
$.oneOf[0].allOf[1].Payload.closesAt.anyOf[0].oneOf[1]string Evet
$.oneOf[0].allOf[1].Payload.closesAt.anyOf[1]null Evet
$.oneOf[0].allOf[1].Payload.enabledboolean Evet
$.oneOf[0].allOf[1].Payload.openingCentsinteger Evet
$.oneOf[0].allOf[1].Payload.incrementCentsinteger Evet
$.oneOf[0].allOf[1].Payload.leadingCentsinteger Evet
$.oneOf[0].allOf[1].Payload.nextCentsinteger Evet
$.oneOf[0].allOf[1].Payload.estimatedFeesCentsinteger Evet
$.oneOf[0].allOf[1].Payload.remainingCentsinteger Evet
$.oneOf[0].allOf[1].Payload.leadingboolean Evet
$.oneOf[0].allOf[1].Payload.priorityUntilnull Evet
$.oneOf[0].allOf[1].Payload.priorityMine = false Evet
$.oneOf[0].allOf[1].Payload.ownOffersarray Evet
$.oneOf[0].allOf[1].Payload.ownOffers[]object HAYIR
$.oneOf[0].allOf[1].Payload.ownOffers[].idinteger Evet
$.oneOf[0].allOf[1].Payload.ownOffers[].amountCentsinteger Evet
$.oneOf[0].allOf[1].Payload.ownOffers[].statestring Evet
$.oneOf[0].allOf[1].Payload.ownOffers[].refundCentsinteger Evet
$.oneOf[0].allOf[1].Payload.eligibilityError Evet
$.oneOf[0].allOf[1].Payload.eligibilityError.anyOf[0]string Evet
$.oneOf[0].allOf[1].Payload.eligibilityError.anyOf[1]null Evet
$.oneOf[0].allOf[1].Payload.holdAppointmentID Evet
$.oneOf[0].allOf[1].Payload.holdAppointmentID.anyOf[0]DatabaseInteger EvetInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.holdAppointmentID.anyOf[0].oneOf[0]integer Evet
$.oneOf[0].allOf[1].Payload.holdAppointmentID.anyOf[0].oneOf[1]string Evet
$.oneOf[0].allOf[1].Payload.holdAppointmentID.anyOf[1]null Evet
$.oneOf[0].allOf[1].Payload.buyerIdentityHiddenboolean HAYIRTrue when the authenticated viewer cannot see the buyer during the current response race.
$.oneOf[0].allOf[1].Payload.buyerIdentityHiddenUntilinteger | null HAYIRSaved current-round ClosesAt as Unix seconds; null when identity is visible. Reveal is authoritative only on a new response.
$.oneOf[1]object Evet
$.oneOf[1].RequestUserAliasstring Evet
$.oneOf[1].RequestPathstring | null Evet
$.oneOf[1].RequestStatus = "Failed" Evet
$.oneOf[1].ResponseCodeinteger Evet
$.oneOf[1].ResponseMessageAPIResponseMessage Evet
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[1].ResponseMessage.oneOf[1]array Evet
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[1].ResponseMessage.oneOf[2]object Evet
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[1].RequestImpersonatedByUserAliasstring HAYIR
Yanıt örneği 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/bidauction/get_state",
    "RequestUserAlias": "example-user",
    "Payload": {
        "venue": "synthetic-example",
        "startTime": "synthetic-example",
        "endTime": "synthetic-example",
        "bidID": 0,
        "bidAmountCents": 0,
        "roundID": 0,
        "state": "synthetic-example",
        "serverTime": 0,
        "closesAt": 0,
        "enabled": false,
        "openingCents": 0,
        "incrementCents": 0,
        "leadingCents": 0,
        "nextCents": 0,
        "estimatedFeesCents": 0,
        "remainingCents": 0,
        "leading": false,
        "priorityUntil": null,
        "priorityMine": false,
        "ownOffers": [],
        "eligibilityError": "synthetic-example",
        "holdAppointmentID": 0
    }
}
Makine tarafından okunabilir uç nokta belgeleri
POST

/v1/bidauction/set_checkout

#
Creates a seller-bound checkout for the full next cash offer. This does not reserve a bid or the leading position. Normal fulfillment fees are additional. Outbid or unusable card payments return to AT balance.

Parametreler

AdTürGerekliVarsayılanAçıklama
bidID int Evet — Customer bid ID.
negativeProceedsAccepted bool HAYIR false Explicit acknowledgment that total estimated cost can exceed payout.
isWritingRequest bool HAYIR false Must be true to create a checkout.
İstek örneği (cURL) 
curl --request POST \
  'https://tr.appointmenttrader.com/v1/bidauction/set_checkout' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'bidID={{bidID}}' \
  --data-urlencode 'negativeProceedsAccepted={{negativeProceedsAccepted}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Dönen değer

JSON
See the shared response schema and synthetic example.
Yanıt alanları
AlanTürGerekliAçıklama
$bidauction_set_checkout_Response Evet
$.oneOf[0] Evet
$.oneOf[0].allOf[0]object Evet
$.oneOf[0].allOf[0].RequestUserAliasstring Evet
$.oneOf[0].allOf[0].RequestPathstring | null Evet
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Evet
$.oneOf[0].allOf[0].ResponseCodeinteger Evet
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Evet
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring HAYIR
$.oneOf[0].allOf[1]object Evet
$.oneOf[0].allOf[1].Payloadobject Evet
$.oneOf[0].allOf[1].Payload.checkoutURLstring Evet
$.oneOf[0].allOf[1].Payload.amountCentsinteger Evet
$.oneOf[0].allOf[1].Payload.expiresAtinteger Evet
$.oneOf[1]object Evet
$.oneOf[1].RequestUserAliasstring Evet
$.oneOf[1].RequestPathstring | null Evet
$.oneOf[1].RequestStatus = "Failed" Evet
$.oneOf[1].ResponseCodeinteger Evet
$.oneOf[1].ResponseMessageAPIResponseMessage Evet
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Evet
$.oneOf[1].ResponseMessage.oneOf[1]array Evet
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage HAYIR
$.oneOf[1].ResponseMessage.oneOf[2]object Evet
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage HAYIR
$.oneOf[1].RequestImpersonatedByUserAliasstring HAYIR
Yanıt örneği 
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/bidauction/set_checkout",
    "RequestUserAlias": "example-user",
    "Payload": {
        "checkoutURL": "synthetic-example",
        "amountCents": 0,
        "expiresAt": 0
    }
}
Makine tarafından okunabilir uç nokta belgeleri