엔드포인트 그룹

API는 하나의 게이트웨이(api.rolchat.com)에서 제공되며, 게이트웨이는 각 경로 그룹을 그것을 소유한 서비스로 라우팅합니다. 이 페이지는 게이트웨이가 고객에게 제공하는 모든 그룹을 모듈별로 나열합니다. 모든 그룹은 규약(봉투, 페이지네이션, 멱등성, 오류 코드)을 공유하므로, 이 표는 리소스가 어디에 있는지와 호출이 어떻게 인증되는지를 알려 줍니다.

경로는 접두사입니다. /api/v1/contacts는 GET /contacts, POST /contacts, GET /contacts/:id, PATCH /contacts/:id 등을 포함합니다. 가장 긴 접두사가 우선하므로 /kb/public 같은 공개 하위 그룹이 인증이 필요한 /kb 아래에 있을 수 있습니다.

인증 버킷

버킷	호출할 수 있는 대상
user	계정 멤버 - JWT 또는 API 키, X-Account-Id 필수
login	익명, 엄격한 로그인 제한(IP당 분당 10회)
unauthenticated	익명
widget	익명, 사이트 키와 출처로 범위 제한(사이트 및 IP당 분당 60회)
webhook-inbound	보낸 쪽이 서명 - 웹훅 참고
partner	파트너 JWT(파트너 포털)

그룹

Auth & account

접두사	서비스	버킷
/api/v1/auth	iam-service	login
/api/v1/captcha	iam-service	unauthenticated
/api/v1/me	iam-service	user
/api/v1/accounts	iam-service	user
/api/v1/account-settings	iam-service	user
/api/v1/users	iam-service	user
/api/v1/members	iam-service	user
/api/v1/roles	iam-service	user
/api/v1/tokens	iam-service	user
/api/v1/staff-access-policy	iam-service	user
/api/v1/staff-access-sessions	iam-service	user
/api/v1/presence	iam-service	user
/api/v1/workforce	iam-service	user
/api/v1/sites	sites-service	user
/api/v1/profile	profile-service	user
/api/v1/teams	teams-service	user
/api/v1/audit	audit-service	user

Conversations & inbox

접두사	서비스	버킷
/api/v1/conversations	conversation-service	user
/api/v1/messages	conversation-service	user
/api/v1/conversation-tags	conversation-service	user
/api/v1/inboxes	conversation-service	user
/api/v1/views	conversation-service	user
/api/v1/templates	conversation-service	user
/api/v1/chat-routing-rules	conversation-service	user
/api/v1/macros	conversation-service	user
/api/v1/chat-settings	conversation-service	user
/api/v1/tasks	conversation-service	user

CRM

접두사	서비스	버킷
/api/v1/leads	crm-service	user
/api/v1/contacts	crm-service	user
/api/v1/companies	crm-service	user
/api/v1/deals	crm-service	user
/api/v1/pipelines	crm-service	user
/api/v1/lead-statuses	crm-service	user
/api/v1/contact-tags	crm-service	user
/api/v1/segments	crm-service	user
/api/v1/lead-routing-rules	crm-service	user
/api/v1/crm-settings	crm-service	user
/api/v1/crm/campaigns	crm-service	user
/api/v1/custom-fields	meta-service	user

Tickets

접두사	서비스	버킷
/api/v1/tickets	ticket-service	user
/api/v1/ticket-queues	ticket-service	user
/api/v1/ticket-settings	ticket-service	user
/api/v1/ticket-sla-policies	ticket-service	user
/api/v1/ticket-custom-fields	ticket-service	user
/api/v1/ticket-tags	ticket-service	user

Channels & widget

접두사	서비스	버킷
/api/v1/channels	channel-service	user
/api/v1/widget-configs	channel-service	user
/api/v1/widget	visitor-service	widget
/api/v1/webhooks	channel-service	webhook-inbound

Visitors

접두사	서비스	버킷
/api/v1/visitors	visitor-service	user
/api/v1/geo-source	visitor-service	user
/api/v1/funnels	visitor-service	user

Knowledge base

접두사	서비스	버킷
/api/v1/kb	kb-service	user
/api/v1/kb/public	kb-service	widget

Marketing

접두사	서비스	버킷
/api/v1/marketing	marketing-service	user
/api/v1/marketing/public	marketing-service	widget
/api/v1/surveys	marketing-service	user
/api/v1/survey-responses	marketing-service	user
/api/v1/meetings	marketing-service	user

Phone

접두사	서비스	버킷
/api/v1/phone/twilio	phone-service	webhook-inbound
/api/v1/phone	phone-service	user

Automation

접두사	서비스	버킷
/api/v1/automation	automation-service	user

Reports

접두사	서비스	버킷
/api/v1/reports	analytics-service	user
/api/v1/dashboards	analytics-service	user
/api/v1/kpi	analytics-service	user

Privacy & consent

접두사	서비스	버킷
/api/v1/consent	privacy-service	widget
/api/v1/privacy	privacy-service	user
/api/v1/privacy/public	privacy-service	widget

AI

접두사	서비스	버킷
/api/v1/ai	plugin-service	user · 60초 시간 제한
/api/v1/ai/assistant/reply	plugin-service	webhook-inbound

Notifications

접두사	서비스	버킷
/api/v1/notifications-policy	notification-service	user
/api/v1/notifications	notification-service	user
/api/v1/notification-templates	notification-service	user
/api/v1/notification-delivery-logs	notification-service	user
/api/v1/push	notification-service	user

Media

접두사	서비스	버킷
/api/v1/media	media-service	user

Billing

접두사	서비스	버킷
/api/v1/billing	billing-service	user
/api/v1/billing/webhooks/stripe	billing-service	webhook-inbound

Partner portal

접두사	서비스	버킷
/api/v1/partner	partner-portal-service	partner
/api/v1/partner/auth	iam-service	login
/api/v1/partner/invitations	partner-portal-service	login
/api/v1/partner/auth/mfa/enroll	iam-service	partner
/api/v1/partner/auth/mfa/confirm	iam-service	partner
/api/v1/partner/auth/step-up	iam-service	partner
/api/v1/r	partner-portal-service	widget

Identity verification (KYC)

접두사	서비스	버킷
/api/v1/kyc/webhooks/sumsub	kyc-service	webhook-inbound
/api/v1/kyc/webhooks/didww	kyc-service	webhook-inbound
/api/v1/kyc	kyc-service	user

기타

접두사	서비스	버킷
/api/v1/auth/me	iam-service	user
/api/v1/auth/sessions	iam-service	user
/api/v1/auth/mfa	iam-service	user
/api/v1/auth/email-change	iam-service	user
/api/v1/auth/swap-company	iam-service	user
/api/v1/privacy/policies	privacy-service	user
/api/v1/compliance	privacy-service	user
/api/v1/identity-graph	identity-graph-service	user

목록의 출처

이 표는 백엔드 저장소에 있는 게이트웨이의 라우트 테이블에서 생성되어 이 사이트에 스냅숏으로 들어옵니다. 배포할 때마다 스냅숏을 현재 라우트 테이블과 비교하는 검사가 실행되므로, 이 페이지가 바뀌지 않은 채 제품에서 그룹이 추가되거나 제거될 수 없습니다. 내부 직원 콘솔 경로는 제외됩니다. 기계 판독 가능한 OpenAPI 문서는 OpenAPI 페이지에서 설명합니다.