/v1/auction/get_bid_status
#Read one checkout attempt belonging to the acting buyer, including pending funding.
매개변수
| 이름 | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
bidID |
int |
예 |
— |
Auction bid ID returned by /v1/auction/set_bid_checkout. |
요청 예제(cURL)
curl --get \
'https://kr.appointmenttrader.com/v1/auction/get_bid_status' \
--data-urlencode 'key={{API_KEY}}' \
--data-urlencode 'bidID={{bidID}}'
반환값
JSON See the shared response schema and synthetic example.
응답 필드
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
$ | auction_get_bid_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.bidID | integer |
예 | |
$.oneOf[0].allOf[1].Payload.listingID | string |
예 | |
$.oneOf[0].allOf[1].Payload.amountCents | integer |
예 | |
$.oneOf[0].allOf[1].Payload.status | string ["PendingFunding","Leading","Outbid","Won","Returned"] |
예 | |
$.oneOf[0].allOf[1].Payload.buyerIdentityHidden | boolean |
아니요 | 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 |
아니요 | Latest saved closing timestamp among the buyer's qualifying open response races, in Unix seconds, or null when identity is visible. |
$.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/auction/get_bid_status",
"RequestUserAlias": "example-user",
"Payload": {
"bidID": 0,
"listingID": "synthetic-example",
"amountCents": 0,
"status": "PendingFunding"
}
}