crawhub-skill-yesapi（Crawhub 技能 yesapi）

--- name: yesapi description: YesApi果创云低代码平台接口封装，支持表单结构和数据操作 version: 1.0.0 homepage: https://api.yesapi.net/ user-invocable: true metadata: {"requires": {"env": ["YESAPI_APP_KEY", "YESAPI_DOMAIN", "YESAPI_SIGN"]}, "tags": ["api", "lowcode", "yesapi", "form", "database"]} ---

YesApi 果创云低代码平台 Skill

本技能提供对 YesApi 果创云低代码平台的完整接口封装，支持表单结构管理和数据操作。

配置要求

在使用前需要配置以下环境变量：

• YESAPI_APP_KEY: 你的果创云应用密钥
• YESAPI_DOMAIN: 果创云API域名（默认：https://api.yesapi.net）
• YESAPI_SIGN: 静态签名密钥

功能特性

1. 表单结构管理

• 获取表单模型列表
• 创建表单模型
• 更新表单结构
• 删除表单模型

2. 表单数据操作

• 通用数据查询（支持分页、过滤、排序）
• 数据新增
• 数据更新
• 数据删除
• 批量更新
• 批量删除

使用方法

获取表单列表

获取我的表单模型列表

查询表单数据

查询表单 [表单名] 的数据，限制10条记录

创建新数据

向表单 [表单名] 添加新数据：{"field1": "value1", "field2": "value2"}

更新数据

更新表单 [表单名] 中ID为 [记录ID] 的数据：{"field1": "new_value"}

删除数据

删除表单 [表单名] 中ID为 [记录ID] 的记录

批量更新数据

批量更新表单 [表单名] 中满足条件的数据：{"field1": "new_value"}，指定条件where：[["字段名", "比较符", "比较值"]]

批量删除数据

批量删除表单 [表单名] 中满足条件的记录，指定条件where：[["字段名", "比较符", "比较值"]]

API 接口封装

表单结构接口

基于 App.Platform_MyModels 接口封装：

• get_models(): 获取模型列表
• create_model(model_name): 创建新模型
• delete_model(model_name): 删除模型
• add_model_new_field(model_name, field_data): 为模型添加新字段

表单数据接口

基于 App.Table 系列接口封装：

• query_data(model_name, params): 查询数据
• insert_data(model_name, data): 插入数据
• update_data(model_name, id, data): 更新数据
• delete_data(model_name, id): 删除数据
• batch_update(model_name, where, data): 批量更新数据
• batch_delete(model_name, where): 批量删除数据

错误处理

所有API调用都会返回详细的错误信息，包括：

• HTTP状态码
• 错误代码
• 错误消息
• 建议解决方案

最佳实践

1. 配置管理: 建议使用环境变量管理敏感信息
2. 错误重试: 网络请求支持自动重试机制
3. 数据验证: 在发送数据前进行本地验证
4. 日志记录: 重要操作会记录详细日志

技术实现

• 使用 Python 的 requests 库进行HTTP请求
• 支持异步操作提高性能
• 内置签名算法确保API安全
• 完整的类型提示支持

依赖项

• Python 3.8+
• requests >= 2.28.0
• pydantic >= 1.10.0
• python-dotenv >= 0.19.0

许可证

MIT License