hbnet/api_doc.md
2021-04-26 11:13:58 -07:00

39 lines
1.3 KiB
Markdown

The API is a new feature that allows users to interact with external applications via SMS and send messages users on other HBLink servers. The API is built into the D-APRS dashboard. All interaction takes place over HTTP POST requests in JSON format. This allows a single application to be used by multiple servers. Applications can be delevopen in multiple langauges.
There are presently 3 modes for data exchange, "msg_xfer", "app", and "raw". msg_xfer is used to send a message. With msg_xfer, there are 2 authentication types, "public" and "private".
## msg_xfer, private authentication
`
{
"mode": "msg_xfer",
"system_shortcut": "ABC",
"server_name": "Test HBlink Network",
"response_url": "http://localhost:8093/api/",
"auth_type": "private",
"credentials": {
"user": "test_name",
"password": "passw0rd"
},
"data": {
"1": {
"source_id": 1234,
"destination_id": 3153591,
"slot": 2,
"msg_type": "unit",
"msg_format": "motorola",
"message": "text of the message"
},
"2": {
"source_id": 1234,
"destination_id": 3153591,
"slot": 2,
"msg_type": "unit",
"msg_format": "motorola",
"message": "text of the 2nd message"
}
}
}`