1

Suggestion about documenting your APIs

(27/10/2012 18:15:00 отредактировано zorrow)

Тема: Suggestion about documenting your APIs

Hey there!

This will sound a bit like ranting, because I do feel quite frustrated about my own experience with your APIs, but I guess you'll be able to take the positive out of it anyway, so here it goes:

Guys, I'm once again stuck with some undocumented/obscure stuff of yours which my production code should rely on.

This is seriously impacting my productivity. I need to focus on my application needs, instead of having to struggle with the API I'm using.

So, I strongly suggest you, as the software vendor you are, to go through this forum and collect all the typical use cases your API will be normally used to, and then provide short, working examples for each one of them.

You know, any customer of yours will be interested sooner or later in reading his/her data using the APIs to do further processing.

Things like "logging in and logging off", "getting the list of units with their last positions", "getting the list of POIs with their positions", "getting the last message for each one of your items", "getting the routes data" and stuff like that should be simple things to do for those who use your API.

So please, consider my suggestion above and create a bank of practical examples for we all to take advantage of. It's not hard to do, your customers will thank you and we all will win from that in the short term.

Thanks for reading this far!

2

Suggestion about documenting your APIs

Re: Suggestion about documenting your APIs

Welcome zorrow,
Thank you for your opinion.

We see that the SDK is gaining popularity.
A few months ago there was no such interest.

Surely, we will make more effort to write more intelligible documentation (description of the functions, queries and nuances in use).
We will continue to develop the portal http://sdk.wialon.com were we will put practical examples of use based on customer needs.

To do this, we need a little time.

Denis Strakh, Gurtam
3

Suggestion about documenting your APIs

(29/10/2012 18:17:17 отредактировано kalaschnikow)

Re: Suggestion about documenting your APIs

stde пишет:

http://sdk.wialon.com

The link doesn't work.

4

Suggestion about documenting your APIs

Re: Suggestion about documenting your APIs

kalaschnikow пишет:
stde пишет:

http://sdk.wialon.com

The link doesn't work.

try again, I corrected it.

At the dark side of telematics...