블로그 자동작성 - 블로그 자동작성
이 쪽의 모든 작업에 해당
- 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.
1. 블로그 본문 자동작성 (선택)blog_ autowrite. content. generate
MCP 도구 이름 blog_
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
주제와 설정을 받아 엑스보스 스타일로 블로그 본문 초안을 만들어 돌려줍니다. 검토용 초안까지이며 로그인과 임시저장, 발행은 글쓰기 상품으로 따로 진행합니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| provider | string | Y | 호출할 기관입니다.
| |
| action | string | Y | 호출할 작업입니다.
| |
| params | object | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| topic | string | Y | 자동작성할 글의 주제입니다. 1자 이상 200자 이하의 문자열이고, 비어 있으면 글을 만들지 않고 입력 오류로 거절합니다 | |
| category | string | N | 글의 카테고리입니다. 선택이고 100자 이하의 문자열이며, 엑스보스 블로그의 콘텐츠 유형(예: 업무자동화)에 맞춥니다. 보내지 않으면 비워 둡니다 | |
| tags | string | N | 쉼표로 구분한 태그를 문자열 하나로 보냅니다. 선택이고 블로그 편집기와 같은 형식이며, 보내지 않으면 비워 둡니다 |
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 가 돌려주는 데이터: 본문 제목, 본문 문단, 추천 태그, 글 분류
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"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_
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
엑스보스 블로그의 공개 글을 분석해 제목과 인사말, 문단 구성 같은 글쓰기 스타일을 확인합니다. 조회 전용이며 로그인이나 글 저장, 발행은 하지 않습니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| provider | string | Y | 호출할 기관입니다.
| |
| action | string | Y | 호출할 작업입니다.
| |
| params | object | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
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 가 돌려주는 데이터: 글 제목 패턴, 자주 쓰는 인사말과 말투, 문단 구성, 사용하는 서식
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"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"
}