Register & Login

The unified authentication endpoint handles both user registration and login.

Register a New User

To create a new account, set action to register:

curl -X POST https://fucksornot.com/api/auth \
  -H "Content-Type: application/json" \
  -d '{
    "action": "register",
    "email": "user@example.com",
    "username": "johndoe",
    "password": "SecurePassword123!"
  }'

const response = await fetch('https://fucksornot.com/api/auth', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    action: 'register',
    email: 'user@example.com',
    username: 'johndoe',
    password: 'SecurePassword123!'
  })
});

Validation Rules

Field	Rules
`email`	Valid email format
`username`	3-30 characters, alphanumeric and underscore only
`password`	Minimum 8 characters, complexity requirements

To authenticate an existing user, set action to login:

curl -X POST https://fucksornot.com/api/auth \
  -H "Content-Type: application/json" \
  -d '{
    "action": "login",
    "email": "user@example.com",
    "password": "SecurePassword123!"
  }'

const response = await fetch('https://fucksornot.com/api/auth', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    action: 'login',
    email: 'user@example.com',
    password: 'SecurePassword123!'
  })
});

With MFA

If MFA is enabled, include the code:

{
  "action": "login",
  "email": "user@example.com",
  "password": "SecurePassword123!",
  "mfaCode": "123456"
}

Response

{
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "username": "johndoe",
    "email": "user@example.com"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "mfaRequired": false
}

If MFA is required but not provided:

{
  "mfaRequired": true,
  "userId": "user-uuid"
}

Rate Limiting

This endpoint is rate limited to 10 attempts per 15 minutes per IP address.

Overview

Authentication

Uploads

Voting

Tags

Media

User

Register a New User

Validation Rules

With MFA

Response

Rate Limiting

​Register a New User

​Validation Rules

​Login

​With MFA

​Response

​Rate Limiting

Register a New User

Validation Rules

Login

With MFA

Response

Rate Limiting