Bot API

v1.0

Live API

Nexus Bot API

Complete bot integration for creating, managing and scaling intelligent bots on Nexus.

Endpoints

8

Authentication

Bearer Token

Base URL

anonixs.pp.ua

Version

v1

Authentication

Bearer Token

All requests require an Authorization header with your bot token:

Authorization: Bearer <BOT_TOKEN>

Scoped Tokens

  • Short-lived access + refresh token
  • Replay protection
  • Rate limits per token

Error Codes

200
OK
400
Bad Request
401
Invalid token
403
Forbidden
404
Not found
429
Too many requests
500
Server error

API Endpoints

POST

/sendMessage

Send text message with support for reply, forward, inline keyboards and comments

Rate Limit:
30/sec
View Payload
{
  "chat_id": "string|int",
  "text": "string",
  "parse_mode": "HTML | Markdown",
  "reply_to_message_id": 123,
  "forward_from": 456,
  "disable_notification": false,
  "keyboard": {
    "inline": true,
    "buttons": [
      {"text": "Button", "url": "https://example.com"}
    ]
  },
  "language": "auto | en | ru | uk | es",
  "comments_enabled": true
}
POST

/sendPhoto

Send photo message

Rate Limit:
10/sec
View Payload
{
  "chat_id": "string|int",
  "photo": "<file_id | URL | base64>",
  "caption": "string",
  "parse_mode": "HTML | Markdown",
  "reply_to_message_id": 123,
  "disable_notification": false
}
POST

/sendFile

Send file message

Rate Limit:
10/sec
View Payload
{
  "chat_id": "string|int",
  "file": "<file_id | URL | base64>",
  "filename": "string",
  "caption": "string",
  "reply_to_message_id": 123,
  "disable_notification": false
}
POST

/editMessage

Edit message text

Rate Limit:
10/sec
View Payload
{
  "chat_id": "string|int",
  "message_id": 123,
  "text": "new text",
  "parse_mode": "HTML | Markdown",
  "disable_notification": false
}
POST

/deleteMessage

Delete message

Rate Limit:
10/sec
View Payload
{
  "chat_id": "string|int",
  "message_id": 123
}
GET

/getUpdates

Get new events with long-polling support

Rate Limit:
1/sec
View Parameters
Query Parameters:
- offset: int
- limit: int (max 100)
- timeout: int (seconds for long-poll)
POST

/setWebhook

Configure webhook with HMAC signature and IP allowlist

Security:
HMAC-SHA256
View Payload
{
  "url": "https://example.com/webhook",
  "max_connections": 50,
  "allowed_updates": ["message", "reaction", "call"]
}
GET

/getMe

Get bot information

View Response
{
  "id": "bot123",
  "username": "my_bot",
  "name": "My Bot",
  "verified": true
}

Security & Anti-Abuse

Rate Limiting

  • Per endpoint and token
  • Burst requests allowed
  • Exponential backoff recommended

New Account Limits

  • ≤10 users per 10 minutes
  • Verified/VIP accounts exempt
  • CAPTCHA after N attempts

Replay Protection

  • Nonce validation
  • Timestamp check (±5min)
  • Token rotation support

Trust Scoring

  • 1000 reports = block
  • Per-user trust scoring
  • Appeal process available