https://api.di-bo.me

access-token: {your_access_token}

# 회원(end-user) 본인 요청 시 추가
member-token: {member_token}

<!-- Axios CDN -->
<script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
<!-- dibo-token Info -->
<script>
    const diboToken = 'eyJhbGciOiJIUzI1NiIsInR...'
    let diboMemberToken;
</script>
<!-- member-token 유효성 확인 -->
<script>
    window._diboMemberReady = (async function checkMemberToken() {
        const memberToken = localStorage.getItem('member-token');
        if (!memberToken) return;
        try {
            await axios.get('https://api.di-bo.me/member/token', {
                headers: {
                    'access-token': diboToken,
                    'member-token': memberToken,
                }
            });
            diboMemberToken = memberToken;
        } catch (error) {
            if (error.response && error.response.status === 401) {
                localStorage.removeItem('member-token');
            }
        }
    })();
</script>

GET /config?site_id={site_id}

Content-Type: application/json
access-token: {your_access_token}

// 예: 블록(배너/카드) 위젯 데이터를 받아 렌더
const res = await axios.get(`https://api.di-bo.me/block?config_id=copy_config_id`, {
  headers: { 'access-token': diboToken }
});
res.data.forEach((item) => {
  // item.main_img_url, item.title, item.link 로 카드 렌더
});

interface ExtensionBlock {
  id: string;                // 블록 고유 ID
  client_id: string;         // 클라이언트 ID
  config_id: string;         // 설정 ID
  main_img_url?: string;     // 메인 이미지 URL
  sub_img_url?: string;      // 서브 이미지 URL
  title: string;             // 제목 (최대 128자)
  content?: string;          // 내용
  link?: string;             // 링크 URL
  display_order?: number;    // 표시 순서
  created_at: datetime;      // 생성일시
  updated_at: datetime;      // 수정일시
}

curl -X POST https://api.di-bo.me/block \
  -H "access-token: your_token" \
  -F 'req_body={"config_id":"config_789","title":"새로운 블록","content":"설명","link":"https://example.com"}' \
  -F "main_image=@/path/to/main.jpg" \
  -F "sub_image=@/path/to/sub.jpg"

interface ExtensionTimer {
  id: string;
  client_id: string;
  config_id: string;
  started_at: datetime;      // 시작 시간
  start_title: string;       // 시작 제목 (최대 128자)
  ended_at?: datetime;       // 종료 시간 (선택)
  end_title?: string;        // 종료 제목 (선택)
  display_order?: number;
  created_at: datetime;
  updated_at: datetime;
}

{
  "config_id": "config_789",
  "started_at": "2024-01-20T09:00:00Z",
  "start_title": "이벤트 시작",
  "ended_at": "2024-01-20T21:00:00Z",
  "end_title": "이벤트 종료"
}

interface ExtensionEdit {
  id: string;
  client_id: string;
  config_id: string;
  set_id: string;        // 폼 설정 ID
  column_1: string;      // 컬럼1 (필수)
  column_2?: string;
  column_3?: string;
  // ... column_10까지
  created_at: datetime;
  updated_at: datetime;
}

curl -X POST https://api.di-bo.me/edit-set/{set_id}/rows \
  -H "access-token: your_token" \
  -F 'req_body={"config_id":"config_789"}' \
  -F "column_1=홍길동" \
  -F "column_2=hong@example.com" \
  -F "column_3=010-1234-5678" \
  -F "column_4=기술 지원" \
  -F "column_5=API 연동 관련 문의드립니다." \
  -F "column_6=@/path/to/document.pdf"

interface ExtensionPopup {
  id: string;
  status?: 'active' | 'inactive';
  schedule?: PopupSchedule;
  title: string;
  description?: string | null;
  image_url?: string | null;
  link_url?: string | null;
  link_target?: string;          // _self | _blank
  show_pages?: string[];         // 빈 배열이면 전체 페이지
}

interface PopupSchedule {
  type?: 'always' | 'period';
  schedule_started_at?: string | null;
  schedule_ended_at?: string | null;
}

const res = await axios.get(`https://api.di-bo.me/popup?config_id=copy_config_id`, {
  headers: { 'access-token': diboToken }
});
res.data.forEach((popup) => {
  if (popup.status !== 'active') return;
  // popup.title / popup.image_url / popup.link_url 로 모달 렌더
});

interface ExtensionFloating {
  display: FloatingDisplay;
  design: FloatingDesign;
  items?: FloatingItem[];
}

interface FloatingDisplay {
  show_on?: 'all' | 'specific' | 'exclude';
  show_pages?: string[];
  show_delay?: number;
  hide_on_mobile?: boolean;
  hide_on_desktop?: boolean;
}

interface FloatingDesign {
  mode?: 'single' | 'expandable';
  vertical?: string;       // top | bottom
  horizontal?: string;     // left | right
  offset_x?: number;
  offset_y?: number;
  width?: number;
  height?: number;
  border_radius?: number;
  trigger_icon?: string | null;
  trigger_icon_open?: string | null;
}

interface FloatingItem {
  id: string;
  display_order?: number | null;
  label?: string | null;
  icon_url?: string | null;
  link_url?: string | null;
  link_target?: string;    // _self | _blank
}

const res = await axios.get(`https://api.di-bo.me/floating?config_id=copy_config_id`, {
  headers: { 'access-token': diboToken }
});
const { design, items } = res.data;
const list = design.mode === 'single' ? items.slice(0, 1) : items;
// design.vertical/horizontal 위치에 list 의 각 항목(icon_url/label/link_url) 렌더

interface ExtensionRolling {
  rolling: RollingConfig;
  items?: RollingItem[];
}

interface RollingConfig {
  auto_play?: boolean;
  interval?: number;          // 전환 간격(ms)
  pause_on_hover?: boolean;
  loop?: boolean;
  direction?: 'horizontal' | 'vertical';
  transition?: RollingTransition;
}

interface RollingTransition {
  style?: 'slide' | 'fade' | 'zoom' | 'flip' | 'none';
  duration?: number;
  easing?: string;            // CSS easing (예: ease-in-out)
}

interface RollingItem {
  id: string;
  image_url?: string | null;
  mobile_image_url?: string | null;
  video_url?: string | null;
  title?: string | null;
  description?: string | null;
  button_label?: string | null;
  link_url?: string | null;
  link_target?: string;       // _self | _blank
}

const res = await axios.get(`https://api.di-bo.me/rolling-banner?config_id=copy_config_id`, {
  headers: { 'access-token': diboToken }
});
const { rolling, items } = res.data;
// items 를 rolling.interval 간격으로 rolling.transition.style 전환하며 슬라이드 렌더

interface MemberToken {
  member_token: string;
  pwd_change_required?: boolean;
  email_verified?: boolean;
}

interface MemberDetailWithCustom {
  id: string;
  site_id: string;
  group_ids?: string[] | null;
  email: string;
  user_id?: string | null;
  member_type: 'general' | 'business';
  profile_img?: string | null;
  name?: string | null;
  phone_num?: string | null;
  birth_date?: string | null;
  status: string;
  email_verified?: boolean | null;
  created_at: string;
  updated_at: string;
  // 그룹 설정에 따라 business_* 또는 custom_1~5 추가될 수 있음
}

{ "email": "member@example.com", "pwd": "Password1234!" }

interface MemberGroup {
  id: string;
  site_id: string;
  name: string;
  group_type: 'general' | 'business';
  login_type?: 'email' | 'id';
  join_process?: 'approval' | 'auto';
  pw_min_length?: number;
  pw_policy?: { upper?: boolean; number?: boolean; special?: boolean };
  profile_field?: { use?: boolean; required?: boolean };
  terms_enabled?: boolean;
  terms_content?: { service?: string; privacy?: string; marketing?: string };
  general_fields?: object | null;
  business_fields?: object | null;
  custom_fields?: CustomFieldSetting[] | null;
  created_at: string;
  updated_at: string;
}

interface CustomFieldSetting {
  type?: string;
  name?: string;
  options?: string[];
  use?: boolean;
  required?: boolean;
}

const res = await axios.get(`https://api.di-bo.me/member-group?site_id=SITE_ID`, {
  headers: { 'access-token': diboToken }
});
const group = res.data[0];
// group.login_type(email/id), group.custom_fields, group.terms_content 에 맞춰 폼 렌더

interface Post {
  id: number;
  board_id: string;
  slug: string;
  category?: string | null;
  title: string;
  content: string;           // HTML
  author: string;
  views?: number;
  thumbnail?: string | null;
  tags?: string[];
  likes?: number;
  dislikes?: number;
  my_vote?: string | null;   // member-token 있을 때 본인 투표 상태
  comments_enabled?: boolean;
  is_guest_post?: boolean;
  created_at: string;
  updated_at: string;
}

interface Comment {
  id: number;
  post_id: number;
  author: string;
  content: string;
  images?: string[];
  likes?: number;
  secret?: boolean;
  replies?: Reply[];
  created_at: string;
}

// 회원 글 작성 (member-token)
await window._diboMemberReady;
await axios.post(`https://api.di-bo.me/board/boards/${boardId}/posts`,
  { title: '문의합니다', content: '<p>내용</p>', category: '일반' },
  { headers: { 'access-token': diboToken, 'member-token': diboMemberToken } }
);

// 비회원 글 작성 (비회원 허용 게시판)
await axios.post(`https://api.di-bo.me/board/boards/${boardId}/posts`,
  { title: '문의', content: '<p>내용</p>', author: '홍길동', password: '1234' },
  { headers: { 'access-token': diboToken } }
);

// Request Body (ReqImwebIntegration)
{
  "site_id": "your_site_id",
  "imweb_site_code": "아임웹 사이트 코드",
  "imweb_client_id": "아임웹 앱 client_id",
  "imweb_client_secret": "아임웹 앱 client_secret"
}

// Response 200
{
  "site_id": "string",
  "imweb_site_code": "string",
  "imweb_client_id": "string",
  "status": "string",
  "scope": "string | null",
  "unit_code": "string | null",
  "redirect_uri": "string | null",
  "created_at": "datetime",
  "updated_at": "datetime"
}

// Response 200
{
  "authorize_url": "https://auth.imweb.me/oauth2/authorize?..."
}

interface Extension {
  id: string;
  extension_type: 'free' | 'block' | 'timer' | 'edit' | 'popup' | 'floating' | 'rolling_banner';
  status: 'approved' | 'disapproved' | 'deleted';
  title: string;
  content?: string | null;
  keyword?: string[] | null;
  thumbnail_url?: string | null;
  image_urls?: string[] | null;
  created_at: string;
  updated_at: string;
}

interface ExtensionConfig {
  id: string;             // config_id
  site_id: string;
  extension_id: string;
  status: 'approved' | 'disapproved';
  title: string;
  extension_type: string;
  thumbnail_url?: string | null;
  created_at: string;
  updated_at: string;
}

const res = await axios.get(`https://api.di-bo.me/config?site_id=SITE_ID`, {
  headers: { 'access-token': diboToken }
});
const popup = res.data.find((c) => c.extension_type === 'popup');
// popup.id 를 popup 위젯 API 호출 시 config_id 로 사용

{ "detail": "에러 메시지" }

// DIBO 관리 페이지에서 제공된 토큰
const diboToken = 'eyJhbGciOiJIUzI1NiIsInR...'

// 코드 복사에서 확인한 config_id
const configId = 'CFYEDHZSP5ZT'

// 블록 목록 조회
async function getBlocks(configId) {
  const response = await axios.get(`https://api.di-bo.me/block?config_id=${configId}`, {
    headers: { 'access-token': diboToken }
  });
  return response.data;
}

// 블록 생성
async function createBlock(configId, title, content, link, mainImage) {
  const formData = new FormData();
  formData.append('req_body', JSON.stringify({ config_id: configId, title, content, link }));
  if (mainImage) formData.append('main_image', mainImage);

  const response = await axios.post('https://api.di-bo.me/block', formData, {
    headers: { 'access-token': diboToken }
  });
  return response.data;
}

async function createTimer(configId, startTime, startTitle, endTime, endTitle) {
  const response = await axios.post('https://api.di-bo.me/timer', {
    config_id: configId,
    started_at: startTime,
    start_title: startTitle,
    ended_at: endTime,
    end_title: endTitle
  }, {
    headers: { 'access-token': diboToken }
  });
  return response.data;
}

async function submitFormData(setId, configId, fields) {
  const formData = new FormData();
  formData.append('req_body', JSON.stringify({ config_id: configId }));

  // 텍스트 필드 (관리 페이지 설정의 컬럼 순서에 맞춰 매핑)
  Object.entries(fields).forEach(([key, value]) => {
    if (value instanceof File) formData.append(key, value);
    else if (value != null) formData.append(key, String(value));
  });

  const response = await axios.post(`https://api.di-bo.me/edit-set/${setId}/rows`, formData, {
    headers: { 'access-token': diboToken }
  });
  return response.data;
}

import requests, json

class DiboAPI:
    def __init__(self, access_token):
        self.base_url = "https://api.di-bo.me"
        self.headers = { "access-token": access_token }

    def get_blocks(self, config_id):
        res = requests.get(f"{self.base_url}/block?config_id={config_id}", headers=self.headers)
        res.raise_for_status()
        return res.json()

    def create_block(self, config_id, title, content=None, link=None, main_image_path=None):
        files = { 'req_body': (None, json.dumps({"config_id": config_id, "title": title, "content": content, "link": link})) }
        if main_image_path:
            files['main_image'] = open(main_image_path, 'rb')
        res = requests.post(f"{self.base_url}/block", headers=self.headers, files=files)
        res.raise_for_status()
        return res.json()

# 사용 예시
api = DiboAPI(access_token="eyJhbGciOiJIUzI1NiIsInR...")
blocks = api.get_blocks("CFYEDHZSP5ZT")