open All Channels
seplocked EVE Information Portal
blankseplocked New Dev blog: Contracts in the API
 
This thread is older than 90 days and has been locked due to inactivity.


 
Pages: 1 [2]

Author Topic

Johnathan Roark
Caldari
The Graduates
Morsus Mihi
Posted - 2011.07.31 15:37:00 - [31]
 

Originally by: Cyaxares II
Edited by: Cyaxares II on 30/07/2011 07:48:11
from my POV there are three major areas of application for a contracts API

(a) "I want an application that gives me an overview over my revenue, profits, most profitable items, ... for the last week/month/quarter/... . Part of my business relies on buying from and selling to contracts."
(b) "I have this guy's Full API key and want to check if he had any financial connections to hostiles, possibly undisclosed alts, ... in the recent to mid-term past"
(c) "Do I have to log in to renew my filled/expired contracts already?"

The proposed API does (c) well but (c) is the scenario that is centered around cheap convenience the most.
It fails completely at (b).
It is mostly useless when used for (a) which is imo the prime use-case.

It may be possible to work around the API to arrive at some sort of solution for (a) - but then we are at "I have to run this tool multiple times per day to create my own local contracts history. If I forget to run it for a few days my whole accounting for that time period will be screwed up."
But even then we still face the problem that only "me selling with WTS/Auction contracts" is covered. "Me selling to WTB" or "me buying from WTS" leaves no tracks.



For B, journal is going to be better for this anyway.
For A, if your looking to do that, your tool should be checking in and downloading and storing data anyway or its not worth the space required to install it. This api has nothing to do with that, even the journal only goes back so far.


Yes, this api could be better, I hope it will get better. At least it is something and maybe we can get more later. I am actually more disappointed that this is the only api related item in the CSM thing. I am guessing every player, or at least there corporation, uses some app that pulls info from the api, yet it has the least resources devoted to it. I want more APIs, especially that employment history api, a ramsan for the api servers, and faster responses and shorter cache timers. It would also be nice if more then one or two people where assigned to work on the api.

Locin WeEda
Gallente
Red Frog Investments
Posted - 2011.07.31 22:50:00 - [32]
 

Needless to say, we in Red Frog/Black Frog are very happy about the contract api!

Quote:
This is something we wanted to get your opinion on, the corporation contracts are visible in-game to any member of the corporation but in the API we're locking it behind a corporation key which only directors and CEOs can create. This is a kind of a security measure in the sense that it prevents members from accidentally giving corporate information to a 3rd party.


I think it is a very good idea to lock the corporate contract api to CEO and directors. Either that, or tie it to a role. It should not be accessible for ALL members of the corporation.

Once we have played around with the api some more, we should be back with some more feedback.





Ryomanni
Red Frog Investments
Posted - 2011.08.03 23:42:00 - [33]
 

Perhaps I filed my results and questions that specifically relate to the contract API in an ineffective place, the custom API keys forum (http://www.eveonline.com/ingameboard.asp?a=topic&threadID=1554297&page=3#67).

I'm sure someone is thinking about the questions regardless. I'll monitor both these forums in case new details emerge, and I can try them out in very short notice - again, very exciting news! - Ryo.

Callean Drevus
Caldari
Icosahedron Crafts and Shipping
Silent Infinity
Posted - 2011.08.04 09:29:00 - [34]
 

Question
Will the contract details & contents API be open to for every contract? That is, if you've got the ID, will you be able to get the data specific for that contract? Contract information is open pretty much by default, so I should think this is a possiblity.

CCP Elerhino


Minmatar
C C P
C C P Alliance
Posted - 2011.08.08 10:27:00 - [35]
 

Originally by: Callean Drevus
Question
Will the contract details & contents API be open to for every contract? That is, if you've got the ID, will you be able to get the data specific for that contract? Contract information is open pretty much by default, so I should think this is a possiblity.


As long as the authenticated character is a part of that contract in some way - yes and yes.

CCP Elerhino


Minmatar
C C P
C C P Alliance
Posted - 2011.08.08 11:04:00 - [36]
 

Originally by: Ryomanni

Q. Will the contracts results include a weeks worth of contracts, rather than just outstanding and in progress? It would make it easier to record the contracts that are finished, failed, or rejected.

Q. Regarding the recent dev blog post, "We'll also have a separate page or a contractID parameter so that you can look up a single contract." - Will that work on finished contracts?

Q. I see an approximate one hour cachedUntil time on the test server data. Is it possible this cached time could be lessened so new contracts can be recorded more quickly?

Q. Does the "title" element of the XML hold the user defined contract description?

Q. I noticed there are contracts that have a dateAccepted value even though they have a status of "Outstanding" - should that be a blank string like the dateCompleted value is?

Q. Will there be any change to the "showContract" IGB JavaScript method so only a contractID is required, instead of also having to supply the solarSystemID? And if not, could each contract API row also include a solarSystemID (this would save having to look up the solarsystemID of the startStationID in the data dump).



The contract list will include items created within the last week as well as all outstanding and inprogress contracts. You'll be able to fetch any of your contracts (also finished contracts, yes) using a contractID parameter on the contract list page. Most likely we'll start with a 1 hour cache time, we'd of course like to get it down but as always we need to be careful when it comes to performance. The title element should hold the custom description, yes. We are currently looking at special cases in the date columns, the dateAccepted is one of them.

Locin WeEda
Gallente
Red Frog Investments
Posted - 2011.08.09 07:21:00 - [37]
 

Originally by: CCP Elerhino

The contract list will include items created within the last week as well as all outstanding and inprogress contracts. You'll be able to fetch any of your contracts (also finished contracts, yes) using a contractID parameter on the contract list page. Most likely we'll start with a 1 hour cache time, we'd of course like to get it down but as always we need to be careful when it comes to performance. The title element should hold the custom description, yes. We are currently looking at special cases in the date columns, the dateAccepted is one of them.


Thanks for the answers.

Will the contractID be visible somewhere ingame? For instance as a column in My contracts? Currently the steps you need to take to find the contractid on a given contract ingame is a bit convoluted. First, I need to drag the contract to a chat channel, then I have to copy the line, and then I have to paste it into notepad in windows to see the contract id.

If the contractID could be passed to the chat log it would be even better, as we would then have a way to find out what contracts have been mentioned in our chat-rooms when reading the logs.




Locin WeEda
Gallente
Red Frog Investments
Posted - 2011.08.12 10:17:00 - [38]
 

After reviewing the api-data, I realized that from the API data alone, there is no way to separate between these two situations:

- contract is overdue, and get failed by the pilot that accepted the contract
- contract is overdue and get failed by the issuer of the contract

While the effect is the same, how we act as a corp in the two situations can be very different.

It is easy to find out when the contract is not overdue, as the accepting pilot is the only one allowed by game mechanics to fail a contract then.

Is it possible to add something, so we can see whether the contract was failed by the issuer of the contract, or failed by the pilot that accepted the contract?

for example failedbyContractor with state 0 or 1


Callean Drevus
Caldari
Icosahedron Crafts and Shipping
Silent Infinity
Posted - 2011.08.17 10:54:00 - [39]
 

Originally by: CCP Elerhino
Originally by: Callean Drevus
Question
Will the contract details & contents API be open to for every contract? That is, if you've got the ID, will you be able to get the data specific for that contract? Contract information is open pretty much by default, so I should think this is a possiblity.


As long as the authenticated character is a part of that contract in some way - yes and yes.


In regards to what I meant, this is probably a no. But why are we not allowed to query contract information that is public in-game anyway. We're not able to get a list of all public contracts, I understand that, since it would be insanely resource intensive, but why not the details (for a public contract) if we obtain the ID from a different source? Or do all character count as involved in a public contract by default?

Thank you for the information in any case Wink.

Bob Niac
Gallente
freelancers inc
Imperial 0rder
Posted - 2011.08.18 13:39:00 - [40]
 

Originally by: CCP Elerhino
.... the database is not optimized [for certain api features] ...


So.. silly question here, but: Why not proxy the TQ database to a web server database? Have the web server pull transactions in real-time. Or, better yet, have a process to sync the TQ database (from the backup server?) during downtime, and be the "man in the middle" when a client requests real-time api data, caching the changed data.

Ezra Larkyn
Quafe Logistics
Posted - 2011.08.22 11:43:00 - [41]
 

Could we get an update for the release timeline, please?


Johnathan Roark
Caldari
The Graduates
Morsus Mihi
Posted - 2011.08.22 21:58:00 - [42]
 

Originally by: Ezra Larkyn
Could we get an update for the release timeline, please?




Since there is a patch on Aug 30 and that is when Custom API Keys was scheduled to release, plus the fact that its on SISI with the CAK updates. I would be willing to bet Aug 30.

Ezra Larkyn
Quafe Logistics
Posted - 2011.08.23 06:17:00 - [43]
 

I really really hope so.

But i'm a little bit nervous because only the customiced API and not the contract API is announced for the 30.8. .

So let us hope the best.



Iam Widdershins
Project Nemesis
Moar Tears
Posted - 2011.08.25 10:56:00 - [44]
 

As long as this is released alongside custom API keys, and not as something that is suddenly available to everyone with your Full API, I'm all for it. Otherwise, please implement major restrictions.

Vessper
Indicium Technologies
Hephaestus Forge Alliance
Posted - 2011.08.26 19:00:00 - [45]
 

Courier contracts should really have as associated ContractItems XML to list those items that are being transported. Currently, an error code is returned:

<error code="134">Invalid or missing contractID.</error>


Ezra Larkyn
Quafe Logistics
Posted - 2011.08.29 05:53:00 - [46]
 

Originally by: Johnathan Roark
Since there is a patch on Aug 30 and that is when Custom API Keys was scheduled to release, plus the fact that its on SISI with the CAK updates. I would be willing to bet Aug 30.


When i see the patch notification it seems that the contract API will not come tomorrow i fear.


Johnathan Roark
Caldari
The Graduates
Morsus Mihi
Posted - 2011.08.29 16:12:00 - [47]
 

Originally by: Ezra Larkyn
Originally by: Johnathan Roark
Since there is a patch on Aug 30 and that is when Custom API Keys was scheduled to release, plus the fact that its on SISI with the CAK updates. I would be willing to bet Aug 30.


When i see the patch notification it seems that the contract API will not come tomorrow i fear.




Its in the patch notes for tomarrow:
Quote:
Contracts

Contract updates are now available to third-party applications. For more information, please read this dev blog.
Three new pages were added to the API (in both /char and /corp): Contracts.xml.aspx, ContractItems.xml.aspx and ContractBids.xml.aspx.


Ezra Larkyn
Quafe Logistics
Posted - 2011.08.29 18:21:00 - [48]
 

You see me dancing! Very Happy


Pages: 1 [2]

This thread is older than 90 days and has been locked due to inactivity.


 


The new forums are live

Please adjust your bookmarks to https://forums.eveonline.com

These forums are archived and read-only