Quick Start

API 빠른 시작 가이드

5분 만에 탄소이음 API를 시작하세요

이 가이드를 따라 API 키를 발급받고 첫 번째 API 호출을 해보세요.

회원가입 및 로그인

탄소이음 계정을 만들고 대시보드에 접속합니다.

이미 계정이 있다면 이 단계를 건너뛰세요.

API 키 발급

로그인 후 설정 > API 키 관리 페이지에서 API 키를 생성합니다.

// 1. 로그인 후 설정 > API 키 관리 이동
//    https://your-domain.com/settings/api
//
// 2. "새 API 키" 버튼 클릭 → 이름, 권한 범위 설정
//
// 3. 생성된 API 키를 안전한 곳에 저장
//    예: ea_live_aBcDeFgHiJkLmNoPqRsT...

API 키는 생성 시 한 번만 표시됩니다. 안전한 곳에 저장하세요.

첫 번째 API 호출

사이트 목록을 조회하여 API 연동이 정상 동작하는지 확인합니다.

# 사이트 목록 조회
curl https://carbonieum.co.kr/api/sites \
  -H "Authorization: Bearer ea_live_YOUR_API_KEY"

# 응답 예시
{
  "success": true,
  "data": [
    {
      "id": "site_abc123",
      "name": "서울 본사",
      "industry": "building",
      "devices": 15,
      "status": "active"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20
  }
}

데이터 조회 및 활용

실시간 에너지 데이터를 조회하고, AI 분석 기능을 활용합니다.

# 실시간 전력 데이터 조회
curl https://carbonieum.co.kr/api/realtime?siteId=site_abc123 \
  -H "Authorization: Bearer ea_live_YOUR_API_KEY"

# AI 부하 예측 실행
curl -X POST https://carbonieum.co.kr/api/ai/forecast \
  -H "Authorization: Bearer ea_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": "site_abc123",
    "horizon": "24h",
    "granularity": "1h"
  }'

SDK 사용 예시

Node.js / TypeScriptnpm install @탄소이음/sdk

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

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

// 사이트 목록 조회
const sites = await client.sites.list();
console.log(sites);

// AI 부하 예측
const forecast = await client.ai.forecast({
  siteId: 'site_abc123',
  horizon: '24h'
});
console.log(forecast.predictions);

Pythonpip install 탄소이음

from 탄소이음 import 탄소이음

client = 탄소이음(api_key="ea_live_YOUR_API_KEY")

# 사이트 목록 조회
sites = client.sites.list()
print(sites)

# AI 부하 예측
forecast = client.ai.forecast(
    site_id="site_abc123",
    horizon="24h"
)
print(forecast.predictions)

다음 단계

API 엔드포인트

전체 API 레퍼런스 확인

AI 기능 활용

부하 예측, 이상 탐지 가이드

기술 지원

질문이 있으시면 문의하세요