Routes API

Rutas, peticiones y alertas dentro de la API

PreviousSeguridad NextRateLimit

Last updated 8 days ago

Get a task by ID

get

Returns the details of a specific task

Path parameters

idstringRequired

Task ID

Responses

application/json

objectOptional

application/json

get

GET /api/v1/service/tasks/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Reunión mensual",
  "description": "Discutir presupuesto",
  "createdBy": "usuario123",
  "createdAt": "2024-01-20T10:00:00Z",
  "dueDate": "2024-01-25T15:30:00Z",
  "status": "pending",
  "priority": "high",
  "tags": [
    "trabajo",
    "finanzas"
  ],
  "reminder": {
    "enabled": true,
    "timeBefore": "30 minutes",
    "notified": false
  },
  "recurrence": {
    "type": "monthly",
    "interval": 1,
    "endDate": "2024-12-31T23:59:59Z",
    "times": 3
  },
  "autoDelete": "2024-12-31T23:59:59Z",
  "updatedAt": "2024-01-20T10:00:00Z",
  "completedAt": "2025-04-18T18:42:40.975Z"
}

Retrieve Recent Discord Data

get

Fetch recent data from Discord, including the current status, updates, and incidents from the last 24 hours.

Responses

application/json

objectOptional

get

GET /api/v1/public/api/v1/discord/recent HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

{
  "data": {
    "incidents": [
      {
        "title": "Server outage",
        "summary": "A server outage is affecting some users...",
        "link": "https://status.discord.com/incidents/12345",
        "date": "2024-08-30T14:53:44.077Z",
        "type": "incident"
      }
    ],
    "status": {
      "status": "operational",
      "message": "All systems operational",
      "lastUpdated": "2024-08-30T14:53:44.077Z"
    },
    "updates": [
      {
        "title": "New feature announcement",
        "summary": "Discord has introduced a new feature...",
        "link": "https://discord.com/blog/new-feature",
        "date": "2024-08-30T14:53:44.077Z",
        "type": "announcement"
      }
    ]
  },
  "errors": null
}

Retrieve Active Discord Incidents

get

Fetch a list of active incidents reported by Discord. Incidents include service disruptions or outages that are currently unresolved.

Responses

application/json

object[]Optional

get

GET /api/v1/public/api/v1/discord/incidents HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

[
  {
    "title": "Server outage",
    "summary": "A server outage is affecting some users...",
    "link": "https://status.discord.com/incidents/12345",
    "date": "2024-08-30T14:53:44.077Z",
    "type": "incident"
  }
]

Retrieve Recent Discord Updates

get

Fetch a list of recent updates published by Discord. These updates may include announcements, feature releases, or general updates.

Responses

application/json

object[]Optional

get

GET /api/v1/public/api/v1/discord/updates HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

[
  {
    "title": "New feature announcement",
    "summary": "Discord has introduced a new feature...",
    "link": "https://discord.com/blog/new-feature",
    "date": "2024-08-30T14:53:44.077Z",
    "type": "announcement"
  }
]

Retrieve Discord Service Status

get

Fetch the current operational status of Discord's services. This endpoint provides real-time information about whether Discord is operational, degraded, or experiencing an outage.

Responses

application/json

objectOptional

get

GET /api/v1/public/api/v1/discord/status HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

{
  "status": "operational",
  "message": "All systems operational",
  "lastUpdated": "2024-08-30T14:53:44.077Z"
}

Get IP address information

get

Retrieve security information about a specific IP address including block status and related activity

Authorizations

Path parameters

ipAddressstring · ipv4Required

IP address to query

Example: 192.168.1.100

Responses

application/json

objectOptional

get

GET /api/v1/security/ip-info/{ipAddress} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer JWT
Accept: */*

{
  "ipAddress": "192.168.1.100",
  "isBlocked": true,
  "blockedInfo": {
    "ipAddress": "192.168.1.100",
    "reason": "Multiple failed login attempts",
    "blockedAt": "2023-01-15T10:30:00Z",
    "expiresAt": "2023-02-15T10:30:00Z",
    "blockedBy": {
      "id": "5f8d04b3ab35de3a342f3a5d",
      "name": "Admin User",
      "email": "admin@example.com"
    }
  },
  "failedAttempts": 3,
  "licenseUsage": [
    {
      "licenseId": "5f8d04b3ab35de3a342f3a5b",
      "type": "PREMIUM",
      "lastUsedAt": "2023-01-20T14:30:00Z"
    }
  ]
}

Get license information

get

Retrieve detailed information about a specific license including associated IPs and usage statistics

Authorizations

Path parameters

licenseKeystringRequired

Unique license key identifier

Example: 5f8d04b3ab35de3a342f3a5b

Responses

application/json

objectOptional

get

GET /api/v1/security/license-info/{licenseKey} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer JWT
Accept: */*

{
  "license": {
    "id": "507f1f77bcf86cd799439013",
    "type": "PREMIUM",
    "userId": "507f1f77bcf86cd799439011",
    "adminId": "507f1f77bcf86cd799439012",
    "hwid": [
      "HWID12345"
    ],
    "requestLimit": 5000,
    "requestCount": 42,
    "validFrom": "2023-01-01T00:00:00Z",
    "validUntil": "2024-12-31T23:59:59Z",
    "status": "ACTIVE",
    "createdAt": "2023-01-01T00:00:00Z",
    "updatedAt": "2023-01-02T00:00:00Z"
  },
  "blockedIPs": [
    {
      "ipAddress": "192.168.1.100",
      "reason": "Multiple failed login attempts",
      "blockedAt": "2023-01-15T10:30:00Z",
      "expiresAt": "2023-02-15T10:30:00Z",
      "blockedBy": {
        "id": "5f8d04b3ab35de3a342f3a5d",
        "name": "Admin User",
        "email": "admin@example.com"
      }
    }
  ],
  "usageStats": {
    "requestCount": 342,
    "requestLimit": 1000,
    "lastUsedAt": "2023-01-20T14:30:00Z",
    "lastUsedIp": "192.168.1.150"
  }
}

Get system status

get

Retrieve the current status of the system, including uptime and health checks.

Responses

application/json

objectOptional

application/json

get

GET /api/v1/public/status HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

{
  "status": "operational",
  "uptime": 15.3353802,
  "database": {
    "status": "healthy",
    "responseTime": "283ms"
  },
  "system": {
    "platform": "win32",
    "arch": "x64",
    "nodeVersion": "v20.18.0",
    "memoryUsage": {
      "rss": 113950720,
      "heapTotal": 61710336,
      "heapUsed": 40272096,
      "external": 2482539,
      "arrayBuffers": 53510
    },
    "uptime": 15.0516304,
    "cpuUsage": {
      "user": 3375000,
      "system": 7078000
    },
    "systemLoad": [
      0,
      0,
      0
    ],
    "freeMemory": 3459817472,
    "totalMemory": 14861852672
  },
  "meta": {
    "apiVersion": "1.0.0",
    "environment": "development",
    "startTime": "2025-03-30T11:21:25.486Z"
  }
}

Get user data from the API.

get

Retrieve user data from the API using the provided JWT token.

Authorizations

Path parameters

idstringRequired

ID of the user to retrieve.

Example: userId123

Header parameters

AuthorizationstringRequired

JWT token for authentication.

Responses

application/json

objectOptional

application/json

get

GET /api/v1/auth/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: text
Accept: */*

{
  "id": "userId123",
  "discord": "123456789",
  "name": "John Doe",
  "createdAt": "2024-08-30T14:53:44.077Z",
  "rol": "user",
  "email": "user@example.com",
  "password": "hashed-password"
}

Validate a license key

post

Check if a license key is valid and meets all requirements

Path parameters

keystringRequired

License key to validate

Example: LIC-123-456-789

Query parameters

hwidstringRequired

Hardware ID to validate against

Example: HWID12345

Responses

application/json

objectOptional

application/json

post

POST /api/v1/license/validate/{key} HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

{
  "valid": true,
  "remainingRequests": 4958,
  "expiresAt": "2024-12-31T23:59:59Z"
}

Delete a license

delete

Permanently remove a license from the system

Authorizations

Path parameters

idstringRequired

License ID

Example: 507f1f77bcf86cd799439013

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer your.jwt.token.here

Responses

application/json

delete

DELETE /api/v1/license/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer your.jwt.token.here
Accept: */*

No content

Get license details

get

Retrieve detailed information about a specific license

Authorizations

Path parameters

idstringRequired

License ID

Example: 507f1f77bcf86cd799439013

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer your.jwt.token.here

Responses

application/json

objectOptional

application/json

get

GET /api/v1/license/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer your.jwt.token.here
Accept: */*

{
  "message": "License created successfully",
  "data": {
    "id": "507f1f77bcf86cd799439013",
    "type": "PREMIUM",
    "userId": "507f1f77bcf86cd799439011",
    "adminId": "507f1f77bcf86cd799439012",
    "hwid": [
      "HWID12345"
    ],
    "requestLimit": 5000,
    "requestCount": 42,
    "validFrom": "2023-01-01T00:00:00Z",
    "validUntil": "2024-12-31T23:59:59Z",
    "status": "ACTIVE",
    "createdAt": "2023-01-01T00:00:00Z",
    "updatedAt": "2023-01-02T00:00:00Z"
  }
}

List all licenses

get

Retrieve a list of all licenses in the system

Authorizations

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer your.jwt.token.here

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/license HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer your.jwt.token.here
Accept: */*

[
  {
    "id": "507f1f77bcf86cd799439013",
    "type": "PREMIUM",
    "userId": "507f1f77bcf86cd799439011",
    "adminId": "507f1f77bcf86cd799439012",
    "hwid": [
      "HWID12345"
    ],
    "requestLimit": 5000,
    "requestCount": 42,
    "validFrom": "2023-01-01T00:00:00Z",
    "validUntil": "2024-12-31T23:59:59Z",
    "status": "ACTIVE",
    "createdAt": "2023-01-01T00:00:00Z",
    "updatedAt": "2023-01-02T00:00:00Z"
  }
]

List blocked IP addresses

get

Returns a paginated list of currently blocked IP addresses in the system

Authorizations

Query parameters

pageinteger · min: 1Optional

Page number to retrieve (pagination)

Default: 1

limitinteger · min: 1 · max: 100Optional

Maximum number of results per page

Default: 20

Responses

application/json

object[]Optional

get

GET /api/v1/admin/blocked-ips HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer JWT
Accept: */*

200

Successfully retrieved blocked IP list

[
  {
    "ipAddress": "192.168.1.100",
    "blockedAt": "2023-01-15T10:30:00Z",
    "reason": "Brute force attack attempt",
    "expiresAt": "2023-02-15T10:30:00Z",
    "blockedBy": "admin@domain.com"
  }
]

Unblock an IP address

delete

Removes an IP address from the active block list

Authorizations

Path parameters

ipAddressstring · ipv4Required

IP address to be unblocked

Example: 192.168.1.100

Responses

application/json

objectOptional

delete

DELETE /api/v1/admin/unblock-ip/{ipAddress} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer JWT
Accept: */*

{
  "success": true,
  "message": "IP unblocked successfully"
}

Get upcoming reminders

get

Returns a list of reminders that are about to be triggered

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/service/reminders HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

[
  {
    "id": "507f1f77bcf86cd799439011",
    "title": "Reunión mensual",
    "description": "Discutir presupuesto",
    "createdBy": "usuario123",
    "createdAt": "2024-01-20T10:00:00Z",
    "dueDate": "2024-01-25T15:30:00Z",
    "status": "pending",
    "priority": "high",
    "tags": [
      "trabajo",
      "finanzas"
    ],
    "reminder": {
      "enabled": true,
      "timeBefore": "30 minutes",
      "notified": false
    },
    "recurrence": {
      "type": "monthly",
      "interval": 1,
      "endDate": "2024-12-31T23:59:59Z",
      "times": 3
    },
    "autoDelete": "2024-12-31T23:59:59Z",
    "updatedAt": "2024-01-20T10:00:00Z",
    "completedAt": "2025-04-18T18:42:40.975Z"
  }
]

Delete a task

delete

Permanently deletes a task

Path parameters

idstringRequired

Task ID

Responses

application/json

delete

DELETE /api/v1/service/tasks/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

No content

Get all tasks

get

Returns a list of tasks with filtering options

Query parameters

statusstring · enumOptional

Filter by task status

Available options:

prioritystring · enumOptional

Filter by priority

Available options:

createdBystringOptional

Filter by creator ID

tagstringOptional

Filter by tag

Responses

application/json

object[]Optional

application/json

get

GET /api/v1/service/tasks HTTP/1.1
Host: admin.hiroshi-dev.me
Accept: */*

[
  {
    "id": "507f1f77bcf86cd799439011",
    "title": "Reunión mensual",
    "description": "Discutir presupuesto",
    "createdBy": "usuario123",
    "createdAt": "2024-01-20T10:00:00Z",
    "dueDate": "2024-01-25T15:30:00Z",
    "status": "pending",
    "priority": "high",
    "tags": [
      "trabajo",
      "finanzas"
    ],
    "reminder": {
      "enabled": true,
      "timeBefore": "30 minutes",
      "notified": false
    },
    "recurrence": {
      "type": "monthly",
      "interval": 1,
      "endDate": "2024-12-31T23:59:59Z",
      "times": 3
    },
    "autoDelete": "2024-12-31T23:59:59Z",
    "updatedAt": "2024-01-20T10:00:00Z",
    "completedAt": "2025-04-18T18:42:40.975Z"
  }
]

Create a new task

post

Creates a task with the provided data

Body

titlestringRequiredExample: Reunión mensual

descriptionstringOptionalExample: Discutir presupuesto

createdBystringRequiredExample: usuario123

dueDatestring · date-timeOptionalExample: 2024-01-25T15:30:00Z

statusstring · enumOptionalDefault: pendingExample: pendingAvailable options:

prioritystring · enumOptionalDefault: mediumExample: highAvailable options:

tagsstring[]OptionalExample: ["trabajo","finanzas"]

reminderobjectOptional

recurrenceobjectOptional

autoDeletestring · date-timeOptionalExample: 2024-12-31T23:59:59Z

Responses

application/json

objectOptional

application/json

post

POST /api/v1/service/tasks HTTP/1.1
Host: admin.hiroshi-dev.me
Content-Type: application/json
Accept: */*
Content-Length: 385

{
  "title": "Reunión mensual",
  "description": "Discutir presupuesto",
  "createdBy": "usuario123",
  "dueDate": "2024-01-25T15:30:00Z",
  "status": "pending",
  "priority": "high",
  "tags": [
    "trabajo",
    "finanzas"
  ],
  "reminder": {
    "enabled": true,
    "timeBefore": "30 minutes",
    "notified": false
  },
  "recurrence": {
    "type": "monthly",
    "interval": 1,
    "endDate": "2024-12-31T23:59:59Z",
    "times": 3
  },
  "autoDelete": "2024-12-31T23:59:59Z"
}

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Reunión mensual",
  "description": "Discutir presupuesto",
  "createdBy": "usuario123",
  "createdAt": "2024-01-20T10:00:00Z",
  "dueDate": "2024-01-25T15:30:00Z",
  "status": "pending",
  "priority": "high",
  "tags": [
    "trabajo",
    "finanzas"
  ],
  "reminder": {
    "enabled": true,
    "timeBefore": "30 minutes",
    "notified": false
  },
  "recurrence": {
    "type": "monthly",
    "interval": 1,
    "endDate": "2024-12-31T23:59:59Z",
    "times": 3
  },
  "autoDelete": "2024-12-31T23:59:59Z",
  "updatedAt": "2024-01-20T10:00:00Z",
  "completedAt": "2025-04-18T18:42:40.975Z"
}

Update a task

patch

Updates the specified fields of a task

Path parameters

idstringRequired

Task ID

Body

titlestringOptionalExample: Reunión mensual actualizada

descriptionstringOptionalExample: Discutir presupuesto y proyecciones

dueDatestring · date-timeOptionalExample: 2024-01-26T15:30:00Z

statusstring · enumOptionalExample: completedAvailable options:

prioritystring · enumOptionalExample: mediumAvailable options:

tagsstring[]OptionalExample: ["trabajo","finanzas","importante"]

reminderobjectOptional

recurrenceobjectOptional

autoDeletestring · date-timeOptionalExample: 2024-12-31T23:59:59Z

Responses

application/json

objectOptional

application/json

patch

PATCH /api/v1/service/tasks/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Content-Type: application/json
Accept: */*
Content-Length: 404

{
  "title": "Reunión mensual actualizada",
  "description": "Discutir presupuesto y proyecciones",
  "dueDate": "2024-01-26T15:30:00Z",
  "status": "completed",
  "priority": "medium",
  "tags": [
    "trabajo",
    "finanzas",
    "importante"
  ],
  "reminder": {
    "enabled": true,
    "timeBefore": "30 minutes",
    "notified": false
  },
  "recurrence": {
    "type": "monthly",
    "interval": 1,
    "endDate": "2024-12-31T23:59:59Z",
    "times": 3
  },
  "autoDelete": "2024-12-31T23:59:59Z"
}

{
  "id": "507f1f77bcf86cd799439011",
  "title": "Reunión mensual",
  "description": "Discutir presupuesto",
  "createdBy": "usuario123",
  "createdAt": "2024-01-20T10:00:00Z",
  "dueDate": "2024-01-25T15:30:00Z",
  "status": "pending",
  "priority": "high",
  "tags": [
    "trabajo",
    "finanzas"
  ],
  "reminder": {
    "enabled": true,
    "timeBefore": "30 minutes",
    "notified": false
  },
  "recurrence": {
    "type": "monthly",
    "interval": 1,
    "endDate": "2024-12-31T23:59:59Z",
    "times": 3
  },
  "autoDelete": "2024-12-31T23:59:59Z",
  "updatedAt": "2024-01-20T10:00:00Z",
  "completedAt": "2025-04-18T18:42:40.975Z"
}

post

Authenticate a user and return a JWT token for subsequent requests.

Body

emailstringOptionalExample: user@example.com

passwordstringOptionalExample: secure-password

Responses

application/json

objectOptional

application/json

post

POST /api/v1/auth/login HTTP/1.1
Host: admin.hiroshi-dev.me
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "email": "user@example.com",
  "password": "secure-password"
}

{
  "id": "userId123",
  "email": "user@example.com",
  "name": "John Doe",
  "discord": "123456789",
  "token": "jwt-token-123"
}

Register a user in the API.

post

Body

emailstringOptionalExample: user@example.com

passwordstringOptionalExample: secure-password

namestringOptionalExample: John Doe

discordstringOptionalExample: 123456789

Responses

application/json

objectOptional

application/json

post

POST /api/v1/auth/register HTTP/1.1
Host: admin.hiroshi-dev.me
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "email": "user@example.com",
  "password": "secure-password",
  "name": "John Doe",
  "discord": "123456789"
}

{
  "id": "userId123",
  "email": "user@example.com",
  "name": "John Doe",
  "discord": "123456789"
}

Update a license

put

Update license properties

Authorizations

Path parameters

idstringRequired

License ID

Example: 507f1f77bcf86cd799439013

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer your.jwt.token.here

Body

hwidstring[]Optional

Updated list of hardware IDs

Example: ["HWID12345","HWID67890"]

requestLimitintegerOptional

New request limit

Example: 10000

validUntilstring · date-timeOptional

New expiration date

Example: 2025-12-31T23:59:59Z

statusstring · enumOptionalExample: ACTIVEAvailable options:

Responses

application/json

objectOptional

application/json

put

PUT /api/v1/license/{id} HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer your.jwt.token.here
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "hwid": [
    "HWID12345",
    "HWID67890"
  ],
  "requestLimit": 10000,
  "validUntil": "2025-12-31T23:59:59Z",
  "status": "ACTIVE"
}

{
  "message": "License created successfully",
  "data": {
    "id": "507f1f77bcf86cd799439013",
    "type": "PREMIUM",
    "userId": "507f1f77bcf86cd799439011",
    "adminId": "507f1f77bcf86cd799439012",
    "hwid": [
      "HWID12345"
    ],
    "requestLimit": 5000,
    "requestCount": 42,
    "validFrom": "2023-01-01T00:00:00Z",
    "validUntil": "2024-12-31T23:59:59Z",
    "status": "ACTIVE",
    "createdAt": "2023-01-01T00:00:00Z",
    "updatedAt": "2023-01-02T00:00:00Z"
  }
}

Create a new license

post

Creates a new software license with specified parameters. Requires admin privileges.

Authorizations

Header parameters

AuthorizationstringRequired

Bearer token for authentication

Example: Bearer your.jwt.token.here

Body

typestring · enumRequiredExample: PREMIUMAvailable options:

userIdstringRequired

ID of user this license is assigned to

Example: 507f1f77bcf86cd799439011

adminIdstringRequired

ID of admin creating the license

Example: 507f1f77bcf86cd799439012

hwidstring[]Required

List of allowed hardware IDs

Example: ["HWID12345"]

requestLimitintegerOptional

Maximum allowed API requests

Default: 1000Example: 5000

validUntilstring · date-timeRequired

Expiration date

Example: 2024-12-31T23:59:59Z

metadataobjectOptional

Additional custom data

Example: {"features":["premium","api-access"]}

Responses

application/json

objectOptional

application/json

post

POST /api/v1/license HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer your.jwt.token.here
Content-Type: application/json
Accept: */*
Content-Length: 217

{
  "type": "PREMIUM",
  "userId": "507f1f77bcf86cd799439011",
  "adminId": "507f1f77bcf86cd799439012",
  "hwid": [
    "HWID12345"
  ],
  "requestLimit": 5000,
  "validUntil": "2024-12-31T23:59:59Z",
  "metadata": {
    "features": [
      "premium",
      "api-access"
    ]
  }
}

{
  "message": "License created successfully",
  "data": {
    "id": "507f1f77bcf86cd799439013",
    "type": "PREMIUM",
    "userId": "507f1f77bcf86cd799439011",
    "adminId": "507f1f77bcf86cd799439012",
    "hwid": [
      "HWID12345"
    ],
    "requestLimit": 5000,
    "requestCount": 42,
    "validFrom": "2023-01-01T00:00:00Z",
    "validUntil": "2024-12-31T23:59:59Z",
    "status": "ACTIVE",
    "createdAt": "2023-01-01T00:00:00Z",
    "updatedAt": "2023-01-02T00:00:00Z"
  }
}

Block an IP address

post

Adds an IP address to the system's block list

Authorizations

Body

ipAddressstring · ipv4Required

IP address to be blocked

Example: 192.168.1.100

reasonstringOptional

Reason for blocking (for audit logs)

Example: Multiple failed login attempts

userIdstringOptional

ID of the user performing the block (optional)

Example: 507f1f77bcf86cd799439011

expiresAtstring · date-timeOptional

Expiration date/time for automatic unblock (optional)

Example: 2023-12-31T23:59:59Z

Responses

application/json

objectOptional

post

POST /api/v1/admin/block-ip HTTP/1.1
Host: admin.hiroshi-dev.me
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "ipAddress": "192.168.1.100",
  "reason": "Multiple failed login attempts",
  "userId": "507f1f77bcf86cd799439011",
  "expiresAt": "2023-12-31T23:59:59Z"
}

{
  "success": true,
  "message": "IP blocked successfully"
}

Process combined text and file with Gemini

post

Send both text and a file to Gemini for combined processing

Header parameters

x-gemini-api-keystringRequired

Google Gemini API Key

Example: AIzaSyD...xyz

x-gemini-modelstring · enumRequired

Gemini model to use

Example: gemini-1.5-proAvailable options:

Body

filestring · binaryOptional

File to process (PDF, DOCX, etc.)

textstringOptional

Text related to the file

Example: Based on this document, what are the key points?

systemInstructionstringOptional

System instruction to configure Gemini's behavior

Example: You are a document analysis expert

Responses

application/json

objectOptional

post

POST /api/v1/service/google/model-ai/combined HTTP/1.1
Host: admin.hiroshi-dev.me
x-gemini-api-key: AIzaSyD...xyz
x-gemini-model: gemini-1.5-pro
Content-Type: multipart/form-data
Accept: */*
Content-Length: 132

{
  "file": "binary",
  "text": "Based on this document, what are the key points?",
  "systemInstruction": "You are a document analysis expert"
}

{
  "response": "Artificial intelligence is...",
  "model": "gemini-1.5-pro",
  "timestamp": "2025-04-18T18:42:40.975Z"
}

Process file with Gemini

post

Send a file to Gemini for processing

Header parameters

x-gemini-api-keystringRequired

Google Gemini API Key

Example: AIzaSyD...xyz

x-gemini-modelstring · enumRequired

Gemini model to use

Example: gemini-1.5-proAvailable options:

Body

filestring · binaryOptional

File to process (PDF, DOCX, etc.)

textstringOptional

Instructions/prompt to process the file

Example: Summarize this document

systemInstructionstringOptional

System instruction to configure Gemini's behavior

Example: You are an academic assistant specialized in summarizing documents

Responses

application/json

objectOptional

post

POST /api/v1/service/google/model-ai/file HTTP/1.1
Host: admin.hiroshi-dev.me
x-gemini-api-key: AIzaSyD...xyz
x-gemini-model: gemini-1.5-pro
Content-Type: multipart/form-data
Accept: */*
Content-Length: 139

{
  "file": "binary",
  "text": "Summarize this document",
  "systemInstruction": "You are an academic assistant specialized in summarizing documents"
}

{
  "response": "Artificial intelligence is...",
  "model": "gemini-1.5-pro",
  "timestamp": "2025-04-18T18:42:40.975Z"
}

Process text with Gemini

post

Send text to Gemini for processing

Header parameters

x-gemini-api-keystringRequired

Google Gemini API Key

Example: AIzaSyD...xyz

x-gemini-modelstring · enumRequired

Gemini model to use

Example: gemini-1.5-proAvailable options:

Body

textstringRequired

Text to be processed

Example: Explain the concept of artificial intelligence

systemInstructionstringOptional

System instruction to configure Gemini's behavior

Example: You are a university professor explaining technical concepts

Responses

application/json

objectOptional

post

POST /api/v1/service/google/model-ai/text HTTP/1.1
Host: admin.hiroshi-dev.me
x-gemini-api-key: AIzaSyD...xyz
x-gemini-model: gemini-1.5-pro
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "text": "Explain the concept of artificial intelligence",
  "systemInstruction": "You are a university professor explaining technical concepts"
}

{
  "response": "Artificial intelligence is...",
  "model": "gemini-1.5-pro",
  "timestamp": "2025-04-18T18:42:40.975Z"
}

Get a task by ID

Retrieve Recent Discord Data

Retrieve Active Discord Incidents

Retrieve Recent Discord Updates

Retrieve Discord Service Status

Get IP address information

Get license information

Get system status

Get user data from the API.

Validate a license key

Delete a license

Get license details

List all licenses

List blocked IP addresses

Unblock an IP address

Get upcoming reminders

Delete a task

Get all tasks

Create a new task

Update a task

Login a user in the API.

Register a user in the API.

Update a license

Create a new license

Block an IP address

Process combined text and file with Gemini

Process file with Gemini

Process text with Gemini