Download to read offline
Uploaded byIBM Cloud Data Services
CouchDB Day NYC 2017: Core HTTP API
The document discusses the CouchDB HTTP API and how to interact with it using the http-console tool. It demonstrates how to install http-console, connect to CouchDB instances locally or remotely, view request headers, PUT and DELETE databases, and handle errors from duplicate PUT requests. The lab instructions at the end summarize how to create and delete a database.
More Related Content
Similar to CouchDB Day NYC 2017: Core HTTP API
CouchDB Day NYC 2017: Core HTTP API
- 1. Lab: Core HTTPAPI (30 minutes) Bradley Holt, Developer Advocate Thursday, February 9, 2017 CouchDB Developer Day @BradleyHolt
- 2. HTTP API Apache CouchDBis accessed through an HTTP API @BradleyHolt GET / GET /db/docPOST /db DELETE /db/doc PUT /db/doc PUT /db
- 3. http-console $ npm installhttp-console -g @BradleyHolthttps://github.com/cloudhead/http-console
- 4. http-console $ npm installhttp-console -g $ http-console 127.0.0.1:5984 @BradleyHolthttps://github.com/cloudhead/http-console
- 5. http-console $ npm installhttp-console -g $ http-console 127.0.0.1:5984 > http-console 0.6.3 > Welcome, enter .help if you're lost. > Connecting to 127.0.0.1 on port 5984. @BradleyHolthttps://github.com/cloudhead/http-console
- 6.
- 7.
- 8. http-console http://127.0.0.1:5984/> GET / HTTP/1.1200 OK Content-Type: text/plain; charset=utf-8 { couchdb: 'Welcome', version: '9afa6a0', vendor: { name: 'The Apache Software Foundation' } } @BradleyHolthttps://github.com/cloudhead/http-console
- 9.
- 10.
- 11.
- 12. http-console $ http-console https://bradley-holt.cloudant.com >http-console 0.6.3 > Welcome, enter .help if you're lost. > Connecting to bradley-holt.cloudant.com on port 443. @BradleyHolthttps://github.com/cloudhead/http-console
- 13. Connecting to CouchDB2.0 $ http-console root:passw0rd@127.0.0.1:5984 --json @BradleyHolt
- 14. Connecting to CouchDB2.0 $ http-console root:passw0rd@127.0.0.1:5984 --json > http-console 0.6.3 > Welcome, enter .help if you're lost. > Connecting to 127.0.0.1 on port 5984. @BradleyHolt
- 15. Connecting to IBMCloudant $ http-console https://bradley-holt:passw0rd@bradley-holt.cloudant.com --json @BradleyHolt
- 16. Connecting to IBMCloudant $ http-console https://bradley-holt:passw0rd@bradley-holt.cloudant.com --json > http-console 0.6.3 > Welcome, enter .help if you're lost. > Connecting to bradley-holt.cloudant.com on port 443. @BradleyHolt
- 17.
- 18.
- 19. Request Headers /> .headers Accept:application/json Content-Type: application/json Authorization: Basic cm9vdDorMi95N3Y2aA== Host: 127.0.0.1 @BradleyHolt
- 20.
- 21. PUT a Database />PUT /kittens @BradleyHolt
- 22. PUT a Database />PUT /kittens ... @BradleyHolt
- 23. PUT a Database />PUT /kittens ... HTTP/1.1 201 Created Content-Type: application/json Location: http://127.0.0.1/kittens { ok: true } @BradleyHolt
- 24. PUT a DatabaseAgain /> @BradleyHolt
- 25. PUT a DatabaseAgain /> PUT /kittens @BradleyHolt
- 26. PUT a DatabaseAgain /> PUT /kittens ... @BradleyHolt
- 27. PUT a DatabaseAgain /> PUT /kittens ... HTTP/1.1 412 Precondition Failed Content-Type: application/json { error: 'file_exists', reason: 'The database could not be created, the file already exists.' } @BradleyHolt
- 28.
- 29. Delete a Database />DELETE /kittens @BradleyHolt
- 30. Delete a Database />DELETE /kittens HTTP/1.1 200 OK Content-Type: application/json { ok: true } @BradleyHolt
- 31. Try It OnYour Own 1. Create database test_1 2. Delete database test_1 @BradleyHolt
- 32. Lab: Core HTTPAPI CouchDB Developer Day @BradleyHolt
Editor's Notes
- #14 HTTP Basic authentication is a simple way to authenticate with an HTTP server Other approaches, such as cookies and OAuth, are often used as well