简道云开发者学习路径

import requests
import json

# 配置信息
API_KEY = "your_api_key_here"  # 替换为你的API KEY
APP_ID = "your_app_id"           # 应用ID
ENTRY_ID = "your_entry_id"       # 表单ID

# API端点
url = f"https://www.jiandaoyun.com/api/v1/app/{APP_ID}/entry/{ENTRY_ID}/create"

# 请求头（Bearer Token鉴权）
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 要提交的数据
payload = {
    "data": {
        "_widget_1234567890": {"客户名称": "阿里巴巴"},  # 单行文本
        "_widget_1234567891": {"电话": "13800138000"},      # 电话字段
        "_widget_1234567892": {"地址": "杭州市余杭区"}    # 地址
    }
}

# 发送请求
response = requests.post(url, headers=headers, json=payload)

# 处理响应
if response.status_code == 200:
    result = response.json()
    print("✅ 数据创建成功！")
    print(f"数据 ID: {result['data']['_id']}")
else:
    print(f"❌ 错误: {response.status_code} - {response.text}")

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

app = Flask(__name__)

# Webhook签名密钥（在简道云后台配置）
WEBHOOK_SECRET = "your_webhook_secret"

@app.route('/webhook/jiandaoyun', methods=['POST'])
def handle_webhook():
    # 1. 验证签名（重要！）
    signature = request.headers.get('X-JDY-Signature')
    timestamp = request.headers.get('X-JDY-Timestamp')
    body = request.get_data(as_text=True)
    
    # 计算签名
    sign_str = f"{timestamp}.{body}"
    expected_signature = hmac.new(
        WEBHOOK_SECRET.encode(),
        sign_str.encode(),
        hashlib.sha256
    ).hexdigest()
    
    if signature != expected_signature:
        return jsonify({"error": "Invalid signature"}), 403
    
    # 2. 解析事件数据
    event_data = json.loads(body)
    event_type = event_data.get('op')  # data_create / data_update / flow_approve
    app_id = event_data.get('appId')
    entry_id = event_data.get('entryId')
    data = event_data.get('data')      # 表单数据
    
    print(f"✅ 收到Webhook事件: {event_type}")
    print(f"表单ID: {entry_id}")
    print(f"数据: {data}")
    
    # 3. 根据事件类型处理
    if event_type == 'data_create':
        # 处理新数据创建事件
        customer_name = data.get('_widget_1234567890', {})
        print(f"新客户: {customer_name}")
        # TODO: 同步到你的CRM系统
    
    elif event_type == 'flow_approve':
        # 处理审批通过事件
        approve_result = event_data.get('result')  # agree/reject
        print(f"审批结果: {approve_result}")
        # TODO: 通知系统审批结果
    
    # 4. 返回200確认收到（必须！）
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)