This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
api [2022/05/26 11:54] kd6kpc [API] |
api [2023/09/15 11:50] kd6kpc [Attrubtion] |
||
---|---|---|---|
Line 4: | Line 4: | ||
- | The RepeaterBook API allows developers access to repeater data. The API os based upon [[https:// | + | 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. | ||
+ | |||
+ | ===== Scope ===== | ||
+ | All of the content, documentation, | ||
+ | |||
+ | ===== Use ===== | ||
+ | You may use any RepeaterBook API to develop a service or service to search, display, analyze, retrieve, view, and otherwise ' | ||
+ | |||
+ | ===== Attrubtion ===== | ||
+ | All services that utilize or access the API should display the following notice prominently within the application: | ||
+ | |||
+ | ===== Modification or False Representation of Content ===== | ||
+ | You may not modify or falsely represent content accessed through the API and still claim the source is RepeaterBook. | ||
+ | |||
+ | ===== Right to Limit ===== | ||
+ | Your use of the API may be subject to certain limitations on access, calls, or use as set forth within this Agreement or otherwise provided by RepeaterBook. If RepeaterBook reasonably believes that you have attempted to exceed or circumvent these limits, your ability to use the API may be permanently or temporarily blocked. RepeaterBook may monitor your use of the API to improve the service or to ensure compliance with this Agreement. | ||
+ | |||
+ | ===== Service Termination ===== | ||
+ | If you wish to terminate this Agreement, you may do so by refraining from further API use. RepeaterBook reserves the right (though not the obligation) to (1) refuse to provide the API to you if it is RepeaterBook' | ||
+ | |||
+ | ===== Changes ===== | ||
+ | RepeaterBook reserves the right, at its sole discretion, to modify or replace this Agreement, in whole or in part. Your continued use of or access to the API after posting any changes to this Agreement constitutes acceptance of those modified terms. RepeaterBook may, in the future, offer new services and/or features through the API. Such new features and/or services shall be subject to the terms and conditions of this Agreement. | ||
+ | |||
+ | ===== Disclaimer of Warranties ===== | ||
+ | The API is provided "as is" and on an " | ||
+ | |||
+ | ===== Limitations on Liability ===== | ||
+ | In no event will RepeaterBook be liable with respect to any subject matter of this Agreement under any contract, negligence, strict liability, or other legal or equitable theory for (1) any special, incidental, or consequential damages; (2) the cost of procurement of substitute products or services; or (3) for interruption of use or loss or corruption of data. | ||
+ | |||
+ | ===== General Representations ===== | ||
+ | You hereby warrant that (1) your use of the API will be in strict accordance with the RepeaterBook privacy policy, this Agreement, and all applicable laws and regulations, | ||
+ | |||
+ | ===== Indemnification ===== | ||
+ | You agree to indemnify and hold harmless RepeaterBook, | ||
+ | |||
+ | ===== Miscellaneous ===== | ||
+ | This Agreement constitutes the entire Agreement between RepeaterBook and you concerning the subject matter hereof, and may only be modified by the posting of a revised version on this page by RepeaterBook. | ||
+ | |||
+ | ===== No Waiver of rights ===== | ||
+ | RepeaterBook' | ||
+ | ===== 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. | ||
- | The API is located at [[https:// | ||
- | Repeaterbook.com has an API for querying data. All endpoints are available without authentication and support is listed query string parameters, format parameters, and wildcard operators. | ||
===== North America ===== | ===== North America ===== | ||
Line 43: | Line 106: | ||
* P-25 Capable | * P-25 Capable | ||
* P-25 NAC | * P-25 NAC | ||
+ | * M17 | ||
+ | * M17 CAN | ||
* Tetra Capable | * Tetra Capable | ||
* Tetra MCC | * Tetra MCC | ||
Line 48: | Line 113: | ||
* 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 66: | Line 131: | ||
* 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 84: | Line 150: | ||
- | ===== Sample | + | ===== Sample |
**HTTPS example - US and Canada** | **HTTPS example - US and Canada** | ||
Line 123: | Line 189: | ||
* P-25 Capable | * P-25 Capable | ||
* P-25 NAC | * P-25 NAC | ||
+ | * M17 | ||
+ | * M17 CAN | ||
* Tetra Capable | * Tetra Capable | ||
* Tetra MCC | * Tetra MCC | ||
Line 128: | Line 196: | ||
* 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 146: | Line 214: | ||
- | ===== Output Format Parameter ===== | ||
- | The format is json - Java Script Object Notation | ||
===== Wildcards ===== | ===== Wildcards ===== | ||
Line 170: | Line 236: | ||
* 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 |