Search docs…

Authentication Endpoints Documentation

This guide explains how to authenticate with our API using access tokens.

1. Introduction

Clients log in with valid credentials to get an access token for later requests.

2. Authentication Endpoints
2.1. /auth/login
  • Method: POST

  • Description: Log in to get an access token.

  • Parameters:

    • username: User's username.

    • password: User's password.

Example Request:

curl -X POST "https://api.example.com/auth/login" -d "username=user@example.com" -d "password=secret"

Example Response:

{ "access_token": "eyJhbGciOi...", "token_type": "bearer" }
3. Request Methods

Login uses the POST method.

4. Request Parameters
  • For /auth/login:

    • username: username or email.

    • password: User's password.

5. Response Format

JSON with the access token and token type.

6. Error Handling

Errors return an HTTP status code and a message.

7. Sample Requests and Responses

See the examples above.

8. Additional Resources

That's it! Contact our support team if you need help.

Create a free website with Framer, the website builder loved by startups, designers and agencies.