개발자 문서
API 레퍼런스

블로그 자동작성 - 블로그 자동작성

이 쪽의 모든 작업에 해당

  • 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.

1. 블로그 본문 자동작성 (선택)blog_autowrite.content.generate

MCP 도구 이름 blog_autowrite__content__generate

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

주제와 설정을 받아 엑스보스 스타일로 블로그 본문 초안을 만들어 돌려줍니다. 검토용 초안까지이며 로그인과 임시저장, 발행은 글쓰기 상품으로 따로 진행합니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입필수설명
providerstringY호출할 기관입니다.
  • blog_autowrite이 API 고정값 (기본값)

예시 : blog_autowrite

actionstringY호출할 작업입니다.
  • blog_autowrite.content.generate이 API 고정값 (기본값)

예시 : blog_autowrite.content.generate

paramsobjectY작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobjectN민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
topicstringY자동작성할 글의 주제입니다. 1자 이상 200자 이하의 문자열이고, 비어 있으면 글을 만들지 않고 입력 오류로 거절합니다
categorystringN글의 카테고리입니다. 선택이고 100자 이하의 문자열이며, 엑스보스 블로그의 콘텐츠 유형(예: 업무자동화)에 맞춥니다. 보내지 않으면 비워 둡니다
tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다. 선택이고 블로그 편집기와 같은 형식이며, 보내지 않으면 비워 둡니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: generate-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "blog_autowrite",
  "action": "blog_autowrite.content.generate",
  "params": {
    "topic": "<필수>"
  }
}'

Response

  • 이 API 가 돌려주는 데이터: 본문 제목, 본문 문단, 추천 태그, 글 분류

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "blog_autowrite",
    "action": "blog_autowrite.content.generate",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

2. 엑스보스 블로그 글쓰기 스타일 확인blog_autowrite.style.profile

MCP 도구 이름 blog_autowrite__style__profile

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

엑스보스 블로그의 공개 글을 분석해 제목과 인사말, 문단 구성 같은 글쓰기 스타일을 확인합니다. 조회 전용이며 로그인이나 글 저장, 발행은 하지 않습니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입필수설명
providerstringY호출할 기관입니다.
  • blog_autowrite이 API 고정값 (기본값)

예시 : blog_autowrite

actionstringY호출할 작업입니다.
  • blog_autowrite.style.profile이 API 고정값 (기본값)

예시 : blog_autowrite.style.profile

paramsobjectN작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobjectN민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

추가 파라미터가 없습니다. params 는 {} 로 보냅니다.

bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: profile-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "blog_autowrite",
  "action": "blog_autowrite.style.profile",
  "params": {}
}'

Response

  • 이 API 가 돌려주는 데이터: 글 제목 패턴, 자주 쓰는 인사말과 말투, 문단 구성, 사용하는 서식

응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "blog_autowrite",
    "action": "blog_autowrite.style.profile",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}