Questions about Time report API

For the time report APIs, here taking "Generating Company Wide Reports" as an
example, could some one clarify the following? Thanks

1. In the table, there is
URL /gds/timereports/:version/companies/:companyid/

So this means
https://www.odesk.com/api/gds/timereports/:version/companies/:companyid/ ?

Is the :version "v1" or do you have other versions now?

2. Should these time report APIs be authorized with a session id?

3. Also in the same table, there is
{format} json,xml,csv
So should .xml or .json be added to the url, such as
https://www.odesk.com/api/gds/timereports/v1/companies/emacs.xml?
In some other tables, {format} is part of the url. Here it is not, so why put it
here?

4. In the table, it says "Parameters None". Under the table, "URL parameters"
and "GET parameters" are explained. This is confusing, right? Also in other
pages like "oTask API", ":companyid" is explained as GET parameters, but
here it is explained as "URL parameters".

The document should be clear, clean and consistent.

Vote Result

Score: 0.0, Votes: 0