APIv2 Char Contracts XML
From EVEDev
 | API Methods - Category Home - API Overview - API Page Index - API Libraries - API Wanted Features |
Contents |
[edit] /char/Contracts.xml.aspx
[edit] Overview
Lists the personal contracts for a character.
More informations here : http://www.eveonline.com/devblog.asp?a=blog&nbid=2383
[edit] Data Caching
This method is cached according to the Modified Short Cache Style.
[edit] Input Arguments
| Name | Type | Description |
|---|---|---|
| keyID | int | The ID of the Customizable API Key for authentication, found at: https://support.eveonline.com/api. |
| vCode | char(64) | The user defined or CCP generated Verification Code for the Customizable API Key, found at https://support.eveonline.com/api. |
| characterID | int | The ID of the character for the requested data, from Character List. (Only required when use keyID that works with multiple characters) |
| contractID | long | Optional - contract ID to fetch a particular contract. |
[edit] Output XML
<?xml version='1.0' encoding='UTF-8'?> <eveapi version="2"> <currentTime>2011-07-30 04:47:30</currentTime> <result> <rowset name="contractList" key="contractID" columns="contractID,issuerID,issuerCorpID,assigneeID,acceptorID,startStationID,endStationID, type,status,title,forCorp,dateIssued,dateExpired,dateAccepted,numDays,dateCompleted,price,reward,collateral,volume" /> </result> <cachedUntil>2011-07-30 05:44:30</cachedUntil> </eveapi>
[edit] Output Rowset Columns
| Name | Type | Description |
|---|---|---|
| contractID | long ? | Unique ID for this contract. |
| issuerID | long | Character ID who created contract |
| issuerCorpID | long | Corporation ID who created contract |
| assigneeID | long | Character ID to whom the contract was discharged |
| acceptorID | long | Who will accept the contract. If assigneeID is same as acceptorID then CharacterID else CorporationID (The contract accepted by the corporation) |
| startStationID | int | Start station ID (for Couriers contract) |
| endStationID | int | End station ID (for Couriers contract) |
| type | string | Type of the contract (ItemExchange, Courier, Loan or Auction) |
| status | string | Status of the the contract (Outstanding, Deleted, Completed, Failed, CompletedByIssuer, CompletedByContractor, Cancelled, Rejected, Reversed or InProgress) |
| title | string | Title of the contract |
| forCorp | int | 1 if the contract was issued on behalf of the issuer's corporation, 0 otherwise |
| availability | string | Public or Private |
| dateIssued | DateTime | Сreation date of the contract |
| dateExpired | DateTime | Expiration date of the contract |
| dateAccepted | DateTime | Date of confirmation of contract |
| numDays | int | Number of days to perform the contract |
| dateCompleted | DateTime | Date of completed of contract |
| price | float | Price of contract (for ItemsExchange and Auctions) |
| reward | float | Remuneration for contract (for Couriers only) |
| collateral | float | Collateral price (for Couriers only) |
| buyout | float | Buyout price (for Auctions only) |
| volume | float | Volume of items in the contract |
Sorry my English. I use Google Translate
