Authentication

{}

{
  "success": true,
  "status": 200,
  "message": "Signed out successfully",
  "data": {
    "message": "Signed out successfully",
    "device": null,
    "platform": null
  },
  "meta": {
    "timestamp": "2025-10-21T12:00:00.000Z",
    "version": "v1"
  }
}

{
  "platform": "app"
}

{
  "device": "mobile",
  "platform": "app"
}

// Configure environment URLs and API keys
const DEV_API_URL = 'https://api-gateway.dev.1houseglobalservices.com';
const PROD_API_URL = 'https://api-gateway.prod.1houseglobalservices.com';

const DEV_API_KEY = 'your-development-api-key';
const PROD_API_KEY = 'your-production-api-key';

// Use appropriate environment
const apiUrl = process.env.NODE_ENV === 'production' ? PROD_API_URL : DEV_API_URL;
const apiKey = process.env.NODE_ENV === 'production' ? PROD_API_KEY : DEV_API_KEY;

// Sign in with platform
const response = await fetch(`${apiUrl}/v1/auth/signin`, {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'password123',
    platform: 'app',          // REQUIRED: app | live-platform | backoffice
    device: 'mobile',          // Optional
    deviceId: 'device-uuid'    // Optional
  })
});

if (!response.ok) {
  const error = await response.json();
  console.error(`Error ${error.errorId}: ${error.message}`);
  // Include errorId in support requests
  throw new Error(error.message);
}

const { data } = await response.json();
const { accessToken, refreshToken, sessionId, platform, platformName } = data;

// Store tokens and session info
localStorage.setItem('accessToken', accessToken);
localStorage.setItem('refreshToken', refreshToken);
localStorage.setItem('sessionId', sessionId);
localStorage.setItem('platform', platform);

// Make authenticated request
const profileResponse = await fetch(`${apiUrl}/v1/user/profile`, {
  headers: {
    'X-API-Key': apiKey,
    'Authorization': `Bearer ${accessToken}`
  }
});

import requests
import os

# Configure environment URLs and API keys
DEV_API_URL = 'https://api-gateway.dev.1houseglobalservices.com'
PROD_API_URL = 'https://api-gateway.prod.1houseglobalservices.com'

DEV_API_KEY = 'your-development-api-key'
PROD_API_KEY = 'your-production-api-key'

# Use appropriate environment
api_url = PROD_API_URL if os.getenv('ENVIRONMENT') == 'production' else DEV_API_URL
api_key = PROD_API_KEY if os.getenv('ENVIRONMENT') == 'production' else DEV_API_KEY

# Sign up with platform
response = requests.post(
    f'{api_url}/v1/auth/signup',
    headers={
        'X-API-Key': api_key,
        'Content-Type': 'application/json'
    },
    json={
        'email': 'user@example.com',
        'password': 'SecurePass123!',
        'firstName': 'John',
        'lastName': 'Doe',
        'platform': 'app',      # REQUIRED
        'device': 'mobile',      # Optional
        'deviceId': 'device-uuid'  # Optional
    }
)

data = response.json()
access_token = data['data']['accessToken']
refresh_token = data['data']['refreshToken']

# Make authenticated request
profile = requests.get(
    f'{api_url}/v1/user/profile',
    headers={
        'X-API-Key': api_key,
        'Authorization': f'Bearer {access_token}'
    }
)

# Development - Sign up with platform
curl -X POST https://api-gateway.dev.1houseglobalservices.com/v1/auth/signup \
  -H "X-API-Key: your-development-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123!",
    "firstName": "John",
    "lastName": "Doe",
    "platform": "app",
    "device": "mobile",
    "deviceId": "device-uuid"
  }'

# Production - Sign up with platform
curl -X POST https://api-gateway.prod.1houseglobalservices.com/v1/auth/signup \
  -H "X-API-Key: your-production-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123!",
    "firstName": "John",
    "lastName": "Doe",
    "platform": "app",
    "device": "mobile",
    "deviceId": "device-uuid"
  }'

# Development - Sign in
curl -X POST https://api-gateway.dev.1houseglobalservices.com/v1/auth/signin \
  -H "X-API-Key: your-development-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "password123",
    "platform": "app"
  }'

# Production - Sign in
curl -X POST https://api-gateway.prod.1houseglobalservices.com/v1/auth/signin \
  -H "X-API-Key: your-production-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePass123!",
    "platform": "app"
  }'