Yes, we should change the documentation On Mar 29, 2015 6:35 AM, "Mark Miller (JIRA)" <j...@apache.org> wrote:
> > [ > https://issues.apache.org/jira/browse/SOLR-7312?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14385609#comment-14385609 > ] > > Mark Miller commented on SOLR-7312: > ----------------------------------- > > I've always described Solr as "REST Like" with a grin ;) > > > "REST" API is not REST > > ---------------------- > > > > Key: SOLR-7312 > > URL: https://issues.apache.org/jira/browse/SOLR-7312 > > Project: Solr > > Issue Type: Improvement > > Components: Server > > Affects Versions: 5.0 > > Reporter: Mark Haase > > Assignee: Noble Paul > > > > The documentation refers to a "REST" API over and over, and yet I don't > see a REST API. I see an HTTP API but not a REST API. Here are a few things > the HTTP API does that are not RESTful: > > * Offers RPC verbs instead of resources/nouns. (E.g. schema API has > commands like "add-field", "add-copy-field", etc.) > > * Tunnels non-idempotent requests (like creating a core) through > idempotent HTTP verb (GET). > > * Tunnels deletes through HTTP GET. > > * PUT/POST confusion, POST used to update a named resource, such as the > Blob API. > > * Returns `200 OK` HTTP code even when the command fails. (Try adding a > field to your schema that already exists. You get `200 OK` and an error > message hidden in the payload. Try calling a collections API when you're > using non-cloud mode: `200 OK` and an error message in the payload. Gah.) > > * Does not provide link relations. > > * HTTP status line contains a JSON payload (!) and no 'Content-Type' > header for some failed commands, like `curl -X DELETE > http://solr:8983/solr/admin/cores/foo` > > * Content negotiation is done via query parameter (`wt=json`), instead > of `Accept` header. > > > > -- > This message was sent by Atlassian JIRA > (v6.3.4#6332) > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@lucene.apache.org > For additional commands, e-mail: dev-h...@lucene.apache.org > >
