curl -X POST "https://api.bi.ink/bot/sendmessage" \
  -H "Authorization: Bearer YOUR_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target_user_id": "user_456",
    "message_type": "text",
    "content": "你好，我是机器人"
  }'

# ① 上传
curl -X POST "https://api.bi.ink/bot/uploadfile" \
  -H "Authorization: Bearer YOUR_BOT_TOKEN" \
  -F "file=@/path/to/image.jpg"

# ② 发送（用上一步返回的 file_id）
curl -X POST "https://api.bi.ink/bot/sendmessage" \
  -H "Authorization: Bearer YOUR_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "group_id": "group_123",
    "message_type": "image",
    "file_id": "file_123456",
    "content": "可选说明文字"
  }'

Authorization: Bearer YOUR_BOT_TOKEN
Content-Type: application/json

{
  "code": 200,
  "msg": "发送成功",
  "data": { ... }
}

{
  "group_id": "group_123",
  "message_type": "text",
  "content": "请选择：",
  "extra": {
    "inline_keyboard": [
      [
        {"text": "确认", "callback_data": "confirm"},
        {"text": "取消", "callback_data": "cancel"}
      ],
      [
        {"text": "查看详情", "callback_data": "detail"}
      ]
    ]
  }
}

{
  "event_type": "callback_query",
  "message_id": "msg_abc123",
  "sender_id": "user_xxx",
  "sender_username": "john",
  "sender_display_name": "John Doe",
  "group_id": "group_123",
  "group_title": "测试群组",
  "message_type": "callback",
  "content": "confirm",
  "timestamp": 1732636800,
  "callback_id": "cb_user123_abc12345",
  "callback_data": "confirm"
}

curl -X POST "https://api.bi.ink/bot/answercallback" \
  -H "Authorization: Bearer YOUR_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_id": "cb_user123_abc12345",
    "text": "操作成功",
    "show_alert": false
  }'

{
  "group_id": "group_123",
  "message_type": "text",
  "content": "回复内容",
  "reply_to_id": "msg_123456"
}

{
  "group_id": "group_123",
  "message_type": "text",
  "content": "引用回复",
  "quote_message_id": "msg_123455"
}

import hmac, hashlib

def verify_webhook(raw_body: bytes, secret: str, signature: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")

{
  "event_type": "private_message",
  "message_id": "msg_abc123",
  "sender_id": "user_xxx",
  "sender_username": "john",
  "sender_display_name": "John Doe",
  "group_id": "",
  "message_type": "text",
  "content": "你好",
  "timestamp": 1732636800
}

{
  "event_type": "group_message",
  "message_id": "msg_grp_001",
  "sender_id": "user_xxx",
  "sender_username": "alice",
  "sender_display_name": "Alice",
  "sender_role": "member",
  "group_id": "group_123",
  "group_title": "测试群组",
  "message_type": "text",
  "content": "/help",
  "timestamp": 1732636800
}

{
  "event_type": "private_message",
  "message_id": "msg_dice_001",
  "sender_id": "user_xxx",
  "message_type": "dice",
  "content": "{\"type\":\"dice\",\"emoji\":\"🎲\",\"text\":\"🎲\",\"value\":5}",
  "timestamp": 1732636800
}

{
  "event_type": "member_joined",
  "sender_id": "user_newbie",
  "sender_username": "newbie",
  "sender_display_name": "新同学",
  "group_id": "group_123",
  "group_title": "欢迎群",
  "message_type": "member_event",
  "content": "user_inviter_id",
  "timestamp": 1732636800
}

curl -X POST "https://api.bi.ink/bot/uploadfile" \
  -H "Authorization: Bearer YOUR_BOT_TOKEN" \
  -F "file=@/path/to/file.jpg"

{
  "code": 200,
  "msg": "文件上传成功",
  "data": {
    "file_id": "file_123456"
  }
}

{
  "code": 200,
  "msg": "发送成功",
  "data": {
    "message_id": "msg_xxx",
    "conversation_id": "private_bot_user",
    "message_type": "dice",
    "content": {
      "type": "dice",
      "emoji": "🎲",
      "text": "🎲",
      "value": 3
    },
    "created_at": 1732636800
  }
}

{
  "message_id": "msg_xxx",
  "content": "已更新",
  "extra": {
    "inline_keyboard": []
  }
}

{ "message_id": "msg_xxx" }

{ "message_ids": ["msg_123", "msg_456", "msg_789"] }

{
  "code": 200,
  "msg": "获取成功",
  "data": {
    "user_id": "bot_xxx",
    "username": "my_bot",
    "display_name": "我的机器人",
    "bio": "简介",
    "avatar_url": "https://...",
    "status": 1,
    "created_at": "2025-01-01 00:00:00"
  }
}

// 请求
{ "group_id": "group_123" }

// 响应 data
{
  "group_id": "group_123",
  "title": "测试群",
  "description": "群简介",
  "avatar": "https://...",
  "member_count": 128,
  "is_public": 1,
  "is_cy": 0,
  "created_at": "2025-01-01 00:00:00"
}

{
  "callback_id": "cb_user123_abc12345",
  "text": "操作成功",
  "show_alert": false,
  "url": ""
}

{
  "commands": [
    {"command": "start", "description": "开始使用"},
    {"command": "help", "description": "帮助"},
    {"command": "price", "description": "查价"}
  ]
}

// 禁言单人 3600 秒（1 小时）；mute_duration=0 表示永久
{
  "group_id": "group_123",
  "member_user_id": "user_456",
  "mute_duration": 3600
}

// 全员禁言：member_user_id 传 "all" 或 "*"
{
  "group_id": "group_123",
  "member_user_id": "all",
  "mute_duration": 0
}

// 解除单人禁言
{
  "group_id": "group_123",
  "member_user_id": "user_456"
}

// 解除全员禁言
{
  "group_id": "group_123",
  "member_user_id": "all"
}

import requests

def send_text_message(bot_token, group_id, content):
    url = "https://api.bi.ink/bot/sendmessage"
    headers = {
        "Authorization": f"Bearer {bot_token}",
        "Content-Type": "application/json"
    }
    data = {
        "group_id": group_id,
        "message_type": "text",
        "content": content
    }
    response = requests.post(url, json=data, headers=headers)
    return response.json()

import requests

def upload_file(bot_token, file_path):
    url = "https://api.bi.ink/bot/uploadfile"
    headers = {"Authorization": f"Bearer {bot_token}"}
    with open(file_path, 'rb') as f:
        files = {'file': f}
        response = requests.post(url, files=files, headers=headers)
        result = response.json()
        if result.get('code') == 200:
            return result['data']['file_id']
        raise RuntimeError(result.get('msg', 'upload failed'))

def send_image_message(bot_token, group_id, file_id, caption=""):
    url = "https://api.bi.ink/bot/sendmessage"
    headers = {
        "Authorization": f"Bearer {bot_token}",
        "Content-Type": "application/json"
    }
    data = {
        "group_id": group_id,
        "message_type": "image",
        "file_id": file_id,
        "content": caption
    }
    response = requests.post(url, json=data, headers=headers)
    return response.json()

file_id = upload_file(bot_token, "/path/to/image.jpg")
send_image_message(bot_token, "group_123", file_id, "说明")

def send_message_with_buttons(bot_token, group_id, content):
    url = "https://api.bi.ink/bot/sendmessage"
    headers = {
        "Authorization": f"Bearer {bot_token}",
        "Content-Type": "application/json"
    }
    data = {
        "group_id": group_id,
        "message_type": "text",
        "content": content,
        "extra": {
            "inline_keyboard": [
                [
                    {"text": "确认", "callback_data": "confirm"},
                    {"text": "取消", "callback_data": "cancel"}
                ]
            ]
        }
    }
    return requests.post(url, json=data, headers=headers).json()

import json, hmac, hashlib, requests
from flask import Flask, request

app = Flask(__name__)
BOT_TOKEN = "your_bot_token"
WEBHOOK_SECRET = "your_webhook_secret"
API_BASE = "https://api.bi.ink"

def verify_signature(raw: bytes, sig: str) -> bool:
    expected = hmac.new(WEBHOOK_SECRET.encode(), raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig or "")

def api_post(path, payload):
    return requests.post(
        f"{API_BASE}{path}",
        json=payload,
        headers={"Authorization": f"Bearer {BOT_TOKEN}", "Content-Type": "application/json"},
        timeout=10,
    )

@app.route("/webhook", methods=["POST"])
def webhook():
    raw = request.get_data()
    if not verify_signature(raw, request.headers.get("X-Webhook-Signature", "")):
        return "invalid signature", 403
    event = json.loads(raw)

    et = event.get("event_type")
    if et == "private_message" and event.get("content") == "/start":
        api_post("/bot/sendmessage", {
            "target_user_id": event["sender_id"],
            "message_type": "text",
            "content": "欢迎使用，发送 /help 查看命令",
        })
    elif et == "private_message" and event.get("message_type") == "dice":
        dice = json.loads(event["content"])
        api_post("/bot/sendmessage", {
            "target_user_id": event["sender_id"],
            "message_type": "text",
            "content": f"你掷出了 {dice['value']} 点",
        })
    elif et == "callback_query":
        api_post("/bot/answercallback", {
            "callback_id": event["callback_id"],
            "text": "已收到",
            "show_alert": False,
        })
    return "OK", 200

import requests

def send_dice_and_get_value(bot_token, target_user_id):
    r = requests.post(
        "https://api.bi.ink/bot/sendmessage",
        json={
            "target_user_id": target_user_id,
            "message_type": "dice",
        },
        headers={"Authorization": f"Bearer {bot_token}"},
        timeout=10,
    ).json()
    if r.get("code") not in (0, 200):
        raise RuntimeError(r.get("msg", "send failed"))
    # 点数在这里 —— 必须是对象，不是字符串
    value = r["data"]["content"]["value"]
    message_id = r["data"]["message_id"]
    return value, message_id

# 示例：掷骰后回复文字
points, _ = send_dice_and_get_value(BOT_TOKEN, "user_456")
requests.post(
    "https://api.bi.ink/bot/sendmessage",
    json={
        "target_user_id": "user_456",
        "message_type": "text",
        "content": f"机器人掷出了 {points} 点",
    },
    headers={"Authorization": f"Bearer {BOT_TOKEN}"},
)

import requests
from flask import Flask, request

app = Flask(__name__)
BOT_TOKEN = "your_bot_token"
API_BASE_URL = "https://api.bi.ink"

@app.route('/webhook', methods=['POST'])
def webhook():
    event = request.json
    if event.get('event_type') == 'callback_query':
        callback_id = event['callback_id']
        callback_data = event['callback_data']
        message_id = event['message_id']
        if callback_data == 'confirm':
            answer_callback(callback_id, '已确认', False)
            edit_message(message_id, '已确认', {'inline_keyboard': []})
        elif callback_data == 'cancel':
            answer_callback(callback_id, '已取消', False)
    return 'OK', 200

def answer_callback(callback_id, text, show_alert):
    requests.post(
        f"{API_BASE_URL}/bot/answercallback",
        json={"callback_id": callback_id, "text": text, "show_alert": show_alert},
        headers={"Authorization": f"Bearer {BOT_TOKEN}", "Content-Type": "application/json"},
    )

def edit_message(message_id, content, extra):
    requests.post(
        f"{API_BASE_URL}/bot/editmessage",
        json={"message_id": message_id, "content": content, "extra": extra},
        headers={"Authorization": f"Bearer {BOT_TOKEN}", "Content-Type": "application/json"},
    )

package main

import (
    "bytes"
    "encoding/json"
    "net/http"
)

func sendMessage(botToken, groupID, content string) error {
    url := "https://api.bi.ink/bot/sendmessage"
    data := map[string]interface{}{
        "group_id":     groupID,
        "message_type": "text",
        "content":      content,
    }
    jsonData, _ := json.Marshal(data)
    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer "+botToken)
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        return err
    }
    defer resp.Body.Close()
    return nil
}

const express = require('express');
const axios = require('axios');
const app = express();
app.use(express.json());

const BOT_TOKEN = 'your_bot_token';
const API_BASE_URL = 'https://api.bi.ink';

app.post('/webhook', async (req, res) => {
    const event = req.body;
    if (event.event_type === 'private_message' && event.content === '/start') {
        await axios.post(`${API_BASE_URL}/bot/sendmessage`, {
            target_user_id: event.sender_id,
            message_type: 'text',
            content: '欢迎使用'
        }, { headers: { Authorization: `Bearer ${BOT_TOKEN}` } });
    } else if (event.event_type === 'callback_query') {
        await axios.post(`${API_BASE_URL}/bot/answercallback`, {
            callback_id: event.callback_id,
            text: '收到',
            show_alert: false
        }, { headers: { Authorization: `Bearer ${BOT_TOKEN}` } });
    }
    res.status(200).send('OK');
});

app.listen(3000);