Deeply API 문서 main logoDeeply API 문서 main logo textDeeply API 문서 main logo text
사용자 가이드서버 API 레퍼런스
검색...
k
언어ENKO

© 2026 Deeply Inc.

Deeply Logo Icon

Deeply API 문서

    릴리즈 노트

    빠른 시작

    API 빠른 시작
    인증
    호출 제한

    아키텍처

    전체 아키텍처
    엣지 서버 시스템

    이벤트

    이벤트
    이벤트 카테고리
    이벤트 목록 조회
    GET
    단일 이벤트 조회
    GET

    복합 이벤트

    복합 이벤트
    복합 이벤트 목록 조회
    GET
    단일 복합 이벤트 조회
    GET
    실시간 복합 이벤트 수신
    WebSocket

    실시간 이벤트

    실시간 이벤트
    실시간 이벤트 수신
    WebSocket

    엣지 서버

    엣지 서버
    엣지 서버 목록 조회
    GET
    단일 엣지 서버 조회
    GET
    엣지 서버 수정
    PATCH

    마이크

    마이크 장치
    마이크 목록 조회
    GET
    단일 마이크 조회
    GET
    마이크 수정
    PATCH

    인증

    토큰 발급
    POST
    토큰 재발급
    GET
    1. 레퍼런스
    2. 토큰 발급

    토큰 발급

    API 계정 정보로 Access Token과 Refresh Token을 발급합니다.

    마지막 업데이트: 2026년 11월 12일

    POST
    /api/v1/auth/token

    설명

    API 계정 정보(username, password)로 새 Access Token과 Refresh Token을 발급합니다. 연동을 시작할 때 한 번 호출하고, 이후 Refresh Token이 만료되었을 때 다시 호출하세요.

    API 계정 정보는 대시보드에서 발급되지 않습니다. contact@deeplyinc.com으로 요청하시면 메일로 전달해 드립니다.

    인증

    이 엔드포인트는 Authorization 헤더를 사용하지 않습니다. API 계정 정보를 JSON 요청 본문에 담아 보내 주세요.

    요청 본문

    요청 본문 파라미터

    username
    Required
    string
    Deeply가 전달한 API 계정의 사용자 이름
    password
    Required
    string
    Deeply가 전달한 API 계정의 비밀번호

    응답 필드

    • access_token: 일반 API 요청과 WebSocket 연결에 사용하는 Bearer 토큰
    • refresh_token: 토큰 재발급에만 사용하는 토큰
    • token_type: 항상 Bearer
    • expires_in: Access Token 유효 시간(초, 기본값 3600)

    Refresh Token의 기본 유효 기간은 30일입니다.

    응답

    1
    2
    3
    4
    5
    6
    {
      "access_token": "string",
      "refresh_token": "string",
      "token_type": "Bearer",
      "expires_in": 3600
    }

    요청 예시

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/auth/token', {
      method: 'POST',
      headers: {
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        "username": "api",
        "password": "YOUR_PASSWORD"
      })
    });
    
    const data = await response.json();
    마이크 수정
    토큰 재발급
    설명인증요청 본문응답 필드응답요청 예시