What the API is
const url = 'https://api.blupinta.app/v1';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.blupinta.app/v1Where tokens come from, the resource they must be for, the scopes, every operation and where they are explained.
Responses
Section titled “ Responses ”What the API is
GET /v1: what the public API is, for whoever builds an app on it
object
The resource an app’s token must be for (resource when asking it)
Where tokens come from: the OpenID provider
The provider’s discovery document
The scopes /v1 understands, each with what it gives
object
Every operation, as METHOD /path
The OpenAPI document describing every operation
The guide’s page for developers
Example
{ "version": "v1"}Headers
Section titled “Headers”The requests the caller may make in the window: an app counts per connection, every token together
The requests left in the window
Seconds until the window starts again
rate_limited: Too many requests: wait as long as Retry-After says
The body of a refusal
object
What /v1 answers when it refuses
The server’s id for a server_error, to quote when asking for help
What is wrong, for invalid_input, conflict, invalid_home, blocking_problems
Example
{ "error": "unauthenticated"}Headers
Section titled “Headers”The requests the caller may make in the window: an app counts per connection, every token together
The requests left in the window
Seconds until the window starts again
Seconds to wait before asking again
server_error: Something failed on Blupinta’s side: quote errorId when asking for help
The body of a refusal
object
What /v1 answers when it refuses
The server’s id for a server_error, to quote when asking for help
What is wrong, for invalid_input, conflict, invalid_home, blocking_problems
Example
{ "error": "unauthenticated"}Headers
Section titled “Headers”The requests the caller may make in the window: an app counts per connection, every token together
The requests left in the window
Seconds until the window starts again