DimiCheck Dev Platform

프로젝트 불러오는 중

project · origins

D
DimiCheck 사용자 student

플랫폼 상태

프로젝트 단위로 API, OAuth, 위젯, Vars를 관리합니다.

프로젝트0
API 키0
OAuth 앱0
Vars0

제품 표면

API

학급 상태, 캘린더, 카운터, 위젯과 연결되는 기본 데이터 인터페이스.

Live

OAuth

DimiCheck 계정으로 학생 프로젝트 앱에 로그인하는 인증 표면.

Live

Comments Widget

외부 페이지에 DimiCheck 로그인 기반 댓글 스레드를 붙입니다.

Beta

Reactions Widget

프로젝트 글, 후보, 이벤트에 가벼운 반응 집계를 붙입니다.

Beta

Vars

프론트 프로젝트에서 읽는 public config와 feature flag.

Preview

오늘 사용량

요청0
반응 타겟0
댓글 스레드0
상태Open

키 발급

프로젝트 API 호출을 시작합니다.

위젯 붙이기

댓글과 반응 임베드 코드를 확인합니다.

Projects

모든 키, 앱, 위젯, Vars는 프로젝트에 속합니다.

새 프로젝트

예상 주소 project 이름을 입력하면 위젯/API 주소에 들어갈 project slug가 표시됩니다.
허용할 사이트

위젯과 OAuth를 붙일 웹사이트 주소를 추가하세요.

현재 프로젝트

slug · origins

허용할 사이트

로그인이 필요한 위젯은 여기에 등록된 Origin에서만 동작합니다.

API

프로젝트별 API 키와 스코프를 관리합니다.

API 키 발급

스코프 선택

이 키가 실제로 필요한 권한만 켜세요. 선택한 권한은 아래 키 목록에 그대로 표시됩니다.

이름키스코프상태티어관리

OAuth

DimiCheck 로그인으로 학생 프로젝트의 신원을 연결합니다.

OAuth 앱 만들기

OAuth 스코프

로그인 후 앱에 넘길 사용자 정보 범위를 고릅니다.

앱Client ID스코프Redirect생성관리

Widgets

외부 페이지에 댓글과 반응을 붙이는 임베드 표면입니다.

자동 페이지 분리 미리보기

이 URL은 어떤 댓글방이 될까?

auto는 아래 URL에서 hash와 추적 파라미터를 제외한 뒤 안정적인 key로 바꿉니다.

생성될 key page-posts-hello-page-1

Reactions Widget

data-target="auto"면 현재 페이지별로 반응 공간이 자동 분리됩니다.

반응 종류

    Comments Widget

    data-thread="auto"면 현재 페이지별로 댓글 스레드가 자동 분리됩니다.

      Vars

      v1은 public config와 feature flag만 제공합니다.

      Var 추가

      KeyTypeValue수정관리

      Usage

      현재 프로젝트의 API 사용량과 한도를 확인합니다.

      최근 7일 요청

      최근 진단 로그

      API, OAuth, 위젯 요청이 왜 성공/실패했는지 확인합니다.

      Docs

      현재 프로젝트를 외부 서비스에 붙이는 순서와 호출 계약입니다.

      현재 프로젝트

      Project

      외부 사이트에서는 프로젝트 주소 slug를 기준으로 Vars와 위젯 API를 호출합니다.

      Origin 상태

      Allowed origins를 확인하는 중입니다.

      시작 순서

      1. 프로젝트 만들기동아리 페이지, 이벤트 페이지, 개인 서비스처럼 배포 단위마다 하나씩 만듭니다.
      2. 허용할 사이트 등록로그인 기반 위젯/OAuth를 쓰려면 배포 Origin을 칩으로 추가합니다. *는 공개 읽기 전용입니다.
      3. 필요한 기능만 켜기API 키, OAuth 앱, Vars, Comments/Reactions 위젯 중 필요한 표면만 발급합니다.
      4. 미리보기 후 붙이기대시보드 미리보기에서 모양과 상태를 확인한 다음 아래 코드를 외부 사이트에 넣습니다.
      01

      Vars

      외부 프론트에서 읽는 공개 설정값과 feature flag입니다.

      Endpoint
      Auth
      없음. public/flag 타입만 반환합니다.
      02

      API

      서버에서 DimiCheck 공개 API를 호출할 때 쓰는 키입니다.

      Header
      Dimicheck-API-Key
      Base
      • 브라우저 코드에 API 키를 직접 넣지 마세요. 서버나 Worker에서 호출하세요.
      • 스코프는 키가 실제로 필요한 권한만 선택하세요.
      03

      OAuth

      외부 서비스에 “DimiCheck로 로그인”을 붙이는 인증 흐름입니다.

      Authorize
      Token
      UserInfo
      • 공개 클라이언트는 PKCE를 사용하세요.
      • Redirect URI는 대시보드에 등록한 값과 정확히 같아야 합니다.
      04

      Reactions Widget

      글, 후보, 작품에 DimiCheck 스타일 반응 집계를 붙입니다.

      Endpoint
      Page key
      auto는 path와 의미 있는 query를 기준으로 자동 생성합니다.
      Style
      data-mount, data-title, data-accent, data-width, data-max-width, data-density, data-reactions 지원
      Origin
      쓰기/로그인 기능은 정확한 Origin 등록 필요
      05

      Comments Widget

      DimiCheck 닉네임/아바타 기반 댓글 스레드를 붙입니다.

      Endpoint
      Page key
      auto는 hash와 utm_* 추적 파라미터를 제외합니다.
      Style
      data-mount, data-title, data-placeholder, data-accent, data-width, data-max-width, data-density 지원
      Moderation
      작성자, 프로젝트 소유자, 교사가 삭제 가능
      • 댓글 목록은 cursor pagination으로 불러옵니다.
      • 로그인하지 않은 사용자는 읽기 중심 UI를 보게 됩니다.
      06

      운영 규칙

      배포 전에 헷갈리기 쉬운 보안/UX 규칙입니다.

      • Origin*는 공개 읽기만. 댓글 작성, 반응, 삭제, CSRF 세션은 정확한 Origin에서만 동작합니다.
      • 프로젝트 이름이름이 겹치면 slug는 자동으로 -2, -3처럼 올라갑니다.
      • 페이지별 분리여러 페이지를 각각 나누려면 auto, 여러 페이지를 하나로 묶으려면 직접 키를 쓰세요.
      • 위치/스타일data-mount로 붙일 위치를 정하고, accent/width/density/title만 안전하게 조정할 수 있습니다.
      • 위젯 로그인외부 사이트에서는 쿠키 대신 Origin에 묶인 위젯 토큰으로 돌아오므로, 새로고침 후에도 같은 탭에서 작성 상태가 유지됩니다.
      • 탈퇴 사용자다른 프로젝트에 남긴 댓글은 익명 처리되고, 본인 프로젝트 데이터는 계정 삭제 시 함께 제거됩니다.
      • 댓글 폭증위젯은 한 번에 제한된 수만 가져오고 “이전 댓글 더 보기”로 이어서 불러옵니다.