SubManager

Validation API

Call this endpoint before creating a new user in your application to verify if the subscription limit has been reached.

Authentication

Every request must include the api_key and the domain associated with the project.

Request Payload

{
    "api_key": "YOUR_16_DIGIT_KEY",
    "domain": "yourdomain.com"
}

Success Response (HTTP 200)

{
    "status": "success",
    "allowed": true,
    "message": "User creation allowed.",
    "data": {
        "service_id": 12,
        "type": "standard",
        "limit": 100,
        "current": 45,
        "expiry": "2025-12-31"
    }
}

Error Response (HTTP 403)

{
    "status": "error",
    "allowed": false,
    "message": "Subscription limit reached or expired.",
    "data": {
        "limit": 100,
        "current": 100,
        "expiry": "2025-12-31"
    }
}

User Registration API

Call this endpoint after successfully creating a user on your side to sync the count with the subscription module. This will automatically increment the active user count.

Request Payload

{
    "api_key": "YOUR_16_DIGIT_KEY",
    "domain": "yourdomain.com",
    "username": "john_doe",
    "email": "john@example.com"
}

Success Response (HTTP 200)

{
    "status": "success",
    "message": "User registered successfully.",
    "data": {
        "id": 105,
        "username": "john_doe",
        "service_id": 12,
        "new_count": 46
    }
}