RoomScope

최종 업데이트

변경 내역

RoomScope의 변경 사항을 최신순으로 정리했습니다: API, 대시보드, 공개 사이트. 호환되지 않는 API 변경은 새 버전 접두사로 배포되며, v1의 모든 것은 하위 호환을 유지합니다.

  1. 추가블로그
    블로그가 /posts에서 영어와 베트남어로 공개되었습니다. 카테고리 및 작성자 페이지, RSS 피드, FAQPage 마크업이 포함된 FAQ 블록, 이미지가 없는 글을 위한 자동 생성 브랜드 커버를 제공합니다. 글 안의 링크는 페이지 언어를 유지합니다.
  2. 수정앱으로 가는 링크가 언어를 유지
    사이트에서 대시보드로 가는 모든 링크가 페이지 언어를 함께 전달하므로, 앱이 읽고 있던 언어로 열립니다.
  3. 추가공개 랭킹 페이지
    지원되는 모든 국가에 보드별 공개 페이지가 /rankings/<국가>/<보드>에 있으며, 국기가 있는 국가 허브, 데이터로 만든 요약과 FAQ, JSON-LD, 사이트맵이 함께 제공됩니다. 지역 그룹은 발칸반도, MENA, LATAM, 캅카스 및 중앙아시아로 표시됩니다. 홈페이지에는 실제 수치와 국가별 보드가 표시됩니다.
  4. 변경모든 언어의 SEO 메타데이터
    모든 공개 페이지에 언어별 제목, 설명, Open Graph 이미지, canonical 및 hreflang 링크를 제공합니다. www는 기본 도메인으로 리디렉션됩니다.
  5. 추가대시보드 11개 언어 지원
    대시보드와 운영 관리자 화면이 사이트와 같은 11개 언어를 지원하며, 언어 메뉴와 아랍어용 오른쪽에서 왼쪽 레이아웃을 갖췄습니다. 영어와 베트남어는 사람이 검수했고, 나머지 9개 언어는 기계 번역입니다.
  6. 추가정렬, 검색, 에이전시 비교, 기프터 상세
    Rankings, Gifters, Watchlist, Live history, Recruit 표에서 정렬과 검색이 가능합니다. 에이전시에는 healthScore, 지역별 KPI, 나란히 비교 기능이 있습니다. 기프터 관심 목록은 CSV를 가져올 수 있고, 기프터를 열면 드로어에 후원하는 크리에이터와 30일간의 다이아몬드가 표시됩니다.
  7. 변경요금제: 등급당 단일 가격
    Pricing과 Billing에 Free, Starter, Pro, Agency, Enterprise가 각각 하나의 가격으로 표시되며, Scale은 사라졌습니다. 충전은 대화 상자에서 열리고, 피드백 보내기는 계정 메뉴에 있습니다.
  8. 수정보드, 동영상, 관심 목록 상태, 초대
    GET /v1/rankings/regions가 TikTok이 해당 지역에서 운영하지 않는 보드(notOfferedBoards)를 나열하고 대시보드는 이를 비활성화합니다. 크리에이터의 동영상은 저장된 것이 없으면 요청 시 가져옵니다. 보드와 크리에이터 드로어에 관심 목록 상태가 표시되고, 초대받은 사람은 초대한 워크스페이스로 들어갑니다.
  9. 추가지역별 선물 카탈로그
    GET /v1/gifts가 TikTok의 선물 카탈로그를 지역별로 코인 가치와 함께 나열하며, 검색과 정렬이 가능합니다. Popular LIVE 팀 보드는 클럽 이름과 커뮤니티 레벨을 유지합니다.
  10. 추가Recruit, Gifters, Agencies, Exports v2
    /recruit: 호스트 Discover, CRM 타임라인이 있는 Pipeline, 채널별 다이제스트. /gifters: 세그먼트와 기간을 지원하는 GET /v1/gifters와 알림이 있는 기프터 관심 목록. 에이전시: GET /v1/agencies와 지역별 공개 페이지 /agencies. GET /v1/rankings/day-bars는 보드의 일별 바를 반환합니다. Exports v2: POST /v1/exports가 rankings, watchlist, gifters, recruit_pipeline 데이터셋을 provenance와 함께 백그라운드에서 생성하며, 앱 내 내보내기는 무료입니다. 데이터 삭제 요청 및 투명성 페이지, 지원 채팅, 이메일 설정이 새로 추가되었습니다.
  11. 추가알림, LIVE 기록, 관심 목록, 크리에이터 분석
    알림: 네 가지 규칙 범위, live_start / live_end, 시간별 호스트 알림, 팔로워 마일스톤, Discord 및 Zalo 채널, 그리고 GET /v1/alerts/fires, /deliveries, /stats. LIVE 기록: 분 단위 GET /v1/live/sessions/{id}/timeline과 /compare. 관심 목록: 호스트 명단, CSV 가져오기, manager 역할. 크리에이터: GET /v1/creators/{uid}/analysis, /changes, /following, /followers; 대시보드의 채팅이 있는 LIVE 플레이어(GET /v1/live/creators/{uid}/comments). 결제: 요금제 카탈로그, 충전을 포함한 하드 캡, API 키별 분당 요청 수.
  12. 추가사이트 11개 언어 지원
    공개 사이트, 문서, API 레퍼런스, 법적 페이지, CMS 콘텐츠가 /<locale>/ 아래 11개 언어로 제공되며 영어가 대체 언어입니다. 공개 Pulse 엔드포인트에 전용 문서 페이지가 생겼습니다.
  13. 추가모든 읽기에 provenance, entitlements에 할당량
    모든 읽기 엔드포인트가 provenance 봉투를 반환합니다. GET /v1/entitlements에 할당량 수치가 포함되고, 402는 할당량이 언제 초기화되는지 알려줍니다. GET /v1/creators/{uid}/gifters는 크리에이터의 상위 기프터를 나열하고, 보드 행에는 점수 스파크라인이 있으며, GET /v1/live/creators/{uid}/playback은 LIVE 영상 소스를 반환합니다. 알림 메시지와 웹훅은 대시보드로 연결됩니다(schema version 2026-11-03). 공개 보드는 마스킹된 행에 LIVE를 표시합니다.
  14. 변경마스킹된 행
    마스킹된 보드 행은 크리에이터의 uid 대신 불투명한 ref를 가집니다. GET /v1/rankings/masked/{ref}는 LIVE 합계만 반환하며 movement, previousRank, 스파크라인은 없습니다. LIVE 기록에는 워크스페이스가 팔로우하는 크리에이터와 방의 세션만 표시됩니다.
  15. 추가Billing & credits 페이지, 공개 pulse
    대시보드의 Billing & credits 페이지에 요금제, 충전, 크레딧 내역이 표시되며 결제는 Dodo Payments를 통해 이루어집니다. 공개 pulse 엔드포인트가 쇼룸 스파크라인에 데이터를 제공하고, 홈페이지에는 실제 쇼룸 보드가 표시됩니다.
  16. 변경Webhook 헤더 이름 변경
    이제 webhook 전송에 x-roomscope-signature, x-roomscope-timestamp, x-roomscope-alert-id, x-roomscope-schema-version 헤더가 포함됩니다. 서명 방식과 페이로드는 바뀌지 않았으며, 검증할 때 새 헤더 이름을 읽으세요.
  17. 수정문서와 API 일치
    오류, 크레딧, 속도 제한, 인증, Webhook 문서가 이제 실제 동작을 설명합니다: 실제 오류 코드, X-RateLimit 헤더를 사용하는 key별 속도 제한, 크레딧 비용과 월간 제공량, 서명된 webhook 방식. 레퍼런스에 크리에이터 인사이트, 최적 방송 시간, LIVE 현황이 추가되었습니다. 문서 검색이 활성화되었습니다(⌘K).
  18. 추가API 문서 템플릿
    시작하기, 인증, 오류, 속도 제한, 랭킹 레퍼런스, Webhook. 나머지 리소스의 레퍼런스 페이지는 OpenAPI 문서에서 생성되는 대로 추가됩니다.
  19. 변경오류 형식
    이제 모든 오류가 { code, message, requestId, retryable }을 반환합니다. 클라이언트는 code로 분기하고 retryable이 true일 때만 재시도해야 합니다.
  20. 추가랭킹: provenance 블록
    GET /v1/rankings/official이 data 옆에 provenance 객체(coverageStatus, observedAt)를 반환합니다.
  21. 추가스코프가 지정된 API key
    key에 명시적인 스코프(rank:read, live:read, creator:read, …)가 지정됩니다. key의 스코프를 벗어난 요청은 403 insufficient_scope로 실패합니다.
이 페이지가 도움이 되었나요?