Draft Config v2.0
| Draft Config | |
| Resource | |
| Draft Config | The draft configurations of the fantasy league. |
| HTTP Methods | |
| GET | Retrieve Draft Config |
| Example | |
| Retrieve Draft Config | |
| XML field definitions | |
| /draft | A container element for the draft configuration. |
| /draft/ | Whether reserve players will be included in the auction draft, as a Boolean using the values 1 and 0. |
| /draft/ | Specifies whether the auction will include active players only or both active and reserve players. |
| /draft/ | If the auction_to_bid_on value is active they may choose to use a supplemental draft to fill the reserve spots on their roster. |
| /draft/ | The amount of time owners will have to bid on a player, in seconds, as an integer. |
| /draft/ | The date that the draft will begin, in the format YYYYMMDD. |
| /draft/ | The time that the draft will begin (ET), in the format HHMM. |
| /draft/ | Specifies whether the draft has been scheduled. |
| /draft/ | The amount of time an owner will have to nominate a player for auction, in seconds, as an integer. |
| /draft/ | The source of the draft pick order. |
| /draft/ | Specifies how the order of picks will progress on round-by-round basis. |
| /draft/ | Whether email notifications will be sent for Online Extended Drafts, as a Boolean using the values 1 and 0. |
| /draft/ | The number of rounds in the draft, and thus the number of players each team will select during the draft. |
| /draft/ | The total amount that owners will have to bid on players, as an integer. |
| /draft/ | The time limit for an owner to make a pick in a draft when the draft robot is in use, in seconds, as an integer. |
| /draft/ | |
| /draft/ | Whether or not the draft uses the draft robot, as a Boolean. |
| /draft/ | For Extended Drafts, the time of day at which the robot starts running, in the format HHMM. |
| /draft/ | For Extended Drafts, the time of day at which the robot stops running, in the format HHMM. |
Draft Config
Description
The draft configurations of the fantasy league. The resource contains information that describes the configuration of a draft, including the type of the draft, number of rounds, draft day and time, salary cap (for auction drafts), bid time limit (for auction drafts), and nomination time limit (for auction drafts).
GET
Retrieve Draft Config
URL
http://api.cbssports.com
Parameters
| response_format | (optional) Specifies the format in which the requested resource should be returned. Valid values are XML and JSON. The default is XML. |
Retrieve Draft Config
Sample URL
http://api.cbssports.com/fantasy/league/draft/config?version=2.0
XML Response
Sample for Online Auction
<?xml version="1.0"?>
<result uriAlias="/league/draft/config" uri="/league/draft/config" statusCode="200" statusMessage="OK">
<body>
<draft>
<use_robot>1</use_robot>
<date>20120208</date>
<time>0800</time>
<auction_supplemental_rounds>4</auction_supplemental_rounds>
<auction_reserve_draft>1</auction_reserve_draft>
<nomination_time_limit>30</nomination_time_limit>
<auction_to_bid_on>active</auction_to_bid_on>
<bid_time_limit>60</bid_time_limit>
<pick_email>0</pick_email>
<draft_schedule>scheduled</draft_schedule>
<rounds>23</rounds>
<type>live</type>
<time_limit>30</time_limit>
<salary_cap>350</salary_cap>
</draft>
</body>
</result>JSON Response
Sample for Online Auction
{
"body" : {
"draft" : {
"use_robot" : 1,
"date" : "20120208",
"time" : "0800",
"auction_supplemental_rounds" : "4",
"auction_reserve_draft" : 1,
"nomination_time_limit" : "30",
"auction_to_bid_on" : "active",
"bid_time_limit" : "60",
"pick_email" : 0,
"draft_schedule" : "scheduled",
"rounds" : "23",
"type" : "live",
"time_limit" : "30",
"salary_cap" : "350"
}
},
"uriAlias" : "/league/draft/config",
"statusMessage" : "OK",
"uri" : "/league/draft/config",
"statusCode" : 200
}XML Response
Sample for Online Draft
<?xml version="1.0"?>
<result uriAlias="/league/draft/config" uri="/league/draft/config" statusCode="200" statusMessage="OK">
<body>
<draft>
<use_robot>1</use_robot>
<time>0800</time>
<date>20120214</date>
<order_type>snake</order_type>
<order_source>random</order_source>
<auction_supplemental_rounds>0</auction_supplemental_rounds>
<timer_start>1000</timer_start>
<pick_email>0</pick_email>
<type>extended</type>
<draft_schedule>scheduled</draft_schedule>
<rounds>26</rounds>
<time_limit>5</time_limit>
<timer_end>2100</timer_end>
</draft>
</body>
</result>JSON Response
Sample for Online Draft
{
"body" : {
"draft" : {
"use_robot" : 1,
"time" : "0800",
"date" : "20120214",
"order_type" : "snake",
"order_source" : "random",
"auction_supplemental_rounds" : 0,
"timer_start" : "1000",
"pick_email" : 0,
"type" : "extended",
"draft_schedule" : "scheduled",
"rounds" : "26",
"time_limit" : "5",
"timer_end" : "2100"
}
},
"uriAlias" : "/league/draft/config",
"statusMessage" : "OK",
"uri" : "/league/draft/config",
"statusCode" : 200
}/draft/date
The date that the draft will begin, in the format YYYYMMDD. The time the draft will begin is specified by the /draft/time field.
/draft/time
The time that the draft will begin (ET), in the format HHMM. The day the draft will begin is specified by the /draft/date field. It will automatically adjust for Daylight Savings Time.
/draft/time_limit
The time limit for an owner to make a pick in a draft when the draft robot is in use, in seconds, as an integer. To determine if the draft robot is in use, check /draft/use_robot.
/draft/type
The type of the draft. Possible values and their meanings are as follows
| none | Not sure yet |
| live | Online, Live Draft (all in one day) |
| auction | Online, Live Auction Draft (all in one day) |
| extended | Online, Extended Draft (over a period of several days) |
| auto | By Automated Draft |
| offline | By Entering Offline Draft Results (manual rosters entry) |
/draft/use_robot
Whether or not the draft uses the draft robot, as a Boolean. If the robot is used, there is time limit for each pick in each round (specified by /draft/time_limit). If any owner does not make a draft selection, the draft robot will pick for them. If the robot is not used, the draft will pause until the owner makes a draft pick or the commissioner picks in their place. The draft robot will pick the first player listed in the team’s draft queue. If there is no player in the draft queue, the draft robot will pick the top player on the team’s rank list.
