What just happened?

We used Terminal to trigger a POST call to CouchDB's RESTful JSON API. This time, our curl statement gained some more options that we haven't used before. The -H option enables us to set the header of the HTTP request for POST methods. We need to set the content-type to JSON so that CouchDB's RESTful API knows what format is coming in. We also used a new option, -d option, which stands for data. The data option allows us to pass data in the form of a string along with our curl statement.

After creating our document, we retrieved it to Terminal by submitting a GET request to http://localhost:5984/test-db/41198fc6e20d867525a8faeb7a000015. In response, we received a JSON object containing all of the document's data. At the end of this request, we did something a little different. We added python mjson.tool, which is a built-in component from Python that enables us to nicely format our JSON responses, so that we can make more sense of them. This will come in handy as we start looking at more complex documents.

I know that this has been a bit tiresome, but curl will be the main method that our PHP code will use to talk to CouchDB, so it's important that we're familiar with how it works. Luckily, there is an easier way to access and manage your data through a tool named Futon.