Destroyed RPC API (markdown)
Nathan Day
parent
0998bb4045
commit
67fef8392c
220
RPC-API.md
220
RPC-API.md
@ -1,220 +0,0 @@
|
||||
The following RPCs are supported and can be called at the `https://api.btcmap.org/rpc` end point.
|
||||
|
||||
Most calls require an access token, which have fine-grained permissions. Please email hello@btcmap.org or jump into our [Discord](https://discord.gg/wPqva83uzq) to request one.
|
||||
|
||||
The general RPC format is as follows:
|
||||
|
||||
```
|
||||
payload = {
|
||||
"jsonrpc": "2.0",
|
||||
"method": method,
|
||||
"params": params,
|
||||
"id": 1
|
||||
}
|
||||
```
|
||||
|
||||
Tokens should be passed in the header accordingly: `Authorization': 'Bearer <TOKEN>'`
|
||||
|
||||
* General RPCs
|
||||
* [/search](#/search)
|
||||
* Element RPCs
|
||||
* [/get_element](#/get_element)
|
||||
* [/set_element_tag](#/set_element_tag)
|
||||
* [/remove_element_tag](#/remove_element_tag)
|
||||
* [/boost_element](#/boost_element)
|
||||
* [/add_element_comment](#/add_element_comment)
|
||||
* Area RPCs
|
||||
* [/add_area](#/add_area)
|
||||
* [/get_area](#g/et_area)
|
||||
* [/remove_area](#/remove_area)
|
||||
* [/set_area_tag](#s/et_area_tag)
|
||||
* [/remove_area_tag](#r/emove_area_tag)
|
||||
* [/add_area](#/add_area)
|
||||
* [/get_trending_countries](#/get_trending_countries)
|
||||
* [/get_trending_communities](#/get_trending_communities)
|
||||
|
||||
***
|
||||
|
||||
|
||||
# General RPCs
|
||||
|
||||
## /search
|
||||
|
||||
### Params
|
||||
|
||||
`query` : Free text
|
||||
|
||||
### Example request
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "search", "params": {"query": "This is my query", "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
### Example response
|
||||
|
||||
This is an example response to a `berlin` query param :
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"jsonrpc": "2.0",
|
||||
"result": [
|
||||
{
|
||||
"id": 155,
|
||||
"name": "Bitcoin Berlin El Salvador",
|
||||
"type": "area"
|
||||
},
|
||||
{
|
||||
"id": 54,
|
||||
"name": "Berlin 2140",
|
||||
"type": "area"
|
||||
},
|
||||
{
|
||||
"id": 257,
|
||||
"name": "Einundzwanzig Berlin",
|
||||
"type": "area"
|
||||
},
|
||||
{
|
||||
"id": 77,
|
||||
"name": "Bitcoin Berlin El Salvador",
|
||||
"type": "area"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
# Element RPCs
|
||||
|
||||
## get_element
|
||||
|
||||
### Params
|
||||
|
||||
`id` : OSM element in the form `element_type:id`. e.g. `node:12345` or `way:12345`.
|
||||
|
||||
### Example request
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "get_element", "params": {"id": "node:12141608846"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
### Example response
|
||||
|
||||
_TODO_
|
||||
|
||||
## set_element_tag
|
||||
|
||||
This sets tags on elements within BTC Map only - these are not tags directly on OSM elements.
|
||||
|
||||
### Params
|
||||
|
||||
`id` : OSM element in the form `element_type:id`. e.g. `node:12345` or `way:12345`.
|
||||
|
||||
`name` : Tag name. Free text.
|
||||
|
||||
`value` : Tag value. Free text.
|
||||
|
||||
### Example request
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "set_element_tag", "params": {"id": "node:12141608846", "name": "foo", "value": "bar"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## remove_element_tag
|
||||
|
||||
- token
|
||||
- id
|
||||
- tag
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "remove_element_tag", "params": {"id": "node:12141608846", "tag": "foo"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## boost_element
|
||||
|
||||
- token
|
||||
- id
|
||||
- days
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "boost_element", "params": {"id": "node:12141608846", "days": 7}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## add_element_comment
|
||||
|
||||
- token
|
||||
- id
|
||||
- comment
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "add_element_comment", "params": {"id": "node:12141608846", "comment": "test comment"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
|
||||
# Area RPCs
|
||||
|
||||
## add_area
|
||||
|
||||
- token
|
||||
- tags
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "add_area", "params": {"tags": {"url_alias": "test-area", "geo_json": {"type":"Point","coordinates":[0,0]}}}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## get_area
|
||||
|
||||
- token
|
||||
- id
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "get_area", "params": {"id": "test-area"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## remove_area
|
||||
|
||||
- token
|
||||
- id
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "remove_area", "params": {"id": "test-area"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## set_area_tag
|
||||
|
||||
- token
|
||||
- id
|
||||
- name
|
||||
- value
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "set_area_tag", "params": {"id": "test-area", "name": "foo", "value": "bar"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## remove_area_tag
|
||||
|
||||
- token
|
||||
- id
|
||||
- tag
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "remove_area_tag", "params": {"id": "test-area", "tag": "foo"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## get_trending_countries
|
||||
|
||||
- token
|
||||
- period_start
|
||||
- period_end
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "get_trending_countries", "params": {""period_start": "2024-01-01", "period_end": "2024-02-01"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
|
||||
## get_trending_communities
|
||||
|
||||
- token
|
||||
- period_start
|
||||
- period_end
|
||||
|
||||
```bash
|
||||
curl --data-binary '{"jsonrpc": "2.0", "method": "get_trending_communities", "params": {"period_start": "2024-01-01", "period_end": "2024-02-01"}, "id": 1}' https://api.btcmap.org/rpc
|
||||
```
|
||||
Loading…
x
Reference in New Issue
Block a user