getting-things-gnome / GTGOnline

An Online Application for Getting Things Gnome!
21 stars 7 forks source link

API: some methods are using the wrong HTTP verb #9

Open Kernald opened 10 years ago

Kernald commented 10 years ago

Some methods are currently POST methods, but should be GET:

Should be DELETE:

Should be PUT:

See here about HTTP verbs meanings: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

parinporecha commented 10 years ago

@Kernald - I've modified Task Update and Delete methods to PUT and DELETE respectively. The rest methods will be updated when the auth_token is implemented to replace username and password. I've also updated all the URIs. Gathered them to one place in - api/ and modified some names. Please check the changes on the docs page. I'll close this issue when the remaining methods which should be GET are changed to it

Kernald commented 10 years ago

While you're changing the API path, you should maybe add a version number, something like that: /api/v1/tags/all. This way, if one day you need to rewrite the API in a non-compatible way, you can let the previous one for a while, waiting for devs to migrate to the new one.