====== RobinNet API ======

The RobinNet API is used by:

  * peer nodes
  * CLI tools
  * future UI applications
  * testing tools

Base path:
<code>
/api/v1/
</code>

-----

===== Health Check =====

Endpoint:
<code>
GET /api/v1/health
</code>


Returns local node information.

-----

===== List Messages =====
<code>
GET /api/v1/messages
</code>


Python example:

<code python>
import requests

r = requests.get("http://localhost:8080/api/v1/messages")
print(r.json())
</code>

-----

===== Post Bulletin =====
<code>
POST /api/v1/messages/bulletin
</code>


Python example:

<code python>
import requests

payload = {
 "title": "Water Distribution",
 "body": "Town Hall from 10:00 to 16:00"
}

requests.post(
 "http://localhost:8080/api/v1/messages/bulletin",
 json=payload
)
</code>

-----

===== Fetch Messages =====
<code>
POST /api/v1/messages/fetch
</code>


Payload:

<code json>
{
 "msg_uuids": ["uuid1","uuid2"]
}
</code>

-----

===== Import Messages =====
<code>
POST /api/v1/messages/import
</code>

Used internally during peer synchronization.