This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
api [2021/02/01 09:24] kd6kpc [Multi-Select with parameters] |
api [2023/04/02 17:57] kd6kpc [Overview] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== API ====== | ====== API ====== | ||
- | Repeaterbook.com has an API for querying | + | ===== Overview ===== |
+ | |||
+ | |||
+ | The RepeaterBook API allows developers access to repeater data. The API is based upon [[https:// | ||
+ | |||
+ | The API is located at https:// | ||
+ | |||
+ | ===== Use Authorization ===== | ||
+ | |||
+ | Use of the data is for personal use only. The data cannot be fed to a commercial product for sale or otherwise. The use of the data may not compete with the RepeaterBook web or mobile application products. The data cannot be incorporated into an app or website with distribution beyond immediate personal use without the expressed written consent of RepeaterBook.com. | ||
+ | |||
+ | |||
+ | ===== Pricing ===== | ||
+ | |||
+ | All the information presented via the API is intended to be open data and free to use for any purpose. As a public service of RepeaterBook.com, | ||
+ | |||
+ | All public-facing apps must provide credit back to RepeaterBook for the data. | ||
+ | |||
+ | ===== Content Negotiation ===== | ||
+ | |||
+ | Every request, either by browser or application, | ||
+ | |||
+ | ===== Authentication ===== | ||
+ | |||
+ | A User Agent is required to identify your application. This string can be anything, and the more unique to your application, | ||
+ | |||
+ | **User-Agent: | ||
+ | |||
+ | ===== Format ===== | ||
+ | |||
+ | Endpoints have the JSON default format. | ||
+ | |||
+ | |||
===== North America ===== | ===== North America ===== | ||
Line 36: | Line 69: | ||
* P-25 Capable | * P-25 Capable | ||
* P-25 NAC | * P-25 NAC | ||
+ | * M17 | ||
+ | * M17 CAN | ||
* Tetra Capable | * Tetra Capable | ||
* Tetra MCC | * Tetra MCC | ||
Line 41: | Line 76: | ||
* Yaesu System Fusion Capable | * Yaesu System Fusion Capable | ||
* YSF Digital ID Uplink | * YSF Digital ID Uplink | ||
- | * YSF Digial | + | * YSF Digital |
* YSF DSC | * YSF DSC | ||
* Analog Capable | * Analog Capable | ||
+ | * Notes | ||
* Last Update | * Last Update | ||
- | * Trustee | ||
- | On Repeaterbook.com, | + | All repeaters are identified by a combination of the state ID and the repeater ID. The state ID is based on [[https:// |
===== api/ | ===== api/ | ||
Line 59: | Line 94: | ||
* mode - Repeater operating mode (analog, DMR, NXDN, P25, tetra) | * mode - Repeater operating mode (analog, DMR, NXDN, P25, tetra) | ||
* emcomm - ARES, RACES, SKYWARN, CANWARN | * emcomm - ARES, RACES, SKYWARN, CANWARN | ||
+ | * stype - Service type. Only required when searching for GMRS repeaters. ex: stype=gmrs | ||
===== Output Format Parameter ===== | ===== Output Format Parameter ===== | ||
- | The format is json - Java Script | + | The format is json - JavaScript |
===== Wildcards ===== | ===== Wildcards ===== | ||
Line 77: | Line 113: | ||
- | ===== Sample | + | ===== Sample |
**HTTPS example - US and Canada** | **HTTPS example - US and Canada** | ||
Line 116: | Line 152: | ||
* P-25 Capable | * P-25 Capable | ||
* P-25 NAC | * P-25 NAC | ||
+ | * M17 | ||
+ | * M17 CAN | ||
* Tetra Capable | * Tetra Capable | ||
* Tetra MCC | * Tetra MCC | ||
Line 121: | Line 159: | ||
* Yaesu System Fusion Capable | * Yaesu System Fusion Capable | ||
* YSF Digital ID Uplink | * YSF Digital ID Uplink | ||
- | * YSF Digial | + | * YSF Digital |
* YSF DSC | * YSF DSC | ||
* Analog Capable | * Analog Capable | ||
+ | * Notes | ||
* Last Update | * Last Update | ||
- | * Trustee | ||
On Repeaterbook.com, | On Repeaterbook.com, | ||
Line 139: | Line 177: | ||
- | ===== Output Format Parameter ===== | ||
- | The format is json - Java Script Object Notation | ||
===== Wildcards ===== | ===== Wildcards ===== | ||
Line 163: | Line 199: | ||
* ATV repeaters are not included | * ATV repeaters are not included | ||
+ | |||
+ | ===== Rate Limiting ===== | ||
+ | |||
+ | Various actions of the API can be rate limited. The actual limits are not published. However, if a human user using a browser is querying the API, there should not be any throttling issues. If you receive a rate-limiting message, wait at least 10 seconds and up to 60 seconds to reset the limiter. | ||
+ | |||
+ | The API is not intended for use by non-human-initiated (automated) transactions. If you have a business requirement that requires exceptions to the rate limits, please get in touch with the RepeaterBook administrator for pricing options. | ||
+ | |||
+ | ===== Requested Improvements ===== | ||
+ | |||
+ | * Add an array of linked repeaters |