Skip to content

Conversation

@kadamwhite
Copy link
Collaborator

This one has been a long time coming: POSTing a post to the posts endpoint is a linguistic nightmare, and HTTP verbs are part of the API interface that is best kept away from the users.

This alters all of the existing GET, POST, PUT, DELETE and HEAD methods to be (semi)private and prefixed by _http, e.g. _httpDelete: The public interfaces for these (.get, .create, .update, .delete and .headers).

.post and .put are maintained for the time being for back-compat but will be removed in 1.0.

@kadamwhite
Copy link
Collaborator Author

kadamwhite commented Jun 24, 2016

After broadcasting this to the WCEU community, to anybody who comes to chime in: can you articulate

  1. whether you prefer the HTTP or semantic English verbs; and
  2. if so, do you think the HTTP equivalents should be removed?

@kadamwhite
Copy link
Collaborator Author

Good chat. Provisionally merging, will see what feedback is like in tomorrow's presentation.

@kadamwhite kadamwhite force-pushed the use-regular-verbs-not-rest-verbs branch from 34c5a29 to 58d2b81 Compare June 24, 2016 22:24
This one has been a long time coming: POSTing a post to the posts endpoint
is a linguistic nightmare, and HTTP verbs are part of the API interface
that is best kept away from the users.

This alters all of the existing GET, POST, PUT, DELETE and HEAD methods
to be (semi)private and prefixed by `_http`, e.g. `_httpDelete`: The
public interfaces for these (`.get`, `.create`, `.update`, `.delete`
and `.headers`).

`.post` and `.put` are maintained for the time being for back-compat
but will be removed in 1.0.
@kadamwhite kadamwhite force-pushed the use-regular-verbs-not-rest-verbs branch from 58d2b81 to 4e05add Compare June 24, 2016 23:17
@kadamwhite kadamwhite merged commit 4e05add into master Jun 24, 2016
@kadamwhite kadamwhite deleted the use-regular-verbs-not-rest-verbs branch June 24, 2016 23:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants