개발자 문서
API 레퍼런스

블로그 글 - 네이버 마케팅

1. 네이버 블로그 내 글 조회naver.blog.owner_post.read

MCP 도구 이름 naver__blog__owner_post__read

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추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • naver이 API 고정값 (기본값)

예시 : naver

actionstring-Y호출할 작업입니다.
  • naver.blog.owner_post.read이 API 고정값 (기본값)

예시 : naver.blog.owner_post.read

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

순번변수명타입필수설명
log_nonumberN읽을 글의 번호입니다. 1 이상의 정수이고, 보내면 그 글의 본문을 읽고 보내지 않으면 내 글 목록을 돌려줍니다. 구형 에디터로 쓴 글은 본문을 읽지 않고 작업이 실패하며 error.code 는 PROVIDER_UPSTREAM_ERROR 입니다
current_pagenumberN글 목록에서 받을 쪽 번호입니다. 1 이상의 정수이고 보내지 않으면 1 입니다. 글 번호(log_no)를 보낸 본문 조회에서는 쓰이지 않습니다
count_per_pagenumberN글 목록에서 한 쪽에 받을 글 수입니다. 1 이상 100 이하의 정수이고, 글 번호(log_no)를 보내지 않는 목록 조회에는 필요합니다. 목록 조회인데 빠지면 작업이 실패하며 error.code 는 VALIDATION_INVALID_FIELD 입니다
category_nonumberN글 목록을 거를 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 전체 카테고리의 글을 돌려줍니다
output_formatsarrayN이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다. 글 번호(log_no)를 입력하지 않는 글 목록 조회에서만 쓸 수 있습니다. 그 밖의 요청에 넣으면 작업을 만들지 않고 HTTP 400 VALIDATION_INVALID_FIELD 로 거절하며 error.message 는 「이 요청은 파일 형식을 고를 수 없습니다. output_formats 를 빼고 다시 요청해 주세요.」 입니다
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: read-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "naver",
  "action": "naver.blog.owner_post.read",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • 이 API 가 돌려주는 데이터: 글 제목, 글 번호, 작성일, 조회 수, 댓글 수, 본문

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

json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "naver",
    "action": "naver.blog.owner_post.read",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}

2. 네이버 블로그 글 초안 수정naver.blog.owner_post.update

MCP 도구 이름 naver__blog__owner_post__update

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추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • naver이 API 고정값 (기본값)

예시 : naver

actionstring-Y호출할 작업입니다.
  • naver.blog.owner_post.update이 API 고정값 (기본값)

예시 : naver.blog.owner_post.update

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

  • 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
log_nonumberY고칠 임시저장 글의 번호입니다. 1 이상의 정수이고, 글쓰기 결과로 받은 번호를 그대로 넣습니다. 임시저장 목록에 없는 번호이면 새 글을 만들지 않고 찾을 수 없다는 오류로 거절합니다
documentobjectY바꿀 글의 내용입니다. 임시저장된 글을 이 내용으로 바꾸어 다시 임시저장하고, 게시하지는 않습니다
document.content_artifact_refstringYnaver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다
document.titlestringY글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다
document.tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다
document.categoryIdnumberN블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다
document.rights_declaredbooleanY이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다
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: update-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "naver",
  "action": "naver.blog.owner_post.update",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "log_no": "<필수: number>",
    "document": {
      "content_artifact_ref": "<필수>",
      "title": "<필수>",
      "rights_declared": "<필수: boolean>"
    }
  }
}'

Response

순번변수명타입설명
statusstring저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다.
log_nonumber수정한 초안의 글 번호(logNo)입니다.
verified_by_read_backboolean저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다.
outcomestring쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요.
verdict_detailobject판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다.
note_kostring수정 내용을 임시저장했고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "status": "<string>",
  "log_no": "<number>",
  "verified_by_read_back": "<boolean>",
  "outcome": "<string>",
  "verdict_detail": {},
  "note_ko": "<string>"
}

3. 네이버 블로그 글 초안 만들기naver.blog.post_via_retired_api.create

MCP 도구 이름 naver__blog__post_via_retired_api__create

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추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • naver이 API 고정값 (기본값)

예시 : naver

actionstring-Y호출할 작업입니다.
  • naver.blog.post_via_retired_api.create이 API 고정값 (기본값)

예시 : naver.blog.post_via_retired_api.create

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

  • 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
documentobjectY임시저장할 글의 내용입니다. 빈 글은 만들 수 없어 제목과 본문 참조를 함께 보내야 하고, 게시하지 않고 임시저장만 합니다
document.content_artifact_refstringYnaver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다
document.titlestringY글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다
document.tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다
document.categoryIdnumberN블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다
document.rights_declaredbooleanY이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다
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: create-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "naver",
  "action": "naver.blog.post_via_retired_api.create",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "document": {
      "content_artifact_ref": "<필수>",
      "title": "<필수>",
      "rights_declared": "<필수: boolean>"
    }
  }
}'

Response

순번변수명타입설명
statusstring저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다.
log_nonumber새로 만든 초안에 네이버가 매긴 글 번호(logNo)입니다. 이어서 고칠 때 이 번호를 씁니다.
verified_by_read_backboolean저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다.
outcomestring쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요.
verdict_detailobject판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다.
note_kostring임시저장까지 마쳤고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "status": "<string>",
  "log_no": "<number>",
  "verified_by_read_back": "<boolean>",
  "outcome": "<string>",
  "verdict_detail": {},
  "note_ko": "<string>"
}

4. 네이버 블로그 글쓰기 임시저장naver.blog.post_via_retired_api.publish

MCP 도구 이름 naver__blog__post_via_retired_api__publish

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추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • naver이 API 고정값 (기본값)

예시 : naver

actionstring-Y호출할 작업입니다.
  • naver.blog.post_via_retired_api.publish이 API 고정값 (기본값)

예시 : naver.blog.post_via_retired_api.publish

account_link_idstring36조건부등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

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

[참고] 암호화

  • 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
documentobjectY임시저장할 글의 내용입니다. 임시저장까지만 하고 최종 발행은 고객이 네이버 블로그에서 직접 합니다
document.content_artifact_refstringYnaver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다
document.titlestringY글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다
document.tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다
document.categoryIdnumberN블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다
document.rights_declaredbooleanY이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다
log_nonumberN이어서 저장할 기존 초안의 번호(logNo)입니다. 선택이고 1 이상의 정수이며, 보내면 그 초안에 이어서 저장하고 보내지 않으면 새 초안을 만들어 저장합니다
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: publish-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "naver",
  "action": "naver.blog.post_via_retired_api.publish",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "document": {
      "content_artifact_ref": "<필수>",
      "title": "<필수>",
      "rights_declared": "<필수: boolean>"
    }
  }
}'

Response

순번변수명타입설명
statusstring저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다.
log_nonumber저장한 초안의 글 번호(logNo)입니다. 요청에 log_no 를 보냈다면 그 번호이고, 보내지 않았다면 새로 만든 초안에 네이버가 매긴 번호입니다.
verified_by_read_backboolean저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다.
outcomestring쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요.
verdict_detailobject판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다.
note_kostring임시저장까지 마쳤고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "status": "<string>",
  "log_no": "<number>",
  "verified_by_read_back": "<boolean>",
  "outcome": "<string>",
  "verdict_detail": {},
  "note_ko": "<string>"
}

5. 네이버 블로그 글쓰기 필요입력 안내naver.blog.post_via_retired_api.requirements

MCP 도구 이름 naver__blog__post_via_retired_api__requirements

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

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

네이버 블로그에 글을 임시저장하기 전에 필요한 입력(제목, 콘텐츠 자산 참조, 게시 권리 선언 등)을 알려 줍니다. 조회 전용이며 네이버 연동 없이 부를 수 있습니다.

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

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호출할 기관입니다.
  • naver이 API 고정값 (기본값)

예시 : naver

actionstringY호출할 작업입니다.
  • naver.blog.post_via_retired_api.requirements이 API 고정값 (기본값)

예시 : naver.blog.post_via_retired_api.requirements

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: requirements-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "naver",
  "action": "naver.blog.post_via_retired_api.requirements",
  "params": {}
}'

Response

순번변수명타입설명
requiredarray글을 임시저장하려면 꼭 보내야 하는 입력의 목록입니다. 지금은 content_artifact_ref, title, rights_declared 가 들어 있습니다.
required[].fieldstring꼭 필요한 입력 항목의 이름입니다.
required[].description_kostring그 입력이 무엇인지 한국어로 설명한 문장입니다.
optionalarray보내지 않아도 되는 입력의 목록입니다. 지금은 tags, category_id, log_no 가 들어 있습니다.
optional[].fieldstring선택 입력 항목의 이름입니다.
optional[].description_kostring그 입력이 무엇인지 한국어로 설명한 문장입니다.
note_kostring저장 범위와 역할 분담을 알리는 안내 문장입니다. 이 상품은 임시저장까지만 하고, 최종 발행은 고객이 직접 합니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "required": [
    {
      "field": "<string>",
      "description_ko": "<string>"
    }
  ],
  "optional": [
    {
      "field": "<string>",
      "description_ko": "<string>"
    }
  ],
  "note_ko": "<string>"
}