MBE 开发者文档

版本: 3.0.0 | 更新日期: 2026-02-01

欢迎使用 MBE (Mises Behavior Engine) 开发者文档。本文档帮助您快速集成 MBE API 和使用设计系统。

快速导航

快速入门

1. 获取 API Key

1. 访问 MBE 开发者门户
2. 注册/登录账号
3. 在控制台创建应用
4. 获取 API Key

2. 发送第一个请求

curl -X POST https://mbe.hi-maker.com/api/expert/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "什么是合同违约？",
    "expert_id": "civil_lawyer"
  }'

3. 响应示例

{
  "answer": "合同违约是指合同一方或双方不履行或不完全履行合同规定的义务...",
  "confidence": 0.92,
  "expert_id": "civil_lawyer",
  "expert_name": "中国民事律师",
  "response_time_ms": 1250
}

API 概览

基础 URL

认证

所有 API 请求需要在 Header 中包含 API Key:

Authorization: Bearer YOUR_API_KEY

主要端点

设计系统集成

安装

pnpm add @mbe/design-tokens @mbe/ui @mbe/tailwind-config

配置

// tailwind.config.ts
import mbeConfig from '@mbe/tailwind-config';

export default {
  presets: [mbeConfig],
  content: [
    './app/**/*.{js,ts,jsx,tsx}',
    './node_modules/@mbe/ui/**/*.{js,ts,jsx,tsx}',
  ],
};

使用组件

import { GlassCard, Button, Badge } from '@mbe/ui';

export function ExpertCard({ expert }) {
  return (
    <GlassCard hover glow className="p-6">
      <div className="flex justify-between items-center mb-4">
        <h3 className="text-lg font-semibold">{expert.name}</h3>
        <Badge variant="success">在线</Badge>
      </div>
      <p className="text-gray-400 mb-4">{expert.description}</p>
      <Button variant="primary">开始咨询</Button>
    </GlassCard>
  );
}

SDK

Python SDK

from mbe import MBEClient

client = MBEClient(api_key="YOUR_API_KEY")

# 获取专家列表
experts = client.experts.list()

# 向专家提问
response = client.experts.ask(
    query="什么是合同违约？",
    expert_id="civil_lawyer"
)
print(response.answer)

JavaScript/TypeScript SDK

import { MBEClient } from '@mbe/sdk';

const client = new MBEClient({ apiKey: 'YOUR_API_KEY' });

// 获取专家列表
const experts = await client.experts.list();

// 向专家提问
const response = await client.experts.ask({
  query: '什么是合同违约？',
  expertId: 'civil_lawyer',
});
console.log(response.answer);

错误处理

错误响应格式

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API Key 无效或已过期",
    "details": {}
  }
}

常见错误码

速率限制

Webhook

配置 Webhook

curl -X POST https://mbe.hi-maker.com/api/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["expert.response", "payment.completed"]
  }'

事件类型

本地开发

启动本地环境

# 使用 Docker
.\scripts\deploy_complete_development.ps1

# 或手动启动
docker compose -f docker-compose.complete.yml --env-file .env.development up -d

本地 API 地址

• API: http://localhost:8001
• API 文档: http://localhost:8001/docs

相关文档

• API 完整参考
• SDK 示例代码
• 最佳实践
• 设计系统指南
• 部署指南

支持

• 📧 Email: developer@mbe.example.com
• 📖 文档: https://docs.mbe.example.com
• 💬 Discord: https://discord.gg/mbe

开发者文档 | MBE v3.0.0 | 2026-02-01