API Documentation

탄소이음 API

REST API, WebSocket, Webhook을 통해 탄소이음 플랫폼을 통합하세요

빠른 시작

1

API 키 발급

설정 페이지에서 API 키를 생성합니다

2

인증 헤더 설정

모든 요청에 Authorization 헤더를 포함합니다

Authorization: Bearer ea_live_YOUR_API_KEY
3

API 호출

REST API를 호출하여 데이터를 조회하거나 제어합니다

curl https://api.탄소이음.io/api/sites
4

응답 처리

JSON 형식의 응답을 파싱하여 애플리케이션에 통합합니다

API 엔드포인트

인증 (Authentication)

POST/api/auth/login로그인 및 세션 토큰 발급
POST/api/auth/register신규 사용자 등록
GET/api/auth/tokenBearer JWT 토큰 발급
POST/api/api-keysAPI 키 생성 (설정 > API 키 관리)

사이트 & 디바이스

GET/api/sites사이트 목록 조회
POST/api/sites신규 사이트 등록
GET/api/devices디바이스 목록 조회
POST/api/devices디바이스 등록

실시간 데이터

GET/api/realtime실시간 전력 데이터 조회
WSwss://api.탄소이음.io/wsWebSocket 실시간 스트리밍

AI 분석

POST/api/ai/forecastAI 부하 예측 실행
POST/api/ai/anomaly이상 탐지 분석
POST/api/ai/optimize에너지 최적화 제안

Webhooks

POST/api/webhooksWebhook 등록
GET/api/webhooksWebhook 목록 조회

예제 코드

요청

# 사이트 목록 조회
curl https://api.탄소이음.io/api/sites \
  -H "Authorization: Bearer ea_live_YOUR_API_KEY"

# 디바이스 목록 조회
curl https://api.탄소이음.io/api/devices \
  -H "Authorization: Bearer ea_live_YOUR_API_KEY"

응답

{
  "success": true,
  "data": {
    "apiKey": "ea_live_1234567890abcdef",
    "name": "My API Key",
    "scopes": ["read:sites", "write:devices"],
    "createdAt": "2026-02-03T10:30:00Z",
    "expiresAt": null
  }
}

SDK 라이브러리

Node.js

JavaScript/TypeScript SDK

npm install @탄소이음/sdk
import { 탄소이음 } from '@탄소이음/sdk';

const client = new 탄소이음({
  apiKey: process.env.탄소이음_API_KEY
});

const sites = await client.sites.list();

Python

Python SDK

pip install 탄소이음
from 탄소이음 import 탄소이음

client = 탄소이음(api_key="ea_live_...")

sites = client.sites.list()

cURL

직접 HTTP 호출

별도 설치 불필요
curl https://api.탄소이음.io/api/sites \
  -H "Authorization: Bearer ea_live_..."

API 사용 한도

요금제일일 요청 수분당 요청 수
Free1,000 / 일10 / 분
Pro100,000 / 일100 / 분
Enterprise무제한1,000 / 분

API 통합을 시작할 준비가 되셨나요?

지금 바로 API 키를 발급받고 통합을 시작하세요

API 문서 - 탄소이음 | 탄소이음