본문으로 건너뛰기

콘텐츠 엔드포인트

콘텐츠(Content) 모듈은 웹사이트 페이지, 섹션, 요소, 블록, 블로그 게시물, 리디렉션, 설교, 재생목록, 스트리밍 서비스, 이벤트, 큐레이션 캘린더, 파일, 갤러리, 성경 번역 및 구절 조회, 찬양곡, 편곡, 전역 스타일, 스톡 사진, 설정을 관리합니다. API에서 가장 큰 모듈이며, 모든 ChurchApps 애플리케이션에서 CMS, 미디어/스트리밍, 예배 계획, 성경 기능을 지원합니다.

기본 경로: /content

페이지​

기본 경로: /content/pages

메서드경로인증권한설명
GET/:churchId/tree?url=&id=Public—URL 또는 ID로 전체 페이지 트리(섹션, 요소, 블록) 조회. URL로 조회할 때는 내부 ID를 제거. URL 기반 조회는 pages.visibility를 적용하며, 제한된 페이지는 (선택적) JWT가 제한 조건을 충족하지 않는 한 { restricted: true, visibility }를 반환
GET/public/:churchIdPublic—공개 페이지 목록(url, title, metaDescription). visibility = everyone인 페이지만 포함
GET/:idJWT—ID로 페이지 조회
GET/JWT—교회의 모든 페이지 목록 조회
POST/duplicate/:idJWTContent.Edit모든 섹션과 요소를 포함해 페이지 복제
POST/temp/aiJWTContent.EditAI로 생성한 페이지 저장(한 번의 호출로 페이지, 섹션, 요소 저장)
POST/importTreeJWTContent.Edit중첩 트리(title, url, sections[].elements[]…)로 페이지 생성. 항상 호출자의 교회 아래에 삽입되며, 본문의 ID는 무시. 행에는 column 자식이 포함되어야 함. 최대 섹션 30개 / 요소 500개
POST/JWTContent.Edit페이지 생성 또는 수정(일괄)
DELETE/:idJWTContent.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/:idJWT—ID로 섹션 조회
POST/duplicate/:id?convertToBlock=JWTContent.Edit섹션을 복제하거나 재사용 가능한 블록으로 변환
POST/JWTContent.Edit섹션 생성 또는 수정(일괄). 정렬 순서 자동 업데이트
DELETE/:idJWTContent.Edit섹션 삭제(정렬 순서 자동 업데이트)

요소​

기본 경로: /content/elements

메서드경로인증권한설명
GET/:idJWT—ID로 요소 조회
POST/duplicate/:idJWTContent.Edit모든 하위 항목을 포함해 요소 복제
POST/JWTContent.Edit요소 생성 또는 수정(일괄). 행의 열과 캐러셀 슬라이드를 자동 관리
DELETE/:idJWTContent.Edit요소 삭제

블록​

기본 경로: /content/blocks

표준 CRUD를 확장합니다(기본 클래스에서 제공하는 GET /:id, GET /, POST /, DELETE /:id이며, 쓰기 작업에는 Content.Edit 권한 필요).

메서드경로인증권한설명
GET/:idJWT—ID로 블록 조회
GET/JWT—모든 블록 목록 조회
GET/:churchId/tree/:idPublic—섹션과 요소를 포함한 전체 블록 트리 조회
GET/blockType/:blockTypeJWT—유형별 블록 조회(예: footerBlock, elementBlock)
GET/public/footer/:churchIdPublic—교회의 푸터 블록 트리 조회
POST/JWTContent.Edit블록 생성 또는 수정
DELETE/:idJWTContent.Edit블록 삭제

링크​

기본 경로: /content/links

표준 CRUD를 확장합니다(기본 클래스에서 제공하는 GET /:id, GET /, POST /, DELETE /:id이며, 쓰기 작업에는 Content.Edit 권한 필요).

메서드경로인증권한설명
GET/:idJWT—ID로 링크 조회
GET/JWT—모든 링크 목록 조회. 선택적 ?category= 필터. 저장 후 자동 정렬
GET/church/:churchId/filtered?category=JWT—공개 범위(everyone, visitors, members, staff, groups)로 필터링된 링크 조회
GET/church/:churchId?category=Public—카테고리별 교회 링크 조회(공개)
POST/JWTContent.Edit링크 생성 또는 수정(일괄). 카테고리별 자동 정렬
DELETE/:idJWTContent.Edit링크 삭제

전역 스타일​

기본 경로: /content/globalStyles

표준 CRUD를 확장합니다(기본 클래스에서 제공하는 POST /, DELETE /:id이며, 쓰기 작업에는 Content.Edit 권한 필요).

메서드경로인증권한설명
GET/church/:churchIdPublic—교회의 전역 스타일 조회(설정된 값이 없으면 기본값 반환)
GET/JWT—인증된 교회의 전역 스타일 조회
POST/JWTContent.Edit전역 스타일 생성 또는 수정
DELETE/:idJWTContent.Edit전역 스타일 삭제

페이지 기록​

기본 경로: /content/pageHistory

메서드경로인증권한설명
GET/page/:pageIdJWTContent.Edit페이지의 기록 항목 목록 조회
GET/block/:blockIdJWTContent.Edit블록의 기록 항목 목록 조회
GET/:idJWTContent.EditID로 기록 항목 조회
POST/JWTContent.Edit페이지/블록 스냅숏 저장. 30일이 지난 항목은 주기적으로 정리
POST/restore/:idJWTContent.Edit기록 스냅숏에서 페이지/블록 복원(현재 콘텐츠를 삭제하고 스냅숏으로 다시 생성)
POST/restoreSnapshotJWTContent.Edit인라인 스냅숏 객체에서 복원. 본문: { pageId, blockId, snapshot }

게시물(블로그)​

기본 경로: /content/posts

블로그 게시물은 독립된 행으로 저장됩니다. title, slug(교회별 고유), excerpt, content(마크다운 본문), authorId, photoUrl, publishDate, category, tags로 구성됩니다. publishDate가 설정되고 과거 시점이면 게시물이 공개됩니다. 조회 엔드포인트는 각 게시물에 authorId로부터 확인한 authorName을 추가합니다. 웹사이트 빌더 아키텍처를 참조하세요.

메서드경로인증권한설명
GET/public/:churchId?category=&tag=&page=&pageSize=Public—공개된 게시물 목록을 페이지 단위로 조회(페이지당 최대 50개)
GET/public/:churchId/categoriesPublic—공개된 게시물의 고유 카테고리 목록
GET/public/:churchId/slug/:slugPublic—slug로 공개된 게시물 조회
GET/rss/:churchId?siteUrl=Public—공개된 게시물의 RSS 2.0 피드(링크는 {siteUrl}/blog/{slug} 형식으로 생성)
GET/:idJWT—ID로 게시물 조회
GET/JWT—교회의 모든 게시물 목록 조회
POST/JWTContent.Edit게시물 생성 또는 수정(일괄)
DELETE/:idJWTContent.Edit게시물 삭제

리디렉션​

기본 경로: /content/redirects

교회별 URL 리디렉션(fromPath → toPath)이며, 교회당 최대 200개까지 생성할 수 있습니다. 경로는 정규화되며(소문자, 앞에 슬래시, 뒤에 슬래시 없음), fromPath는 교회 내에서 고유해야 합니다. B1App은 404가 될 요청에 대해 이 리디렉션을 확인하고 HTTP 308을 반환합니다.

메서드경로인증권한설명
GET/public/:churchId?path=Public—경로를 확인(path를 생략하면 모든 리디렉션 목록 반환)
GET/:idJWT—ID로 리디렉션 조회
GET/JWT—교회의 모든 리디렉션 목록 조회
POST/JWTContent.Edit리디렉션 생성 또는 수정. fromPath = toPath는 거부하며, 200개 제한을 적용
DELETE/:idJWTContent.Edit리디렉션 삭제

설교​

기본 경로: /content/sermons

메서드경로인증권한설명
GET/public/freeshowSampleJWT—FreeShow 재생목록 구조 예시 조회
GET/public/tvWrapper/:churchIdJWT—설교, 수업, FreeShow 소스를 포함한 TV 앱 래퍼 조회
GET/public/tvFeed/:churchId/:sermonIdPublic—설교 하나를 TV 피드 재생목록으로 조회
GET/public/tvFeed/:churchIdPublic—모든 공개 재생목록/설교를 TV 피드로 조회
GET/public/:churchIdPublic—교회의 모든 공개 설교 목록 조회
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/:channelIdJWT—YouTube 채널에서 동영상 가져오기. YouTube 검색 API가 제목과 설명에 넣는 HTML 엔티티(예: &, ')는 디코딩됨
GET/vimeoImport/:channelIdJWT—Vimeo 채널에서 동영상 가져오기
GET/:idJWT—ID로 설교 조회
GET/JWT—모든 설교 목록 조회
POST/JWTStreamingServices.Edit설교 생성 또는 수정. 배열 또는 단일 설교 객체를 받으며(항상 배열을 반환), 빈 본문은 400을 반환. base64 썸네일 업로드 지원
DELETE/:idJWTStreamingServices.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/:idJWT—ID로 재생목록 조회
GET/JWT—모든 재생목록 목록 조회
GET/public/:churchIdPublic—교회의 모든 공개 재생목록 조회
POST/JWTStreamingServices.Edit재생목록 생성 또는 수정(일괄, base64 썸네일 업로드 지원)
DELETE/:idJWTStreamingServices.Edit재생목록 삭제

스트리밍 서비스​

기본 경로: /content/streamingServices

메서드경로인증권한설명
GET/:id/hostChatJWTChat.Host서비스의 암호화된 호스트 채팅방 ID 조회
GET/JWT—모든 스트리밍 서비스 목록 조회. 기간이 끝난 비반복 서비스는 자동 정리하고, 반복 서비스는 다음 회차로 진행
POST/JWTStreamingServices.Edit스트리밍 서비스 생성 또는 수정(일괄)
DELETE/:idJWTStreamingServices.Edit스트리밍 서비스 삭제(차단된 IP도 함께 삭제)

이벤트​

기본 경로: /content/events

메서드경로인증권한설명
GET/timeline/group/:groupId?eventIds=JWT—그룹의 타임라인 이벤트 조회(예외 날짜 포함. 삭제된 발생 건은 건너뛸 수 있음)
GET/timeline?eventIds=JWT—현재 사용자 그룹의 타임라인 이벤트 조회(예외 날짜 포함)
GET/subscribe?churchId=&groupId=&curatedCalendarId=Public—ICS 캘린더 피드로 이벤트 구독
GET/group/:groupIdJWT—그룹의 이벤트 조회(예외 날짜 포함)
GET/public/group/:churchId/:groupIdPublic—그룹의 공개 이벤트 조회
GET/public/:churchId/:idPublic—공개 페이지용 이벤트 하나를 roomNames(거절되지 않은 예약의 장소)와 함께 조회. 대기 중이거나 거절된 이벤트, 등록을 받지 않는 비공개 이벤트에는 null 반환
GET/public/:churchId/:id/icalPublic—해당 이벤트 하나를 .ics 파일로 다운로드(text/calendar, 예외 날짜 적용). 같은 규칙으로 이벤트가 숨겨진 경우 404
GET/:idJWT—ID로 이벤트 조회
POST/JWT—이벤트 생성 또는 수정(일괄)
DELETE/:idJWTContent.Edit, Calendars.Admin, 또는 그룹 리더이벤트와 해당 예약 삭제. 이벤트 그룹의 리더는 삭제할 수 있으며, 요청자는 본인이 보낸 대기 중인 요청을 취소할 수 있음

이벤트 레코드에는 photoUrl(공개 이벤트 페이지와 다가오는 이벤트 타일에 표시되는 16:9 이벤트 사진), tags(쉼표로 구분, 웹사이트 캘린더 요소의 태그 필터에서 사용), notesViewRole / notesPostRole(null이면 staff, 또는 leaders, members)이 포함됩니다. 이 값들은 이벤트의 eventNote 대화 접근을 제어합니다. 그룹 및 이벤트 메모 접근 제어를 참조하세요. 공개 큐레이션 이벤트 응답에도 각 이벤트의 photoUrl과 tags가 포함됩니다.

이벤트 예외​

기본 경로: /content/eventExceptions

메서드경로인증권한설명
GET/:idJWT—ID로 이벤트 예외 조회
POST/JWTContent.Edit, Calendars.Admin, 또는 그룹 리더이벤트 예외 생성 또는 수정(일괄). 리더는 자신이 이끄는 그룹의 이벤트에 대해서만 예외를 추가할 수 있음
DELETE/:idJWTContent.Edit, Calendars.Admin, 또는 그룹 리더이벤트 예외 삭제

큐레이션 캘린더​

기본 경로: /content/curatedCalendars

메서드경로인증권한설명
GET/:idJWT—ID로 큐레이션 캘린더 조회
GET/JWT—모든 큐레이션 캘린더 목록 조회
POST/JWTContent.Edit큐레이션 캘린더 생성 또는 수정(일괄)
DELETE/:idJWTContent.Edit큐레이션 캘린더 삭제

큐레이션 이벤트​

기본 경로: /content/curatedEvents

메서드경로인증권한설명
GET/calendar/:curatedCalendarId?withoutEventsJWT—캘린더의 큐레이션 이벤트 조회(?withoutEvents를 설정하지 않으면 이벤트 상세 정보와 예외 날짜 포함)
GET/public/calendar/:churchId/:curatedCalendarIdPublic—캘린더의 공개 큐레이션 이벤트 조회
GET/:idJWT—ID로 큐레이션 이벤트 조회
GET/JWT—모든 큐레이션 이벤트 목록 조회
POST/JWTContent.Edit큐레이션 이벤트 생성 또는 수정. eventIds 배열을 지원하여 특정 그룹 이벤트를 추가
DELETE/:idJWTContent.Edit큐레이션 이벤트 삭제
DELETE/calendar/:curatedCalendarId/event/:eventIdJWTContent.Edit큐레이션 캘린더에서 특정 이벤트 제거
DELETE/calendar/:curatedCalendarId/group/:groupIdJWTContent.Edit큐레이션 캘린더에서 그룹의 모든 이벤트 제거

파일​

기본 경로: /content/files

메서드경로인증권한설명
GET/:contentType/:contentIdJWT—콘텐츠 유형과 콘텐츠 ID로 파일 조회
GET/JWT—교회 웹사이트의 모든 파일 목록 조회
GET/:idJWT—ID로 파일 조회
POST/JWTContent.Edit*파일 업로드(base64). *contentId에 해당하는 그룹의 구성원이면 허용
POST/postUrlJWTContent.Edit*사전 서명된 S3 업로드 URL 조회. *그룹 구성원도 허용. 콘텐츠 항목당 최대 100MB
DELETE/:idJWTContent.Edit*파일을 삭제하고 저장소에서도 제거. *그룹 구성원도 허용

갤러리​

기본 경로: /content/gallery

메서드경로인증권한설명
GET/stock/:folderPublic—폴더의 스톡 사진 목록 조회
GET/:folderJWTContent.Edit폴더의 갤러리 이미지 목록 조회
POST/requestUploadJWTContent.Edit갤러리 이미지용 사전 서명된 S3 업로드 URL 조회
DELETE/:folder/:imageJWTContent.Edit갤러리 이미지 삭제

성경​

기본 경로: /content/bibles

모든 성경 엔드포인트는 공개되어 있으며(인증 불필요), 데이터는 외부 소스에서 가져와 로컬에 캐시됩니다. api.bible 요청은 15초 후 시간 초과되며, 시간 초과 시 504를 반환합니다.

메서드경로인증권한설명
GET/Public—모든 성경 번역 목록 조회(캐시가 비어 있으면 소스에서 가져옴)
GET/stats?startDate=&endDate=Public—날짜 범위의 성경 조회 통계 조회
GET/availableTranslations/:sourcePublic—소스(예: api.bible)에서 사용 가능한 번역 목록 조회
GET/updateTranslationsPublic—모든 소스의 번역을 모두 동기화
GET/updateTranslations/:sourcePublic—특정 소스의 번역 동기화
GET/updateCopyrightsPublic—저작권 정보가 없는 번역의 저작권 정보 업데이트
GET/:translationKey/updateCopyrightPublic—특정 번역의 저작권 업데이트
GET/:translationKey/search?query=&limit=Public—번역본에서 구절 검색
GET/:translationKey/booksPublic—번역본의 책 목록 조회(로컬 캐시)
GET/:translationKey/:bookKey/chaptersPublic—책의 장 목록 조회(로컬 캐시)
GET/:translationKey/chapters/:chapterKey/versesPublic—장의 절 목록 조회(로컬 캐시)
GET/:translationKey/verses/:startVerseKey-:endVerseKeyPublic—범위의 구절 본문 조회. 조회 기록을 남김. 일부 번역은 라이선스 문제로 캐시를 우회

예제: 구절 본문 조회​

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/:idJWT—ID로 찬양곡 조회
GET/JWTContent.Edit모든 찬양곡 목록 조회
POST/JWTContent.Edit찬양곡 생성 또는 수정(일괄)
POST/importJWT—FreeShow에서 찬양곡 가져오기(일괄)
DELETE/:idJWTContent.Edit찬양곡 삭제

찬양곡 상세 정보​

기본 경로: /content/songDetails

찬양곡 상세 정보는 전역(교회 범위가 아님)입니다. 교회 간에 공유되는 표준 찬양곡 메타데이터를 나타냅니다.

메서드경로인증권한설명
GET/:idJWT—ID로 찬양곡 상세 정보 조회(전역)
GET/JWT—교회의 찬양곡 상세 정보 목록 조회
POST/createJWT—PraiseCharts ID로 찬양곡 상세 정보 생성(이미 생성되어 있으면 기존 항목 반환). PraiseCharts와 MusicBrainz에서 메타데이터를 자동으로 가져옴
POST/JWT—찬양곡 상세 정보 생성 또는 수정(일괄)

찬양곡 상세 링크​

기본 경로: /content/songDetailLinks

메서드경로인증권한설명
GET/:idJWT—ID로 찬양곡 상세 링크 조회
GET/songDetail/:songDetailIdJWT—찬양곡 상세 정보의 모든 링크 조회
POST/JWT—찬양곡 상세 링크 생성 또는 수정(일괄). 연결된 경우 MusicBrainz 데이터를 자동으로 가져옴
DELETE/:idJWT—찬양곡 상세 링크 삭제

편곡​

기본 경로: /content/arrangements

메서드경로인증권한설명
GET/:idJWT—ID로 편곡 조회
GET/song/:songIdJWTContent.Edit찬양곡의 편곡 조회
GET/songDetail/:songDetailIdJWTContent.Edit찬양곡 상세 정보의 편곡 조회
GET/JWTContent.Edit모든 편곡 목록 조회
POST/JWTContent.Edit편곡 생성 또는 수정(일괄)
POST/freeShow/missingJWT—교회에 없는 FreeShow ID 찾기. 본문: { freeShowIds: string[] }
DELETE/:idJWTContent.Edit편곡 삭제(키도 함께 삭제. 남은 편곡이 없으면 찬양곡도 삭제)

편곡 키​

기본 경로: /content/arrangementKeys

메서드경로인증권한설명
GET/presenter/:churchId/:idPublic—프레젠터 보기를 위해 전체 찬양곡 데이터가 포함된 편곡 키 조회
GET/:idJWT—ID로 편곡 키 조회
GET/arrangement/:arrangementIdJWTContent.Edit편곡의 키 조회
GET/JWTContent.Edit모든 편곡 키 목록 조회
POST/JWTContent.Edit편곡 키 생성 또는 수정(일괄)
DELETE/:idJWTContent.Edit편곡 키 삭제

설정​

기본 경로: /content/settings

메서드경로인증권한설명
GET/myJWT—현재 사용자의 설정 조회
GET/JWTSettings.Edit교회의 모든 설정 조회
GET/public/:churchIdPublic—교회의 공개 설정 조회(키-값 쌍으로 반환)
POST/myJWT—사용자 수준 설정 저장(base64 이미지 업로드 지원)
POST/JWTSettings.Edit교회 수준 설정 저장(base64 이미지 업로드 지원)
DELETE/my/:idJWT—사용자 설정 삭제

미리보기​

기본 경로: /content/preview

메서드경로인증권한설명
GET/data/:keyPublic—서브도메인 키로 교회의 스트리밍 미리보기 데이터(탭, 링크, 서비스, 설교) 조회

갤러리(스톡 사진)​

기본 경로: /content/stock

메서드경로인증권한설명
POST/searchPublic—Pexels 스톡 사진 검색. 본문: { term: "church" }

PraiseCharts​

기본 경로: /content/praiseCharts

예배 찬양 발견과 악보 다운로드를 위한 PraiseCharts 연동 기능입니다.

메서드경로인증권한설명
GET/raw/:idJWT—찬양곡의 PraiseCharts 원본 데이터 조회
GET/hasAccountJWT—사용자가 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 검증 코드를 액세스 토큰으로 교환하고 사용자 설정에 저장
GET/libraryJWT—사용자의 PraiseCharts 라이브러리 둘러보기

지원​

기본 경로: /content/support

메서드경로인증권한설명
POST/createAudioPublic—AWS Polly를 사용해 SSML을 MP3 오디오로 변환. 본문: { ssml: "<speak>...</speak>" }

관련 페이지​