Linework Open API · v1
基于 Linework 构建
一个简单的 REST API,用于自动化您的 Linework 账号:发布帖子和快拍、与社区互动、经营 Bloop 店铺,以及在聊天中回复客户。
您可以构建什么#
帖子
发布机器人
上传照片和视频,发布帖子和快拍,编辑或删除它们。
社区社区工具
读取您帖子下的评论,进行回复、点赞和关注。
Bloop店铺自动化
从您的系统同步商品和库存,读取订单并将其标记为已发货。
聊天客服机器人
回复给您发消息的人,不向任何人发送垃圾消息。
API 代表您自己的账号执行操作:每个请求都以创建该 API 密钥的用户身份发出,并具有为该密钥选择的权限(权限范围)。支付、钱包和代币无法通过 API 使用。
3 步快速入门#
- 申请开发者权限。在 Linework Web 应用中打开设置 → 开发者,告诉我们您想构建什么(用例、网站、机器人名称)。我们会审核每一份申请。
- 创建 API 密钥。获批后,在同一页面创建密钥并选择其权限范围。密钥以
lwk_开头,并且只显示一次:请将其保存在安全的地方。 - 发出第一个请求。
curl https://api.linework.app/open/v1/me \ -H "Authorization: Bearer $LINEWORK_API_KEY"const res = await fetch("https://api.linework.app/open/v1/me", { headers: { Authorization: `Bearer ${process.env.LINEWORK_API_KEY}` }, }); console.log(await res.json());import os, requests r = requests.get( "https://api.linework.app/open/v1/me", headers={"Authorization": f"Bearer {os.environ['LINEWORK_API_KEY']}"}, ) print(r.json())
基础信息一览#
| 项目 | 值 |
|---|---|
| Base URL | https://api.linework.app/open/v1 |
| 身份验证 | Authorization: Bearer lwk_… — 详情 |
| 格式 | JSON,camelCase 字段,字符串 ID,ISO 8601 日期(UTC) |
| 速率限制 | 每个密钥每分钟 120 个请求 — 限制与每日配额 |
| 分页 | 基于游标:?limit=&cursor= → { data, next_cursor } — 详情 |
| 错误 | { "error": { "code", "message" } } — 错误码 |
| OpenAPI 文件 | /openapi/linework-open-v1.yaml |
友好相处。Linework 上的机器人必须遵守社区规则和 API 使用条款。禁止垃圾信息、禁止爬取、禁止冒充他人。违反规则的密钥将被吊销。