From 73d0c418838cf3eb6ee26947362e3ab5cd331675 Mon Sep 17 00:00:00 2001 From: troymc Date: Tue, 21 Jun 2016 10:22:40 +0200 Subject: [PATCH] Docs: Clarified which config settings relate to the HTTP API --- docs/source/drivers-clients/http-client-server-api.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/source/drivers-clients/http-client-server-api.md b/docs/source/drivers-clients/http-client-server-api.md index e64018b9..35da0426 100644 --- a/docs/source/drivers-clients/http-client-server-api.md +++ b/docs/source/drivers-clients/http-client-server-api.md @@ -2,14 +2,13 @@ Note: The HTTP client-server API is currently quite rudimentary. For example, there is no ability to do complex queries using the HTTP API. We plan to add querying capabilities in the future. If you want to build a full-featured proof-of-concept, we suggest you use [the Python server API](../nodes/python-server-api-examples.html) for now. -When you start Bigchaindb using `bigchaindb start`, an HTTP API is exposed at: +When you start Bigchaindb using `bigchaindb start`, an HTTP API is exposed at the address stored in the BigchainDB node configuration settings. The default is for that address to be: [http://localhost:9984/api/v1/](http://localhost:9984/api/v1/) -For security reasons, the server binds to `localhost:9984`. -If you want to bind the server to `0.0.0.0` we recommend you to read -[Deploying Gunicorn](http://docs.gunicorn.org/en/stable/deploy.html) and -follow the instructions to deploy it in production. +but that address can be changed by changing the "API endpoint" configuration setting (e.g. in a local config file). There's more information about setting the API endpoint in [the section about Configuring a BigchainDB Node](../nodes/configuration.html). + +There are other configuration settings related to the web server (serving the HTTP API). In particular, the default is for the web server socket to bind to `localhost:9984` but that can be changed (e.g. to `0.0.0.0:9984`). For more details, see the "server" settings ("bind", "workers" and "threads") in [the section about Configuring a BigchainDB Node](../nodes/configuration.html). The HTTP API currently exposes two endpoints, one to get information about a specific transaction id, and one to push a transaction to the BigchainDB