内容接口
内容模块负责管理网站页面、板块、元素、区块、博客文章、重定向、讲道、播放列表、直播服务、活动、精选日历、文件、图库、圣经译本与经文查询、诗歌、编排、全局样式、素材图片和设置。它是 API 中规模最大的模块,为各 ChurchApps 应用中的 CMS、媒体/直播、崇拜策划和圣经功能提供支持。
基础路径: /content
页面
基础路径:/content/pages
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:churchId/tree?url=&id= | Public | — | 按 URL 或 ID 加载完整页面树(板块、元素、区块)。通过 URL 获取时会去除内部 ID。基于 URL 的获取会校验 pages.visibility:受限页面会返回 { restricted: true, visibility },除非(可选的)JWT 满足访问条件 |
| GET | /public/:churchId | Public | — | 列出公开页面(url、title、metaDescription);仅包含 visibility = everyone 的页面 |
| GET | /:id | JWT | — | 按 ID 获取页面 |
| GET | / | JWT | — | 列出教会的所有页面 |
| POST | /duplicate/:id | JWT | Content.Edit | 复制页面及其所有板块和元素 |
| POST | /temp/ai | JWT | Content.Edit | 保存 AI 生成的页面(一次调用中包含页面、板块和元素) |
| POST | /importTree | JWT | Content.Edit | 根据嵌套树结构创建页面(title、url、sections[].elements[]…)。始终插入到调用者所属的教会下;请求体中的 ID 会被忽略。行数据必须包含其 column 子项。最多 30 个板块 / 500 个元素 |
| POST | / | JWT | Content.Edit | 创建或更新页面(批量) |
| DELETE | /:id | JWT | Content.Edit | 删除页面 |
示例:加载页面树
GET /content/pages/abc-church-id/tree?url=/about
{
"name": "About",
"url": "/about",
"sections": [
{
"background": "#FFFFFF",
"textColor": "dark",
"elements": [
{ "elementType": "textWithPhoto", "answers": { "text": "Welcome" } }
]
}
]
}
板块
基础路径:/content/sections
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取板块 |
| POST | /duplicate/:id?convertToBlock= | JWT | Content.Edit | 复制板块,或将其转换为可复用的区块 |
| POST | / | JWT | Content.Edit | 创建或更新板块(批量)。自动更新排序 |
| DELETE | /:id | JWT | Content.Edit | 删除板块(自动更新排序) |
元素
基础路径:/content/elements
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取元素 |
| POST | /duplicate/:id | JWT | Content.Edit | 复制元素及其所有子项 |
| POST | / | JWT | Content.Edit | 创建或更新元素(批量)。自动管理行列和轮播幻灯片 |
| DELETE | /:id | JWT | Content.Edit | 删除元素 |
区块
基础路径:/content/blocks
继承标准 CRUD(基类提供的 GET /:id、GET /、POST /、DELETE /:id,写入操作需要 Content.Edit 权限)。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取区块 |
| GET | / | JWT | — | 列出所有区块 |
| GET | /:churchId/tree/:id | Public | — | 加载包含板块和元素的完整区块树 |
| GET | /blockType/:blockType | JWT | — | 按类型加载区块(例如 footerBlock、elementBlock) |
| GET | /public/footer/:churchId | Public | — | 加载某教会的页脚区块树 |
| POST | / | JWT | Content.Edit | 创建或更新区块 |
| DELETE | /:id | JWT | Content.Edit | 删除区块 |
链接
基础路径:/content/links
继承标准 CRUD(基类提供的 GET /:id、GET /、POST /、DELETE /:id,写入操作需要 Content.Edit 权限)。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取链接 |
| GET | / | JWT | — | 列出所有链接。可选 ?category= 筛选。保存后自动排序 |
| GET | /church/:churchId/filtered?category= | JWT | — | 按可见性加载链接(everyone、visitors、members、staff、groups) |
| GET | /church/:churchId?category= | Public | — | 按分类加载某教会的链接(公开) |
| POST | / | JWT | Content.Edit | 创建或更新链接(批量)。按分类自动排序 |
| DELETE | /:id | JWT | Content.Edit | 删除链接 |
全局样式
基础路径:/content/globalStyles
继承标准 CRUD(基类提供的 POST /、DELETE /:id,写入操作需要 Content.Edit 权限)。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /church/:churchId | Public | — | 加载某教会的全局样式(若未设置则返回默认值) |
| GET | / | JWT | — | 加载当前已认证教会的全局样式 |
| POST | / | JWT | Content.Edit | 创建或更新全局样式 |
| DELETE | /:id | JWT | Content.Edit | 删除全局样式 |
页面历史
基础路径:/content/pageHistory
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /page/:pageId | JWT | Content.Edit | 列出某页面的历史记录 |
| GET | /block/:blockId | JWT | Content.Edit | 列出某区块的历史记录 |
| GET | /:id | JWT | Content.Edit | 按 ID 获取历史记录 |
| POST | / | JWT | Content.Edit | 保存页面/区块快照。会定期清理超过 30 天的记录 |
| POST | /restore/:id | JWT | Content.Edit | 从历史快照恢复页面/区块(删除当前内容并根据快照重新创建) |
| POST | /restoreSnapshot | JWT | Content.Edit | 从内联快照对象恢复。请求体:{ pageId, blockId, snapshot } |
文章(博客)
基础路径:/content/posts
博客文章是独立的记录:title、slug(每个教会内唯一)、excerpt、content(Markdown 正文)、authorId、photoUrl、publishDate、category 和 tags。当设置了 publishDate 且该时间已过时,文章即为已发布。读取接口会根据 authorId 为每篇文章补充 authorName。参见 网站构建器架构。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /public/:churchId?category=&tag=&page=&pageSize= | Public | — | 分页列出已发布的文章(每页最多 50 条) |
| GET | /public/:churchId/categories | Public | — | 列出已发布文章中所有不重复的分类 |
| GET | /public/:churchId/slug/:slug | Public | — | 按 slug 获取已发布的文章 |
| GET | /rss/:churchId?siteUrl= | Public | — | 已发布文章的 RSS 2.0 订阅源(链接格式为 {siteUrl}/blog/{slug}) |
| GET | /:id | JWT | — | 按 ID 获取文章 |
| GET | / | JWT | — | 列出教会的所有文章 |
| POST | / | JWT | Content.Edit | 创建或更新文章(批量) |
| DELETE | /:id | JWT | Content.Edit | 删除文章 |
重定向
基础路径:/content/redirects
每个教会的 URL 重定向(fromPath → toPath),每个教会最多 200 条。路径会被标准化(转为小写、以斜杠开头、无末尾斜杠),且 fromPath 在每个教会内唯一。B1App 会在可能出现 404 时解析这些重定向,并返回 HTTP 308。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /public/:churchId?path= | Public | — | 解析某路径(省略 path 时列出所有重定向) |
| GET | /:id | JWT | — | 按 ID 获取重定向 |
| GET | / | JWT | — | 列出教会的所有重定向 |
| POST | / | JWT | Content.Edit | 创建或更新重定向。拒绝 fromPath = toPath 的情况,并强制执行 200 条的上限 |
| DELETE | /:id | JWT | Content.Edit | 删除重定向 |
讲道
基础路径:/content/sermons
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /public/freeshowSample | JWT | — | 获取 FreeShow 播放列表结构示例 |
| GET | /public/tvWrapper/:churchId | JWT | — | 获取电视应用的包装数据,包含讲道、课程和 FreeShow 来源 |
| GET | /public/tvFeed/:churchId/:sermonId | Public | — | 将单个讲道获取为电视订阅源播放列表 |
| GET | /public/tvFeed/:churchId | Public | — | 将所有公开播放列表/讲道获取为电视订阅源 |
| GET | /public/:churchId | Public | — | 列出某教会的所有公开讲道 |
| GET | /timeline?sermonIds= | JWT | — | 加载讲道的时间线数据 |
| GET | /lookup?videoType=&videoData= | Public | — | 从 YouTube 或 Vimeo 查询讲道元数据 |
| GET | /socialSuggestions?youtubeVideoId= | JWT | — | 根据讲道字幕生成 AI 社交媒体帖子建议 |
| GET | /outline?url=&title=&author= | JWT | — | 根据 URL 生成 AI 课程大纲 |
| GET | /youtubeImport/:channelId | JWT | — | 从 YouTube 频道导入视频。YouTube 搜索 API 在标题和描述中使用的 HTML 实体(如 & 和 ')会被解码 |
| GET | /vimeoImport/:channelId | JWT | — | 从 Vimeo 频道导入视频 |
| GET | /:id | JWT | — | 按 ID 获取讲道 |
| GET | / | JWT | — | 列出所有讲道 |
| POST | / | JWT | StreamingServices.Edit | 创建或更新讲道。接受数组或单个讲道对象(始终返回数组);请求体为空时返回 400。支持 base64 缩略图上传 |
| DELETE | /:id | JWT | StreamingServices.Edit | 删除讲道 |
示例:查询 YouTube 讲道
GET /content/sermons/lookup?videoType=youtube&videoData=dQw4w9WgXcQ
{
"title": "Sunday Service - Faith in Action",
"description": "Pastor John speaks about faith...",
"thumbnail": "https://img.youtube.com/vi/dQw4w9WgXcQ/default.jpg",
"duration": 2400,
"publishDate": "2025-01-15T10:00:00Z"
}
播放列表
基础路径:/content/playlists
继承标准 CRUD(基类提供的 GET /:id、GET /、DELETE /:id,写入操作需要 StreamingServices.Edit 权限)。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取播放列表 |
| GET | / | JWT | — | 列出所有播放列表 |
| GET | /public/:churchId | Public | — | 列出某教会的所有公开播放列表 |
| POST | / | JWT | StreamingServices.Edit | 创建或更新播放列表(批量,支持 base64 缩略图上传) |
| DELETE | /:id | JWT | StreamingServices.Edit | 删除播放列表 |
直播服务
基础路径:/content/streamingServices
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id/hostChat | JWT | Chat.Host | 获取某服务的加密主持人聊天室 ID |
| GET | / | JWT | — | 列出所有直播服务。自动清理已过期的非重复服务,并推进重复服务 |
| POST | / | JWT | StreamingServices.Edit | 创建或更新直播服务(批量) |
| DELETE | /:id | JWT | StreamingServices.Edit | 删除直播服务(同时清除被封锁的 IP) |
活动
基础路径:/content/events
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /timeline/group/:groupId?eventIds= | JWT | — | 加载某小组的时间线活动(包含例外日期,使已删除的场次可以被跳过) |
| GET | /timeline?eventIds= | JWT | — | 加载当前用户所在小组的时间线活动(包含例外日期) |
| GET | /subscribe?churchId=&groupId=&curatedCalendarId= | Public | — | 以 ICS 日历订阅源的形式订阅活动 |
| GET | /group/:groupId | JWT | — | 获取某小组的活动(包含例外日期) |
| GET | /public/group/:churchId/:groupId | Public | — | 获取某小组的公开活动 |
| GET | /public/:churchId/:id | Public | — | 获取用于公开页面的单个活动,包含 roomNames(来自未被拒绝预订的房间)。对于待审批或已拒绝的活动,以及不接受报名的私人活动,返回 null |
| GET | /public/:churchId/:id/ical | Public | — | 将该活动下载为 .ics 文件(text/calendar,已应用例外日期)。若活动因相同规则被隐藏,则返回 404 |
| GET | /:id | JWT | — | 按 ID 获取活动 |
| POST | / | JWT | — | 创建或更新活动(批量) |
| DELETE | /:id | JWT | Content.Edit、Calendars.Admin 或小组负责人 | 删除活动及其预订。小组负责人可删除其所负责小组的活动,申请人也可撤回自己待审批的申请 |
活动记录包含 photoUrl(公开活动页面和即将到来的活动卡片中显示的 16:9 活动图片)、tags(逗号分隔,供网站日历元素的标签筛选器使用),以及 notesViewRole / notesPostRole(null 时为 staff,也可为 leaders 或 members),用于控制活动 eventNote 对话的访问权限,参见 小组和活动笔记访问控制。公开的精选活动响应也会包含每个活动的 photoUrl 和 tags。
活动例外
基础路径:/content/eventExceptions
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取活动例外 |
| POST | / | JWT | Content.Edit、Calendars.Admin 或小组负责人 | 创建或更新活动例外(批量)。小组负责人只能为其所负责小组中的活动添加例外 |
| DELETE | /:id | JWT | Content.Edit、Calendars.Admin 或小组负责人 | 删除活动例外 |
精选日历
基础路径:/content/curatedCalendars
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取精选日历 |
| GET | / | JWT | — | 列出所有精选日历 |
| POST | / | JWT | Content.Edit | 创建或更新精选日历(批量) |
| DELETE | /:id | JWT | Content.Edit | 删除精选日历 |
精选活动
基础路径:/content/curatedEvents
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /calendar/:curatedCalendarId?withoutEvents | JWT | — | 获取某日历的精选活动(包含活动详情和例外日期;若设置了 ?withoutEvents 则不包含活动详情) |
| GET | /public/calendar/:churchId/:curatedCalendarId | Public | — | 获取某日历的公开精选活动 |
| GET | /:id | JWT | — | 按 ID 获取精选活动 |
| GET | / | JWT | — | 列出所有精选活动 |
| POST | / | JWT | Content.Edit | 创建或更新精选活动。支持 eventIds 数组以添加特定小组的活动 |
| DELETE | /:id | JWT | Content.Edit | 删除精选活动 |
| DELETE | /calendar/:curatedCalendarId/event/:eventId | JWT | Content.Edit | 从精选日历中移除某个活动 |
| DELETE | /calendar/:curatedCalendarId/group/:groupId | JWT | Content.Edit | 从精选日历中移除某小组的所有活动 |
文件
基础路径:/content/files
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:contentType/:contentId | JWT | — | 按内容类型和内容 ID 获取文件 |
| GET | / | JWT | — | 列出网站的所有文件 |
| GET | /:id | JWT | — | 按 ID 获取文件 |
| POST | / | JWT | Content.Edit* | 上传文件(base64)。*若用户是与 contentId 对应小组的成员,也允许操作 |
| POST | /postUrl | JWT | Content.Edit* | 获取预签名的 S3 上传 URL。*小组成员也可操作。每个内容项最大 100MB |
| DELETE | /:id | JWT | Content.Edit* | 删除文件并从存储中移除。*小组成员也可操作 |
图库
基础路径:/content/gallery
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /stock/:folder | Public | — | 列出某文件夹中的素材照片 |
| GET | /:folder | JWT | Content.Edit | 列出某文件夹中的图库图片 |
| POST | /requestUpload | JWT | Content.Edit | 获取图库图片的预签名 S3 上传 URL |
| DELETE | /:folder/:image | JWT | Content.Edit | 删除图库图片 |
圣经
基础路径:/content/bibles
所有圣经接口均为公开接口(无需认证)。数据从外部来源获取并在本地缓存。对 api.bible 的请求在 15 秒后超时;超时会返回 504。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | / | Public | — | 列出所有圣经译本(若缓存为空,则从来源获取) |
| GET | /stats?startDate=&endDate= | Public | — | 获取某日期范围内的圣经查询统计 |
| GET | /availableTranslations/:source | Public | — | 列出某来源(例如 api.bible)的可用译本 |
| GET | /updateTranslations | Public | — | 同步所有来源的所有译本 |
| GET | /updateTranslations/:source | Public | — | 同步特定来源的译本 |
| GET | /updateCopyrights | Public | — | 更新缺少版权信息的译本的版权信息 |
| GET | /:translationKey/updateCopyright | Public | — | 更新特定译本的版权信息 |
| GET | /:translationKey/search?query=&limit= | Public | — | 在某译本中搜索经文 |
| GET | /:translationKey/books | Public | — | 获取某译本的书卷列表(本地缓存) |
| GET | /:translationKey/:bookKey/chapters | Public | — | 获取某书卷的章列表(本地缓存) |
| GET | /:translationKey/chapters/:chapterKey/verses | Public | — | 获取某章的经节列表(本地缓存) |
| GET | /:translationKey/verses/:startVerseKey-:endVerseKey | Public | — | 获取某范围的经文内容。记录查询日志。部分译本因授权原因不使用缓存 |
示例:获取经文内容
GET /content/bibles/de4e12af7f28f599-02/verses/GEN.1.1-GEN.1.3
[
{ "verseKey": "GEN.1.1", "content": "In the beginning God created the heavens and the earth.", "bookKey": "GEN", "chapterNumber": 1, "verseNumber": 1 },
{ "verseKey": "GEN.1.2", "content": "Now the earth was formless and empty...", "bookKey": "GEN", "chapterNumber": 1, "verseNumber": 2 },
{ "verseKey": "GEN.1.3", "content": "And God said, \"Let there be light,\" and there was light.", "bookKey": "GEN", "chapterNumber": 1, "verseNumber": 3 }
]
诗歌
基础路径:/content/songs
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /search?q= | JWT | — | 按查询词搜索诗歌 |
| GET | /:id | JWT | — | 按 ID 获取诗歌 |
| GET | / | JWT | Content.Edit | 列出所有诗歌 |
| POST | / | JWT | Content.Edit | 创建或更新诗歌(批量) |
| POST | /import | JWT | — | 从 FreeShow 导入诗歌(批量) |
| DELETE | /:id | JWT | Content.Edit | 删除诗歌 |
诗歌详情
基础路径:/content/songDetails
诗歌详情是全局的(不限于教会范围)。它们代表跨教会共享的标准诗歌元数据。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取诗歌详情(全局) |
| GET | / | JWT | — | 列出该教会的诗歌详情 |
| POST | /create | JWT | — | 根据 PraiseCharts ID 创建诗歌详情(若已创建则返回现有记录)。会自动从 PraiseCharts 和 MusicBrainz 获取元数据 |
| POST | / | JWT | — | 创建或更新诗歌详情(批量) |
诗歌详情链接
基础路径:/content/songDetailLinks
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取诗歌详情链接 |
| GET | /songDetail/:songDetailId | JWT | — | 获取某诗歌详情的所有链接 |
| POST | / | JWT | — | 创建或更新诗歌详情链接(批量)。若已关联,则自动获取 MusicBrainz 数据 |
| DELETE | /:id | JWT | — | 删除诗歌详情链接 |
编排
基础路径:/content/arrangements
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /:id | JWT | — | 按 ID 获取编排 |
| GET | /song/:songId | JWT | Content.Edit | 获取某诗歌的编排 |
| GET | /songDetail/:songDetailId | JWT | Content.Edit | 获取某诗歌详情的编排 |
| GET | / | JWT | Content.Edit | 列出所有编排 |
| POST | / | JWT | Content.Edit | 创建或更新编排(批量) |
| POST | /freeShow/missing | JWT | — | 查找教会中不存在的 FreeShow ID。请求体:{ freeShowIds: string[] } |
| DELETE | /:id | JWT | Content.Edit | 删除编排(同时删除调号;若无剩余编排,则同时删除诗歌) |
编排调号
基础路径:/content/arrangementKeys
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /presenter/:churchId/:id | Public | — | 获取用于演示视图的编排调号及完整诗歌数据 |
| GET | /:id | JWT | — | 按 ID 获取编排调号 |
| GET | /arrangement/:arrangementId | JWT | Content.Edit | 获取某编排的调号 |
| GET | / | JWT | Content.Edit | 列出所有编排调号 |
| POST | / | JWT | Content.Edit | 创建或更新编排调号(批量) |
| DELETE | /:id | JWT | Content.Edit | 删除编排调号 |
设置
基础路径:/content/settings
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /my | JWT | — | 获取当前用户的设置 |
| GET | / | JWT | Settings.Edit | 获取教会的所有设置 |
| GET | /public/:churchId | Public | — | 获取某教会的公开设置(以键值对形式返回) |
| POST | /my | JWT | — | 保存用户级设置(支持 base64 图片上传) |
| POST | / | JWT | Settings.Edit | 保存教会级设置(支持 base64 图片上传) |
| DELETE | /my/:id | JWT | — | 删除用户设置 |
预览
基础路径:/content/preview
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /data/:key | Public | — | 按子域名键加载某教会的直播预览数据(标签页、链接、服务、讲道) |
图库(素材图片)
基础路径:/content/stock
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| POST | /search | Public | — | 搜索 Pexels 素材图片。请求体:{ term: "church" } |
PraiseCharts
基础路径:/content/praiseCharts
与 PraiseCharts 集成,用于崇拜诗歌发现和乐谱下载。
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| GET | /raw/:id | JWT | — | 获取某诗歌的原始 PraiseCharts 数据 |
| GET | /hasAccount | JWT | — | 检查用户是否已关联 PraiseCharts 账户 |
| GET | /search?q= | JWT | — | 搜索 PraiseCharts 目录 |
| GET | /products/:id?keys= | JWT | — | 获取某诗歌的产品(已认证时从资料库获取,否则从目录获取) |
| GET | /arrangement/raw/:id?keys= | JWT | — | 从资料库获取原始编排数据 |
| GET | /download?skus=&keys=&file_name= | JWT | — | 从 PraiseCharts 下载文件(PDF 或 ZIP)。返回 { redirectUrl } |
| GET | /authUrl?returnUrl= | Public | — | 获取 PraiseCharts 的 OAuth 授权 URL |
| GET | /access?verifier=&token=&secret= | JWT | — | 用 OAuth verifier 换取访问令牌,并保存到用户设置 |
| GET | /library | JWT | — | 浏览用户的 PraiseCharts 资料库 |
支持
基础路径:/content/support
| 方法 | 路径 | 认证 | 权限 | 说明 |
|---|---|---|---|---|
| POST | /createAudio | Public | — | 使用 AWS Polly 将 SSML 转换为 MP3 音频。请求体:{ ssml: "<speak>...</speak>" } |