API Documentation

VapeMond OAuth2 API

Build secure authentication flows with VapeMond accounts. Integrate OAuth2 into your application with our comprehensive API documentation and developer tools.

Quick Start Guide View on GitHub

Why Use VapeMond OAuth2?

Let users sign in with their VapeMond accounts—secure, private, and trusted by millions.

Secure by Default

Built on OAuth2 standards with additional security layers. All tokens are encrypted and short-lived.

Easy Integration

Simple REST API with comprehensive documentation. Get started in minutes with our SDKs.

Privacy-First

Users control what data they share. Minimal permissions by default, explicit consent required.

Quick Start

Get up and running with VapeMond OAuth2 in just a few steps.

Register Your Application

Create an OAuth application in the VapeMond Developer Console to get your client credentials.

# Application details you'll receive:

client_id: "your_client_id_here"

client_secret: "your_client_secret_here"

redirect_uri: "https://yourapp.com/callback"

Developer Console

Redirect Users to Authorization

Send users to VapeMond's authorization endpoint with your client ID and requested scopes.

# Authorization URL:

GET https://vapemond.vercel.app/auth/oauth/authorize

# Query parameters:

?client_id=YOUR_CLIENT_ID

&redirect_uri=YOUR_REDIRECT_URI

&response_type=code

&scope=profile email

&state=RANDOM_STRING

Exchange Code for Token

After user authorization, exchange the authorization code for an access token.

# Token exchange request:

POST https://vapemond.vercel.app/auth/oauth/token

# Request body:

{

"client_id": "YOUR_CLIENT_ID",

"client_secret": "YOUR_CLIENT_SECRET",

"code": "AUTHORIZATION_CODE",

"redirect_uri": "YOUR_REDIRECT_URI",

"grant_type": "authorization_code"

}

# Response:

{

"access_token": "eyJhbGc...",

"token_type": "Bearer",

"expires_in": 3600,

"refresh_token": "def50200..."

}

Access User Information

Use the access token to retrieve user information from the API.

# API request:

GET https://vapemond.vercel.app/api/v1/user

# Header:

Authorization: Bearer YOUR_ACCESS_TOKEN

# Response:

{

"id": "user_12345",

"username": "john_doe",

"email": "john@example.com",

"display_name": "John Doe",

"verified": true

}

API Reference

Complete reference for all VapeMond OAuth2 endpoints.

GET/oauth/authorize

Initiates OAuth2 authorization flow

Parameters:

client_idstringRequired

Your application's client ID

redirect_uristringRequired

Callback URL for your application

response_typestringRequired

Must be 'code'

scopestringRequired

Requested permissions (e.g., 'profile email')

statestringRequired

Random string for CSRF protection

POST/oauth/token

Exchanges authorization code for access token

Parameters:

client_idstringRequired

Your application's client ID

client_secretstringRequired

Your application's client secret

codestringRequired

Authorization code from callback

redirect_uristringRequired

Same redirect URI used in authorization

grant_typestringRequired

Must be 'authorization_code'

GET/api/v1/user

Retrieves authenticated user information

Parameters:

AuthorizationheaderRequired

Bearer {access_token}

POST/oauth/revoke

Revokes an access token

Parameters:

tokenstringRequired

Access token to revoke

client_idstringRequired

Your application's client ID

OAuth Scopes

Request only the permissions your application needs. Users see exactly what data you're accessing.

profile

Access to basic profile information (username, display name)

email

Access to user's email address

messages:read

Read access to user's messages (requires additional approval)

messages:write

Send messages on behalf of user (requires additional approval)

Official SDKs

Use our official libraries to integrate VapeMond OAuth2 faster.

Node.js

npm install @vapemond/oauth2

Python

pip install vapemond-oauth2

Ruby

gem install vapemond-oauth2

Need Help?

Our developer support team is here to help you integrate VapeMond OAuth2.

Full Documentation Developer Support

API Documentation

VapeMond OAuth2 API

Build secure authentication flows with VapeMond accounts. Integrate OAuth2 into your application with our comprehensive API documentation and developer tools.

Quick Start Guide View on GitHub

Why Use VapeMond OAuth2?

Let users sign in with their VapeMond accounts—secure, private, and trusted by millions.

Secure by Default

Built on OAuth2 standards with additional security layers. All tokens are encrypted and short-lived.

Easy Integration

Simple REST API with comprehensive documentation. Get started in minutes with our SDKs.

Privacy-First

Users control what data they share. Minimal permissions by default, explicit consent required.

Quick Start

Get up and running with VapeMond OAuth2 in just a few steps.

Register Your Application

Create an OAuth application in the VapeMond Developer Console to get your client credentials.

# Application details you'll receive:

client_id: "your_client_id_here"

client_secret: "your_client_secret_here"

redirect_uri: "https://yourapp.com/callback"

Developer Console

Redirect Users to Authorization

Send users to VapeMond's authorization endpoint with your client ID and requested scopes.

# Authorization URL:

GET https://vapemond.vercel.app/auth/oauth/authorize

# Query parameters:

?client_id=YOUR_CLIENT_ID

&redirect_uri=YOUR_REDIRECT_URI

&response_type=code

&scope=profile email

&state=RANDOM_STRING

Exchange Code for Token

After user authorization, exchange the authorization code for an access token.

# Token exchange request:

POST https://vapemond.vercel.app/auth/oauth/token

# Request body:

{

"client_id": "YOUR_CLIENT_ID",

"client_secret": "YOUR_CLIENT_SECRET",

"code": "AUTHORIZATION_CODE",

"redirect_uri": "YOUR_REDIRECT_URI",

"grant_type": "authorization_code"

}

# Response:

{

"access_token": "eyJhbGc...",

"token_type": "Bearer",

"expires_in": 3600,

"refresh_token": "def50200..."

}

Access User Information

Use the access token to retrieve user information from the API.

# API request:

GET https://vapemond.vercel.app/api/v1/user

# Header:

Authorization: Bearer YOUR_ACCESS_TOKEN

# Response:

{

"id": "user_12345",

"username": "john_doe",

"email": "john@example.com",

"display_name": "John Doe",

"verified": true

}

API Reference

Complete reference for all VapeMond OAuth2 endpoints.

GET/oauth/authorize

Initiates OAuth2 authorization flow

Parameters:

client_idstringRequired

Your application's client ID

redirect_uristringRequired

Callback URL for your application

response_typestringRequired

Must be 'code'

scopestringRequired

Requested permissions (e.g., 'profile email')

statestringRequired

Random string for CSRF protection

POST/oauth/token

Exchanges authorization code for access token

Parameters:

client_idstringRequired

Your application's client ID

client_secretstringRequired

Your application's client secret

codestringRequired

Authorization code from callback

redirect_uristringRequired

Same redirect URI used in authorization

grant_typestringRequired

Must be 'authorization_code'

GET/api/v1/user

Retrieves authenticated user information

Parameters:

AuthorizationheaderRequired

Bearer {access_token}

POST/oauth/revoke

Revokes an access token

Parameters:

tokenstringRequired

Access token to revoke

client_idstringRequired

Your application's client ID

OAuth Scopes

Request only the permissions your application needs. Users see exactly what data you're accessing.

profile

Access to basic profile information (username, display name)

email

Access to user's email address

messages:read

Read access to user's messages (requires additional approval)

messages:write

Send messages on behalf of user (requires additional approval)

Official SDKs

Use our official libraries to integrate VapeMond OAuth2 faster.

Node.js

npm install @vapemond/oauth2

Python

pip install vapemond-oauth2

Ruby

gem install vapemond-oauth2

Need Help?

Our developer support team is here to help you integrate VapeMond OAuth2.

Full Documentation Developer Support