블로그 가져오기 API
기존 SITE_IMPORT 키로 허용된 회원의 블로그에 카테고리와 글을 등록합니다. 이 페이지는 계약 안내 전용이며 직접 저장하지 않습니다.
등록 순서
관리자가 회원 이메일을 SITE_IMPORT 키에 허용한 뒤, 허용된 회원이 보유한 블로그에 등록합니다.
GET /blogs로 허용 회원의 블로그를 확인합니다. → GET /categories로 목록을 확인하고 없으면 POST /categories로 먼저 등록합니다. → POST /posts로 기존 카테고리를 지정해 글을 등록합니다. → GET /posts로 검색하고, 본인 등록 글만 조회·수정·삭제합니다.
먼저 관리자에게 등록할 회원의 계정을 허용해 달라고 요청하세요. 블로그는 이 API에서 새로 만들 수 없으며 기존 활성 블로그만 선택할 수 있습니다.
카테고리를 먼저 등록하세요. 없는 카테고리를 글 요청이 자동으로 만들지 않습니다. 같은 블로그 이름이 여럿이면 blogId 또는 blogSlug를 지정하고, 같은 카테고리명이 여럿이면 categoryId를 사용합니다.
글 등록은 externalId 기준 전체 내용 교체입니다. 같은 client·블로그·유형·externalId를 다시 보내면 기존 글을 갱신하며, 값이 같으면 UNCHANGED입니다. 언어를 생략하면 블로그 기본 언어를 사용합니다. 13개 번역은 필수가 아닙니다.
새 글의 기본값은 전체 공개·즉시 발행입니다. 초안·예약 발행·나만 보기·비밀번호 보호를 명시할 수 있습니다. 수정 시 기존 발행 상태와 공개 범위는 요청에서 바꾼 경우에만 변경됩니다. 예약 시간에는 시간대를 포함하세요.
GET 검색으로 externalId와 현재 버전을 확인할 수 있습니다. 웹 편집본이 있거나 expectedVersion이 현재 값과 다르면 충돌로 거절되며 덮어쓰지 않습니다. 삭제는 30일 휴지통으로 이동하고 재등록으로 복구되지 않습니다.
계약을 보려면 API 키를 입력하세요.
SITE_IMPORT Bearer API 키
키는 현재 탭의 메모리에만 보관합니다. URL, localStorage, sessionStorage에 저장하지 않습니다.
브라우저에서 등록을 실행하는 기능은 없습니다. 신뢰된 서버·PowerShell·curl에서 호출하세요.
계약을 보려면 API 키를 입력하세요.