API Overview
Message Callbacks
Status Codes
Overview
Retrieves the Telegram bot list.
Request
Authentication: Add authentication headers to the request. See Authentication
Method:
GET
Rate limit:
100 requests/second
Endpoint: https://API domain/jim/telegrambots/list
Content-Type:
application/json
Request parameters
| Parameter | Data type | Required | Description | |
|---|---|---|---|---|
| offset | string | No | Pagination offset; the starting position for retrieving the bot list. | |
| count | int | No | Items per page. Default: 20. Maximum: 50. |
Request example
GET /jim/telegrambots/list?count=50 HTTP/1.1
appkey: appkey
Authorization: xxxxxxxxxxxxxxxxxx
Content-Type: application/json
Response example
{
"code":0,
"msg":"sucess",
"data":{
"items":[
{
"bot_id":"botid1",
"bot_name":"bot1",
"bot_token":"xxxxxxxx",
"created_time":1732123456789
},{
"user_id":"botid2",
"bot_name":"bot2",
"bot_token":"xxxxxxxx",
"created_time":1751234567876
}
],
"offset":"xxxx"
}
}