빠른 시작

API 키를 연동 서버의 환경 변수에 저장한 뒤 GET /organization으로 연결을 확인합니다.

Base URLhttps://api.certi.world/public/v2
  1. 01

    API 키 발급

    써티 콘솔의 조직 API 키 관리 안내 에서 Manager 이상 권한으로 키를 발급합니다. 키 원문은 처음 한 번만 표시되므로 비밀 저장소에 보관합니다.

  2. 02

    .env에 키 저장

    프로젝트 루트의 서버 환경 변수 파일이나 배포 서비스의 비밀 저장소에 넣습니다. 이 파일은 Git에 올리지 않습니다.

    붙여넣는 위치프로젝트 루트/.env
    프로젝트 루트/.env
    CERTI_API_KEY=your-key-from-certi-console
  3. 03

    서버 호출 함수 만들기

    아래는 Node.js 예시입니다. 사용하는 언어와 관계없이 API 키를 서버에만 보관하고 인증·오류 처리를 한 곳에서 공통으로 적용하세요.

    Node.js 예시lib/certi.js
    lib/certi.js · Node.js 예시
    // lib/certi.js — 서버에서만 사용합니다.
const BASE_URL = "https://api.certi.world/public/v2";

export async function certi(path, options = {}) {
  const response = await fetch(`https://api.certi.world/public/v2${path}`, {
    ...options,
    headers: {
      "X-API-KEY": process.env.CERTI_API_KEY,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const result = await response.json();
  if (!response.ok) {
    throw new Error(`${result.error?.code ?? response.status}: ${result.error?.message ?? "Certi API request failed"}`);
  }
  return result.data;
}
  4. 04

    조직 정보로 연결 확인

    GET /organization은 읽기 권한만으로 호출할 수 있어 첫 연결 확인에 적합합니다. 응답의 조직 이름이 예상과 같은지 확인하세요.

터미널
curl -X GET "https://api.certi.world/public/v2/organization" \
  -H "X-API-KEY: $CERTI_API_KEY"
예상 응답200 · application/json
응답 · JSON
{
  "success": true,
  "message": null,
  "data": {
    "id": "01946e3c-72dc-7a42-a40f-f36df9b73d7a",
    "name": "Certi Labs",
    "roleCode": "ORG_MANAGER"
  }
}
다음 단계
API 키는 서버에서만 사용합니다.

브라우저 번들, 모바일 앱, 공개 저장소에 키를 포함하지 마세요.