API overview
The RESTful API provides programmatic access to bnder. Please read the following instructions to get started. If you have any questions or suggestions feel free to contact us on our Discord.
Endpoints described in this documentation begin with the following:
Requests must have the 'Content-Type': 'application/json' header.
Please set a custom User-Agent header in your requests. This helps us to identify the source of the requests.
Getting started
Using API keys to get access
To get access to the API you have to generate your own API key.
To do that, open the app, click on your profile picture in the upper right, open settings, click on “Development”. There you see a section with your registered servers.
Generate the API Key
Click on the plus icon and select the server for which you want to generate an api key. You have to be the server owner to generate an api key. The key can only be used to access the server it is registered for.
Use the key in a request
Send the api key in the request header like this: authorization: Bearer YOUR_TOKEN.
Examples
const url = "https://api.bnder.net/consumer/v1/...";
const apiKey = "YOUR_API_KEY";
fetch(url, {
method: 'GET', // or 'POST', 'PUT', 'DELETE', etc.
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${apiKey}`,
'User-Agent': 'YOUR_USER_AGENT'
}
})
.then(res => res.json())
.then(data => {
// Handle response
})
.catch(err => {
// Handle error
});