
언어 🇰🇷 한국어
시작하기
문서
집계
감사 로그
인증
댓글 차단
차단된 댓글 확인
댓글
사용자용 댓글
도메인 설정
이메일 템플릿
이벤트 로그
피드 게시물
댓글 신고
GIF
해시태그
중재
중재자
알림 수
알림
페이지 리액트
페이지
대기 중인 웹훅 이벤트
질문 설정
질문 결과
질문 결과 집계
SSO 사용자
구독
테넌트 일일 사용량
테넌트 패키지
테넌트 사용자
테넌트
티켓
번역
이미지 업로드
사용자 배지 진행
사용자 배지
사용자 알림
사용자 접속 상태
사용자 검색
사용자
투표
FastComments 파이썬 SDK
이것은 FastComments의 공식 Python SDK입니다.
FastComments API용 공식 Python SDK
저장소
설치 
Install from GitHub
릴리즈 태그에서 직접 설치합니다 (권장, 완전 재현 가능).
pip install git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0
빌드가 결정론적이도록 브랜치가 아니라 태그를 고정합니다. 같은 형태가 requirements.txt에서도 동작합니다:
fastcomments @ git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0
각 태그된 GitHub Release에도 바이너리 아티팩트를 직접 설치하고 싶을 경우 사용할 수 있는 wheel 파일이 함께 제공됩니다.
Library Contents
이 라이브러리는 두 개의 모듈을 포함합니다: 자동 생성된 API 클라이언트와 API 사용을 더 쉽게 해주는 수동 구현 유틸리티를 포함하고 있는 핵심 Python 라이브러리(SSO 지원 포함).
Public vs Secured APIs
API 클라이언트에는 DefaultApi, PublicApi, ModerationApi 세 가지 클래스가 있습니다. DefaultApi는 API 키가 필요한 메서드를 포함하고, PublicApi는 인증 없이 브라우저/모바일 디바이스 등에서 직접 호출할 수 있는 메서드를 포함합니다. ModerationApi는 실시간 및 빠른 검토를 위한 방대한 모듈의 검토 API를 제공합니다. 모든 ModerationApi 메서드는 sso 매개변수를 받아 SSO 또는 FastComments.com 세션 쿠키를 통해 인증할 수 있습니다.
빠른 시작 
Using Authenticated APIs (DefaultApi)
중요: 인증된 요청을 하기 전에 Configuration에 API 키를 설정해야 합니다. 설정하지 않으면 요청이 401 오류와 함께 실패합니다.
from client import ApiClient, Configuration, DefaultApi
from client.models import CreateAPISSOUserData
# API 클라이언트를 생성하고 구성합니다
config = Configuration()
config.host = "https://fastcomments.com"
# 필수: API 키 설정 (FastComments 대시보드에서 가져오세요)
config.api_key = {"api_key": "YOUR_API_KEY_HERE"}
# 구성된 클라이언트로 API 인스턴스를 생성합니다
api_client = ApiClient(configuration=config)
api = DefaultApi(api_client)
# 이제 인증된 API 호출을 할 수 있습니다
try:
# 예시: SSO 사용자 추가
user_data = CreateAPISSOUserData(
id="user-123",
email="user@example.com",
display_name="John Doe"
)
response = api.add_sso_user("YOUR_TENANT_ID", user_data)
print(f"User created: {response}")
except Exception as e:
print(f"Error: {e}")
# 일반적인 오류:
# - 401: API 키가 없거나 잘못되었습니다
# - 400: 요청 검증 실패
Using Public APIs (PublicApi)
공용 엔드포인트는 인증이 필요하지 않습니다:
from client import ApiClient, Configuration, PublicApi
config = Configuration()
config.host = "https://fastcomments.com"
api_client = ApiClient(configuration=config)
public_api = PublicApi(api_client)
try:
response = public_api.get_comments_public("YOUR_TENANT_ID", "page-url-id")
print(response)
except Exception as e:
print(f"Error: {e}")
Using the Moderation Dashboard (ModerationApi)
ModerationApi는 모더레이터 대시보드를 구동합니다. 메서드는 sso 토큰을 전달하여 모더레이터를 대신해 호출됩니다:
from client import ApiClient, Configuration, ModerationApi
from client.api.moderation_api import GetCountOptions
config = Configuration()
config.host = "https://fastcomments.com"
api_client = ApiClient(configuration=config)
moderation_api = ModerationApi(api_client)
try:
# 검토 대기 중인 댓글 수를 가져옵니다
response = moderation_api.get_count(GetCountOptions(sso="SSO_TOKEN"))
print(response)
except Exception as e:
print(f"Error: {e}")
Using SSO (Single Sign-On)
SDK에는 보안 SSO 토큰을 생성하는 유틸리티가 포함되어 있습니다:
from sso import FastCommentsSSO, SecureSSOUserData
# 사용자 데이터 생성 (id, email, username은 필수입니다)
user_data = SecureSSOUserData(
id="user-123",
email="user@example.com",
username="johndoe",
avatar="https://example.com/avatar.jpg"
)
# API 비밀키 (HMAC-SHA256)로 서명합니다
sso = FastCommentsSSO.new_secure("YOUR_API_SECRET", user_data)
# 위젯이나 API 호출에 사용할 SSO 토큰을 생성합니다
sso_token = sso.create_token()
# 이 토큰을 프런트엔드에서 사용하거나 API 호출에 전달합니다
print(f"SSO Token: {sso_token}")
간단한 SSO(덜 안전, 테스트용) 사용 예시:
from sso import FastCommentsSSO, SimpleSSOUserData
user_data = SimpleSSOUserData(
username="johndoe",
email="user@example.com"
)
sso = FastCommentsSSO.new_simple(user_data)
sso_token = sso.create_token()
Common Issues
- 401 "missing-api-key" 오류: DefaultApi 인스턴스를 만들기 전에
config.api_key = {"api_key": "YOUR_KEY"}를 설정했는지 확인하십시오. - 잘못된 API 클래스: 서버 측 인증 요청에는
DefaultApi를, 클라이언트 측/공용 요청에는PublicApi를, 모더레이터 대시보드 요청에는ModerationApi를 사용하십시오. - Import 오류: 올바른 모듈에서 가져오는지 확인하십시오:
- API 클라이언트:
from client import ... - SSO 유틸리티:
from sso import ...
- API 클라이언트:
참고사항 
브로드캐스트 ID
일부 API 호출에서는 broadcast_id를 전달해야 합니다. 이벤트를 수신하면 이 ID가 다시 돌아오므로, 클라이언트에서 변경을 낙관적으로 적용하려는 경우(이는 대체로 가장 좋은 경험을 제공하므로 아마 그렇게 하게 될 것입니다) 해당 이벤트를 무시해야 하는지 알 수 있습니다. 여기에는 UUID를 전달하세요. 이 ID는 브라우저 세션 내에서 두 번 발생하지 않을 만큼 충분히 고유해야 합니다.
요구사항 
- Python >= 3.8
베이스 설치는 pure-stdlib이며 SSO 유틸리티를 제공합니다. 생성된 API 클라이언트(DefaultApi/PublicApi/ModerationApi)는 client 추가 기능이 필요하며, 이는 urllib3 >= 1.25.3, python-dateutil >= 2.8.2, pydantic >= 2.0.0, 그리고 typing-extensions >= 4.0.0을 가져옵니다:
pip install "fastcomments[client] @ git+https://github.com/fastcomments/fastcomments-python.git@v3.0.0"
집계 
Aggregates documents by grouping them (if groupBy is provided) and applying multiple operations. Different operations (e.g. sum, countDistinct, avg, etc.) are supported.
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| parentTenantId | string | query | No | |
| includeStats | boolean | query | No |
응답
예시

감사 로그 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| limit | number | query | No | |
| skip | number | query | No | |
| order | string | query | No | |
| after | number | query | No | |
| before | number | query | No |
응답
예시

로그아웃(공개) 
응답
반환: APIEmptyResponse
예제

댓글에서 차단 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| sso | string | query | 아니오 |
응답
반환: BlockSuccess
예제

댓글 차단 해제 
Parameters
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| sso | string | query | 아니요 |
Response
반환: UnblockSuccess
예제

차단된 댓글 확인 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentIds | string | query | 예 | 쉼표로 구분된 댓글 ID 목록입니다. |
| sso | string | query | 아니오 |
응답
반환: CheckBlockedCommentsResponse
예제

사용자 댓글 차단 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes | |
| userId | string | query | No | |
| anonUserId | string | query | No |
응답
반환: BlockSuccess
예제

댓글 생성(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| broadcastId | string | query | 예 | |
| sessionId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: SaveCommentsResponseWithPresence
예시

댓글 삭제 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| contextUserId | string | query | 아니오 | |
| isLive | boolean | query | 아니오 |
Response
예제

댓글 삭제(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | Yes | |
| editKey | string | query | No | |
| sso | string | query | No |
응답
반환: PublicAPIDeleteCommentResponse
예시

댓글 투표 삭제 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| voteId | string | path | Yes | |
| urlId | string | query | Yes | |
| broadcastId | string | query | Yes | |
| editKey | string | query | No | |
| sso | string | query | No |
Response
예시

댓글 신고 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니오 | |
| anonUserId | string | query | 아니오 |
Response
Example

댓글 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

댓글 텍스트 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| editKey | string | query | No | |
| sso | string | query | No |
응답
반환: PublicAPIGetCommentTextResponse
예시

댓글 투표 사용자 이름 가져오기 
매개변수
| 이름 | Type | Location | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| commentId | string | path | 예 | |
| dir | integer | query | 예 | |
| sso | string | query | 아니오 |
응답
반환: GetCommentVoteUserNamesSuccessResponse
예제

댓글 목록 가져오기 
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| page | integer | query | No | |
| limit | integer | query | No | |
| skip | integer | query | No | |
| asTree | boolean | query | No | |
| skipChildren | integer | query | No | |
| limitChildren | integer | query | No | |
| maxTreeDepth | integer | query | No | |
| urlId | string | query | No | |
| userId | string | query | No | |
| anonUserId | string | query | No | |
| contextUserId | string | query | No | |
| hashTag | string | query | No | |
| parentId | string | query | No | |
| direction | string | query | No | |
| fromDate | integer | query | No | |
| toDate | integer | query | No |
Response
Example

댓글 가져오기(공개) 
req tenantId urlId
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| page | integer | query | 아니오 | |
| direction | string | query | 아니오 | |
| sso | string | query | 아니오 | |
| skip | integer | query | 아니오 | |
| skipChildren | integer | query | 아니오 | |
| limit | integer | query | 아니오 | |
| limitChildren | integer | query | 아니오 | |
| countChildren | boolean | query | 아니오 | |
| fetchPageForCommentId | string | query | 아니오 | |
| includeConfig | boolean | query | 아니오 | |
| countAll | boolean | query | 아니오 | |
| includei10n | boolean | query | 아니오 | |
| locale | string | query | 아니오 | |
| modules | string | query | 아니오 | |
| isCrawler | boolean | query | 아니오 | |
| includeNotificationCount | boolean | query | 아니오 | |
| asTree | boolean | query | 아니오 | |
| maxTreeDepth | integer | query | 아니오 | |
| useFullTranslationIds | boolean | query | 아니오 | |
| parentId | string | query | 아니오 | |
| searchText | string | query | 아니오 | |
| hashTags | array | query | 아니오 | |
| userId | string | query | 아니오 | |
| customConfigStr | string | query | 아니오 | |
| afterCommentId | string | query | 아니오 | |
| beforeCommentId | string | query | 아니오 |
응답
Returns: GetCommentsResponseWithPresencePublicComment
예제

댓글 잠금 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| commentId | string | path | 예 | |
| broadcastId | string | query | 예 | |
| sso | string | query | 아니오 |
응답
반환: APIEmptyResponse
예제

댓글 고정 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| commentId | string | path | 예 | |
| broadcastId | string | query | 예 | |
| sso | string | query | 아니요 |
응답
반환: ChangeCommentPinStatusResponse
예제

댓글 저장 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| isLive | boolean | query | 아니오 | |
| doSpamCheck | boolean | query | 아니오 | |
| sendEmails | boolean | query | 아니오 | |
| populateNotifications | boolean | query | 아니오 |
응답
예시

댓글 대량 저장 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| isLive | boolean | query | No | |
| doSpamCheck | boolean | query | No | |
| sendEmails | boolean | query | No | |
| populateNotifications | boolean | query | No |
응답
예제

댓글 텍스트 설정 
Parameters
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | Yes | |
| editKey | string | query | No | |
| sso | string | query | No |
Response
반환: PublicAPISetCommentTextResponse
예제

댓글에서 사용자 차단 해제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니오 | |
| anonUserId | string | query | 아니오 |
응답
반환: UnblockSuccess
예시

댓글 신고 취소 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes | |
| userId | string | query | No | |
| anonUserId | string | query | No |
응답
예시

댓글 잠금 해제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | Yes | |
| sso | string | query | No |
응답
반환: APIEmptyResponse
예제

댓글 고정 해제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | Yes | |
| sso | string | query | No |
응답
반환: ChangeCommentPinStatusResponse
예제

댓글 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes | |
| contextUserId | string | query | No | |
| doSpamCheck | boolean | query | No | |
| isLive | boolean | query | No |
응답
Returns: APIEmptyResponse
예제

댓글에 투표 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| commentId | string | path | Yes | |
| urlId | string | query | Yes | |
| broadcastId | string | query | Yes | |
| sessionId | string | query | No | |
| sso | string | query | No |
응답
반환: VoteResponse
예시

사용자 댓글 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| userId | string | query | No | |
| direction | string | query | No | |
| repliesToUserId | string | query | No | |
| page | number | query | No | |
| includei10n | boolean | query | No | |
| locale | string | query | No | |
| isCrawler | boolean | query | No |
응답
Returns: GetCommentsForUserResponse
예시

도메인 설정 추가 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

도메인 설정 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| domain | string | path | 예 |
응답
반환: DeleteDomainConfigResponse
예제

도메인 설정 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| domain | string | path | 예 |
응답
예제

도메인 설정 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes |
응답
예제

도메인 설정 부분 수정 
매개변수
| 이름 | Type | Location | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| domainToUpdate | string | path | 예 |
응답
예제

도메인 설정 대체 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| domainToUpdate | string | path | 예 |
응답
예제

이메일 템플릿 생성 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes |
응답
반환: CreateEmailTemplateResponse
예제

이메일 템플릿 삭제 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

이메일 템플릿 렌더링 오류 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| errorId | string | path | 예 |
응답
반환: APIEmptyResponse
예제

이메일 템플릿 가져오기 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

이메일 템플릿 정의 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: GetEmailTemplateDefinitionsResponse
예제

이메일 템플릿 렌더링 오류 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| skip | number | query | 아니오 |
응답
반환: GetEmailTemplateRenderErrorsResponse
예제

이메일 템플릿 목록 가져오기 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| skip | number | query | 아니요 |
응답
예제

이메일 템플릿 렌더링 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| locale | string | query | 아니오 |
응답
반환: RenderEmailTemplateResponse
예제

이메일 템플릿 업데이트 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

이벤트 로그 가져오기 
req tenantId urlId userIdWS
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| userIdWS | string | query | 예 | |
| startTime | integer | query | 예 | |
| endTime | integer | query | 아니오 |
응답
예제

전역 이벤트 로그 가져오기 
req tenantId urlId userIdWS
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| userIdWS | string | query | 예 | |
| startTime | integer | query | 예 | |
| endTime | integer | query | 아니요 |
응답
예제

피드 게시물 생성 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| broadcastId | string | query | 아니오 | |
| isLive | boolean | query | 아니오 | |
| doSpamCheck | boolean | query | 아니오 | |
| skipDupCheck | boolean | query | 아니오 |
응답
Returns: CreateFeedPostsResponse
예시

피드 게시물 생성(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예시

피드 게시물 삭제(공개) 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| postId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: DeleteFeedPostPublicResponse
예시

피드 게시물 가져오기 
req tenantId afterId
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| afterId | string | query | No | |
| limit | integer | query | No | |
| tags | array | query | No |
Response
Returns: GetFeedPostsResponse
Example

피드 게시물 가져오기(공개) 
req tenantId afterId
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| afterId | string | query | No | |
| limit | integer | query | No | |
| tags | array | query | No | |
| sso | string | query | No | |
| isCrawler | boolean | query | No | |
| includeUserInfo | boolean | query | No |
응답
예시

피드 게시물 통계 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| postIds | array | query | 예 | |
| sso | string | query | 아니요 |
응답
예제

사용자 리액트 가져오기(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| postIds | array | query | No | |
| sso | string | query | No |
응답
예시

피드 게시물에 반응(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| postId | string | path | 예 | |
| isUndo | boolean | query | 아니오 | |
| broadcastId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
예제

피드 게시물 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

피드 게시물 업데이트(공개) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| postId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예제

댓글 신고(공개) 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| isFlagged | boolean | query | 예 | |
| sso | string | query | 아니요 |
응답
반환: APIEmptyResponse
예제

대형 GIF 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| largeInternalURLSanitized | string | query | 예 |
응답
예제

GIF 검색 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| search | string | query | Yes | |
| locale | string | query | No | |
| rating | string | query | No | |
| page | number | query | No |
응답
예시

인기 GIF 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| locale | string | query | No | |
| rating | string | query | No | |
| page | number | query | No |
응답
예시

해시태그 추가 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes |
응답
예시

해시태그 대량 추가 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
Returns: BulkCreateHashTagsResponse
예제

해시태그 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| tag | string | path | 예 |
응답
반환: APIEmptyResponse
예시

해시태그 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| page | number | query | 아니오 |
응답
예제

해시태그 부분 수정 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| tag | string | path | 예 |
응답
Returns: UpdateHashTagResponse
예시

중재 투표 삭제 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| voteId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예시

API 댓글 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| page | number | query | 아니오 | |
| count | number | query | 아니오 | |
| text-search | string | query | 아니오 | |
| byIPFromComment | string | query | 아니오 | |
| filters | string | query | 아니오 | |
| searchFilters | string | query | 아니오 | |
| sorts | string | query | 아니오 | |
| demo | boolean | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환값: ModerationAPIGetCommentsResponse
예시

API 내보내기 상태 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| batchJobId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: ModerationExportStatusResponse
예시

API ID 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| text-search | string | query | No | |
| byIPFromComment | string | query | No | |
| filters | string | query | No | |
| searchFilters | string | query | No | |
| afterId | string | query | No | |
| demo | boolean | query | No | |
| sso | string | query | No |
응답
반환: ModerationAPIGetCommentIdsResponse
예시

댓글에서 차단된 사용자 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| sso | string | query | No |
응답
반환: GetBannedUsersFromCommentResponse
예시

댓글 차단 상태 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| sso | string | query | 아니오 |
응답
반환: GetCommentBanStatusResponse
예제

댓글 자식(대댓글) 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| sso | string | query | 아니오 |
응답
반환: ModerationAPIChildCommentsResponse
예시

카운트 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| text-search | string | query | No | |
| byIPFromComment | string | query | No | |
| filter | string | query | No | |
| searchFilters | string | query | No | |
| demo | boolean | query | No | |
| sso | string | query | No |
응답
반환: ModerationAPICountCommentsResponse
예시

카운트들 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| sso | string | query | No |
응답
반환: GetBannedUsersCountResponse
예시

로그 가져오기 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| sso | string | query | 아니오 |
Response
반환값: ModerationAPIGetLogsResponse
예시

수동 배지 가져오기 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| sso | string | query | 아니오 |
Response
반환: GetTenantManualBadgesResponse
예시

사용자용 수동 배지 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| badgesUserId | string | query | 아니오 | |
| commentId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: GetUserManualBadgesResponse
예시

중재용 댓글 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| includeEmail | boolean | query | No | |
| includeIP | boolean | query | No | |
| sso | string | query | No |
응답
반환: ModerationAPICommentResponse
예제

중재용 댓글 텍스트 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| sso | string | query | No |
응답
예시

사전 차단 요약 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| includeByUserIdAndEmail | boolean | query | No | |
| includeByIP | boolean | query | No | |
| includeByEmailDomain | boolean | query | No | |
| sso | string | query | No |
응답
반환: PreBanSummary
예제

검색된 댓글 요약 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| value | string | query | No | |
| filters | string | query | No | |
| searchFilters | string | query | No | |
| sso | string | query | No |
응답
반환: ModerationCommentSearchResponse
예제

검색된 페이지 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| value | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: ModerationPageSearchResponse
예제

검색된 사이트 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| value | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: ModerationSiteSearchResponse
예시

검색 제안 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| text-search | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
예시

검색된 사용자 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| value | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: ModerationUserSearchResponse
예시

신뢰 요인 가져오기 
매개변수
| 이�름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| userId | string | query | No | |
| sso | string | query | No |
응답
반환: GetUserTrustFactorResponse
예시

사용자 차단 선호도 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| sso | string | query | 아니오 |
응답
반환: APIModerateGetUserBanPreferencesResponse
예시

사용자 내부 프로필 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: GetUserInternalProfileResponse
예시

댓글 투표 조정 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예제

API 내보내기 요청 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| text-search | string | query | 아니오 | |
| byIPFromComment | string | query | 아니오 | |
| filters | string | query | 아니오 | |
| searchFilters | string | query | 아니오 | |
| sorts | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
예제

댓글에서 사용자 차단(POST) 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| banEmail | boolean | query | No | |
| banEmailDomain | boolean | query | No | |
| banIP | boolean | query | No | |
| deleteAllUsersComments | boolean | query | No | |
| bannedUntil | string | query | No | |
| isShadowBan | boolean | query | No | |
| updateId | string | query | No | |
| banReason | string | query | No | |
| sso | string | query | No |
응답
예제

사용자 차단 취소(POST) 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| sso | string | query | No |
응답
Returns: APIEmptyResponse
예시

대량 사전 차단 요약 요청 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| includeByUserIdAndEmail | boolean | query | 아니오 | |
| includeByIP | boolean | query | 아니오 | |
| includeByEmailDomain | boolean | query | 아니오 | |
| sso | string | query | 아니오 |
응답
예시

ID로 댓글 조회(POST) 
Parameters
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| sso | string | query | 아니오 |
Response
반환: ModerationAPIChildCommentsResponse
예시

댓글 신고(POST) 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| broadcastId | string | query | 아니오 | |
| sso | string | query | 아니오 |
Response
반환: APIEmptyResponse
Example

댓글 제거(POST) 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: PostRemoveCommentApiResponse
예시

삭제된 댓글 복원(POST) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: APIEmptyResponse
예시

댓글 승인 상태 설정(POST) 
Parameters
| 이름 | 타입 | 위치 | 필요 여부 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| approved | boolean | query | 아니오 | |
| broadcastId | string | query | 아니오 | |
| sso | string | query | 아니오 |
Response
Returns: SetCommentApprovedResponse
Example

댓글 검토 상태 설정(POST) 
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | path | 예 | |
| reviewed | boolean | query | 아니오 | |
| broadcastId | string | query | 아니오 | |
| sso | string | query | 아니오 |
Response
Returns: APIEmptyResponse
Example

댓글 스팸 상태 설정(POST) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| spam | boolean | query | No | |
| permNotSpam | boolean | query | No | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: APIEmptyResponse
예시

댓글 텍스트 설정(POST) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예시

댓글 신고 취소(POST) 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: APIEmptyResponse
예시

투표(POST) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | path | Yes | |
| direction | string | query | No | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
반환: VoteResponse
예시

배지 수여(PUT) 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| badgeId | string | query | 예 | |
| userId | string | query | 아니오 | |
| commentId | string | query | 아니오 | |
| broadcastId | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
예시

스레드 닫기(PUT) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlId | string | query | Yes | |
| sso | string | query | No |
응답
반환: APIEmptyResponse
예시

배지 제거(PUT) 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| badgeId | string | query | Yes | |
| userId | string | query | No | |
| commentId | string | query | No | |
| broadcastId | string | query | No | |
| sso | string | query | No |
응답
예시

스레드 재개(PUT) 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| urlId | string | query | 예 | |
| sso | string | query | 아니오 |
응답
반환: APIEmptyResponse
예시

신뢰 요인 설정 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 아니오 | |
| trustFactor | string | query | 아니오 | |
| sso | string | query | 아니오 |
응답
반환: SetUserTrustFactorResponse
예제

중재자 생성 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

중재자 삭제 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| sendEmail | string | query | 아니오 |
응답
반환: APIEmptyResponse
예제

중재자 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
반환
예제

중재자 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| skip | number | query | 아니오 |
응답
예제

초대장 전송 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| fromName | string | query | 예 |
응답
반환: APIEmptyResponse
예제

중재자 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

알림 수 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

캐시된 알림 수 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: GetCachedNotificationCountResponse
예제

알림 수 가져오기 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| userId | string | query | No | |
| urlId | string | query | No | |
| fromCommentId | string | query | No | |
| viewed | boolean | query | No | |
| type | string | query | No |
Response
반환: GetNotificationCountResponse
Example

알림 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 아니오 | |
| urlId | string | query | 아니오 | |
| fromCommentId | string | query | 아니오 | |
| viewed | boolean | query | 아니오 | |
| type | string | query | 아니오 | |
| skip | number | query | 아니오 |
응답
예시

알림 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니요 |
응답
반환: APIEmptyResponse
예제

v1 페이지 리액트 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| title | string | query | 아니오 |
응답
예제

v2 페이지 리액트 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| id | string | query | 예 | |
| title | string | query | 아니요 |
응답
예제

v1 페이지 리액트 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 |
응답
예제

v2 페이지 리액트 삭제 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| urlId | string | query | Yes | |
| id | string | query | Yes |
응답
예제

v1 페이지 좋아요 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 |
응답
반환: GetV1PageLikes
예제

v2 페이지 리액트 사용자 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 | |
| id | string | query | 예 |
응답
반환: GetV2PageReactUsersResponse
예시

v2 페이지 리액트 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | 예 | |
| urlId | string | query | 예 |
응답
반환: GetV2PageReacts
예제

페이지 추가 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

페이지 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

오프라인 사용자 가져오기 
Past commenters on the page who are NOT currently online. Sorted by displayName.
Use this after exhausting /users/online to render a "Members" section.
Cursor pagination on commenterName: server walks the partial {tenantId, urlId, commenterName} index from afterName forward via $gt, no $skip cost.
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| urlId | string | query | Yes | 페이지 URL 식별자 (서버 측에서 정리된). |
| afterName | string | query | No | 커서: 이전 응답에서 nextAfterName을 전달합니다. |
| afterUserId | string | query | No | 커서 동점자 해결: 이전 응답에서 nextAfterUserId를 전달합니다. afterName이 설정된 경우 이름이 동일한 경우 항목이 누락되지 않도록 필요합니다. |
Response
Returns: PageUsersOfflineResponse
Example

온라인 사용자 가져오기 
Currently-online viewers of a page: people whose websocket session is subscribed to the page right now. Returns anonCount + totalCount (room-wide subscribers, including anon viewers we don't enumerate).
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| urlId | string | query | Yes | 페이지 URL 식별자(서버 측에서 정리됨). |
| afterName | string | query | No | 커서: 이전 응답에서 nextAfterName을 전달합니다. |
| afterUserId | string | query | No | 커서 동점 해결: 이전 응답에서 nextAfterUserId를 전달합니다. afterName이 설정된 경우 이름 동점이 항목을 누락하지 않도록 필요합니다. |
응답
예시

URL ID로 페이지 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlId | string | query | Yes |
응답
예제

페이지 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

페이지 목록 가져오기(공개) 
List pages for a tenant. Used by the FChat desktop client to populate its room list.
Requires enableFChat to be true on the resolved custom config for each page.
Pages that require SSO are filtered against the requesting user's group access.
Parameters
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| cursor | string | query | No | 이전 요청에서 nextCursor 로 반환된 불투명 페이지네이션 커서입니다. 동일한 sortBy 와 연결됩니다. |
| limit | integer | query | No | 1..200, 기본값 50 |
| q | string | query | No | 옵션인 대소문자 구분 없는 제목 접두사 필터입니다. |
| sortBy | string | query | No | 정렬 순서. updatedAt (기본값, 최신 순), commentCount (댓글이 가장 많은 순), 또는 title (알파벳 순). |
| hasComments | boolean | query | No | true인 경우, 최소 하나의 댓글이 있는 페이지만 반환합니다. |
Response
Returns: GetPublicPagesResponse
예제

사용자 정보 가져오기 
테넌트의 대량 사용자 정보입니다. 주어진 userIds에 대해 User / SSOUser의 표시 정보를 반환합니다. 댓글 위젯에서 프레즌스 이벤트로 방금 나타난 사용자 정보를 보강하는 데 사용됩니다. 페이지 컨텍스트 없음: 개인정보 보호가 일관되게 적용됩니다(비공개 프로필은 마스킹됨).
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| ids | string | query | Yes | 쉼표로 구분된 userIds. |
응답
예제

페이지 부분 수정 
매개변수
| 이름 | 형식 | Location | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

대기 중인 웹훅 이벤트 삭제 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes |
응답
반환: APIEmptyResponse
예제

대기 중인 웹훅 이벤트 수 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| commentId | string | query | 아니오 | |
| externalId | string | query | 아니오 | |
| eventType | string | query | 아니오 | |
| type | string | query | 아니오 | |
| domain | string | query | 아니오 | |
| attemptCountGT | number | query | 아니오 |
응답
반환: GetPendingWebhookEventCountResponse
예시

대기 중인 웹훅 이벤트 가져오기 
Parameters
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | 문자열 | 쿼리 | 예 | |
| commentId | 문자열 | 쿼리 | 아니오 | |
| externalId | 문자열 | 쿼리 | 아니오 | |
| eventType | 문자열 | 쿼리 | 아니오 | |
| type | 문자열 | 쿼리 | 아니오 | |
| domain | 문자열 | 쿼리 | 아니오 | |
| attemptCountGT | 숫자 | 쿼리 | 아니오 | |
| skip | 숫자 | 쿼리 | 아니오 |
Response
반환: GetPendingWebhookEventsResponse
예시

질문 설정 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: CreateQuestionConfigResponse
예제

질문 설정 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

질문 설정 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

질문 설정 목록 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| skip | number | query | 아니요 |
응답
반환: GetQuestionConfigsResponse
예제

질문 설정 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

질문 결과 생성 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: CreateQuestionResultResponse
예제

질문 결과 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

질문 결과 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

질문 결과 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlId | string | query | No | |
| userId | string | query | No | |
| startDate | string | query | No | |
| questionId | string | query | No | |
| questionIds | string | query | No | |
| skip | number | query | No |
응답
반환: GetQuestionResultsResponse
예제

질문 결과 업데이트 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes |
응답
반환: APIEmptyResponse
예제

질문 결과 집계 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| questionId | string | query | No | |
| questionIds | array | query | No | |
| urlId | string | query | No | |
| timeBucket | string | query | No | |
| startDate | string | query | No | |
| forceRecalculate | boolean | query | No |
응답
반환: AggregateQuestionResultsResponse
예제

질문 결과 대량 집계 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| forceRecalculate | boolean | query | No |
응답
반환: BulkAggregateQuestionResultsResponse
예제

댓글과 질문 결과 결합 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| questionId | string | query | No | |
| questionIds | array | query | No | |
| urlId | string | query | No | |
| startDate | string | query | No | |
| forceRecalculate | boolean | query | No | |
| minValue | number | query | No | |
| maxValue | number | query | No | |
| limit | number | query | No |
응답
반환: CombineQuestionResultsWithCommentsResponse
예시

SSO 사용자 추가 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

SSO 사용자 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes | |
| deleteComments | boolean | query | No | |
| commentDeleteMode | string | query | No |
응답
Returns: DeleteSSOUserAPIResponse
예시

이메일로 SSO 사용자 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| string | path | 예 |
응답
반환: GetSSOUserByEmailAPIResponse
예제

ID로 SSO 사용자 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

SSO 사용자 목록 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| skip | integer | query | No |
응답
예제

SSO 사용자 부분 수정 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| updateComments | boolean | query | 아니오 |
Response
예제

SSO 사용자 대체 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| updateComments | boolean | query | 아니오 |
응답
예제

구독 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: CreateSubscriptionAPIResponse
예제

구독 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니요 |
응답
반환: DeleteSubscriptionAPIResponse
예제

구독 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 아니오 |
응답
반환: GetSubscriptionsAPIResponse
예제

구독 업데이트 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니요 |
응답
반환: UpdateSubscriptionAPIResponse
예제

테넌트 일일 사용량 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| yearNumber | number | query | No | |
| monthNumber | number | query | No | |
| dayNumber | number | query | No | |
| skip | number | query | No |
응답
반환: GetTenantDailyUsagesResponse
예시

테넌트 패키지 생성 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: CreateTenantPackageResponse
예제

테넌트 패키지 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

테넌트 패키지 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

테넌트 패키지 목록 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| skip | number | query | 아니요 |
응답
예제

테넌트 패키지 교체 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

테넌트 패키지 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: APIEmptyResponse
예제

테넌트 사용자 생성 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

테넌트 사용자 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes | |
| deleteComments | string | query | No | |
| commentDeleteMode | string | query | No |
응답
반환: APIEmptyResponse
예시

테넌트 사용자 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

테넌트 사용자 목록 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| skip | number | query | 아니요 |
응답
예제

테넌트 사용자 교체 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| updateComments | string | query | 아니요 |
응답
반환: APIEmptyResponse
예제

로그인 링크 전송 
매개변수
| 이름 | Type | Location | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| redirectURL | string | query | 아니오 |
응답
반환: APIEmptyResponse
예제

테넌트 사용자 업데이트 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| updateComments | string | query | 아니오 |
응답
반환: APIEmptyResponse
예제

테넌트 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
예제

테넌트 삭제 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| sure | string | query | 아니요 |
응답
반환: APIEmptyResponse
예제

테넌트 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

테넌트 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| meta | string | query | 아니오 | |
| skip | number | query | 아니오 |
응답
예시

테넌트 업데이트 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes |
응답
반환: APIEmptyResponse
예제

티켓 상태 변경 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| userId | string | query | Yes | |
| id | string | path | Yes |
응답
예제

티켓 생성 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 예 |
Response
예제

티켓 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| userId | string | query | 아니요 |
응답
예제

티켓 목록 가져오기 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 아니오 | |
| state | number | query | 아니오 | |
| skip | number | query | 아니오 | |
| limit | number | query | 아니오 |
응답
예제

번역 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| namespace | string | path | Yes | |
| component | string | path | Yes | |
| locale | string | query | No | |
| useFullTranslationIds | boolean | query | No |
응답
예시

이미지 업로드 
이미지 업로드 및 리사이즈
Parameters
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| sizePreset | string | query | No | 크기 프리셋: "Default" (1000x1000px) 또는 "CrossPlatform" (인기 디바이스용 크기 생성) |
| urlId | string | query | No | 업로드가 발생하는 페이지 ID, 구성용 |
Response
Returns: UploadImageResponse
Example

ID로 사용자 배지 진행률 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| id | string | path | Yes |
응답
반환: APIGetUserBadgeProgressResponse
예제

사용자 ID로 배지 진행률 가져오기 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | path | 예 |
응답
반환: APIGetUserBadgeProgressResponse
예제

사용자 배지 진행 목록 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| userId | string | query | No | |
| limit | number | query | No | |
| skip | number | query | No |
응답
반환: APIGetUserBadgeProgressListResponse
예시

사용자 배지 생성 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 |
응답
반환: APICreateUserBadgeResponse
예제

사용자 배지 삭제 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

사용자 배지 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
Returns: APIGetUserBadgeResponse
예제

사용자 배지 목록 가져오기 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| userId | string | query | 아니오 | |
| badgeId | string | query | 아니오 | |
| type | number | query | 아니오 | |
| displayedOnComments | boolean | query | 아니오 | |
| limit | number | query | 아니오 | |
| skip | number | query | 아니오 |
응답
예시

사용자 배지 업데이트 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
예제

사용자 알림 수 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| sso | string | query | 아니요 |
응답
반환: GetUserNotificationCountResponse
예제

사용자 알림 가져오기 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlId | string | query | No | 현재 페이지가 구독되었는지 여부를 확인하는 데 사용됩니다. |
| pageSize | integer | query | No | |
| afterId | string | query | No | |
| includeContext | boolean | query | No | |
| afterCreatedAt | integer | query | No | |
| unreadOnly | boolean | query | No | |
| dmOnly | boolean | query | No | |
| noDm | boolean | query | No | |
| includeTranslations | boolean | query | No | |
| includeTenantNotifications | boolean | query | No | |
| sso | string | query | No |
Response
반환: GetMyNotificationsResponse
예시

사용자 알림 수 초기화 
매개변수
| 이름 | 형식 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | 쿼리 | 예 | |
| sso | string | 쿼리 | 아니오 |
응답
반환: ResetUserNotificationsResponse
예제

사용자 알림 초기화 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| afterId | string | query | No | |
| afterCreatedAt | integer | query | No | |
| unreadOnly | boolean | query | No | |
| dmOnly | boolean | query | No | |
| noDm | boolean | query | No | |
| sso | string | query | No |
응답
반환: ResetUserNotificationsResponse
예시

사용자 알림 댓글 구독 상태 업데이트 
특정 댓글에 대한 알림을 활성화하거나 비활성화합니다.
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| notificationId | string | path | 예 | |
| optedInOrOut | string | path | 예 | |
| commentId | string | query | 예 | |
| sso | string | query | 아니요 |
응답
반환: UpdateUserNotificationCommentSubscriptionStatusResponse
예제

사용자 알림 페이지 구독 상태 업데이트 
페이지에 대한 알림을 활성화하거나 비활성화합니다. 사용자가 페이지를 구독하면 새 루트 댓글에 대한 알림이 생성되고, 또한
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| urlId | string | query | 예 | |
| url | string | query | 예 | |
| pageTitle | string | query | 예 | |
| subscribedOrUnsubscribed | string | path | 예 | |
| sso | string | query | 아니요 |
응답
반환: UpdateUserNotificationPageSubscriptionStatusResponse
예제

사용자 알림 상태 업데이트 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| notificationId | string | path | 예 | |
| newStatus | string | path | 예 | |
| sso | string | query | 아니요 |
응답
반환: UpdateUserNotificationStatusResponse
예제

사용자 접속 상태 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlIdWS | string | query | Yes | |
| userIds | string | query | Yes |
응답
반환: GetUserPresenceStatusesResponse
예제

사용자 검색 
Parameters
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | path | Yes | |
| urlId | string | query | Yes | |
| usernameStartsWith | string | query | No | |
| mentionGroupIds | array | query | No | |
| sso | string | query | No | |
| searchSection | string | query | No |
응답
예시

사용자 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 |
응답
반환: GetUserResponse
예제

투표 생성 
매개변수
| 이름 | 타입 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| commentId | string | query | Yes | |
| direction | string | query | Yes | |
| userId | string | query | No | |
| anonUserId | string | query | No |
응답
반환: VoteResponse
예제

투표 삭제 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| id | string | path | 예 | |
| editKey | string | query | 아니요 |
응답
예제

투표 가져오기 
매개변수
| 이름 | 유형 | 위치 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | string | query | 예 | |
| urlId | string | query | 예 |
응답
반환: GetVotesResponse
예제

사용자용 투표 가져오기 
매개변수
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | query | Yes | |
| urlId | string | query | Yes | |
| userId | string | query | No | |
| anonUserId | string | query | No |
응답
예제

도움이 필요하신가요?
Python SDK에 관해 문제가 발생하거나 질문이 있는 경우, 다음을 이용해 주세요:
기여
기여는 환영합니다! 기여 지침은 GitHub 저장소를 방문해 주세요.