블로그 글 - 네이버 마케팅
1. 네이버 블로그 내 글 조회naver. blog. owner_ post. read
MCP 도구 이름 naver__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연결한 내 네이버 블로그의 글을 조회합니다. 글 번호를 주면 그 글의 제목과 작성일, 본문을 돌려주고 주지 않으면 내 글 목록을 돌려주며, 조회 전용이라 글이나 설정은 바뀌지 않습니다.
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 | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| log_ | number | N | 읽을 글의 번호입니다. 1 이상의 정수이고, 보내면 그 글의 본문을 읽고 보내지 않으면 내 글 목록을 돌려줍니다. 구형 에디터로 쓴 글은 본문을 읽지 않고 작업이 실패하며 error.code 는 PROVIDER_UPSTREAM_ERROR 입니다 | |
| current_ | number | N | 글 목록에서 받을 쪽 번호입니다. 1 이상의 정수이고 보내지 않으면 1 입니다. 글 번호(log_no)를 보낸 본문 조회에서는 쓰이지 않습니다 | |
| count_ | number | N | 글 목록에서 한 쪽에 받을 글 수입니다. 1 이상 100 이하의 정수이고, 글 번호(log_no)를 보내지 않는 목록 조회에는 필요합니다. 목록 조회인데 빠지면 작업이 실패하며 error.code 는 VALIDATION_INVALID_FIELD 입니다 | |
| category_ | number | N | 글 목록을 거를 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 전체 카테고리의 글을 돌려줍니다 | |
| output_ | array | N | 이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다. 글 번호(log_no)를 입력하지 않는 글 목록 조회에서만 쓸 수 있습니다. 그 밖의 요청에 넣으면 작업을 만들지 않고 HTTP 400 VALIDATION_INVALID_FIELD 로 거절하며 error.message 는 「이 요청은 파일 형식을 고를 수 없습니다. output_formats 를 빼고 다시 요청해 주세요.」 입니다 |
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 가 돌려주는 데이터: 글 제목, 글 번호, 작성일, 조회 수, 댓글 수, 본문
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"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__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
네이버 블로그의 임시저장 초안 하나를 새 내용으로 고쳐 다시 임시저장합니다. 임시저장 목록에 없는 초안은 고치지 않습니다. 최종 발행은 고객이 직접 합니다. 네이버 연동이 필요합니다.
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 | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
- 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| log_ | number | Y | 고칠 임시저장 글의 번호입니다. 1 이상의 정수이고, 글쓰기 결과로 받은 번호를 그대로 넣습니다. 임시저장 목록에 없는 번호이면 새 글을 만들지 않고 찾을 수 없다는 오류로 거절합니다 | |
| document | object | Y | 바꿀 글의 내용입니다. 임시저장된 글을 이 내용으로 바꾸어 다시 임시저장하고, 게시하지는 않습니다 | |
| document. | string | Y | naver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다 | |
| document. | string | Y | 글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다 | |
| document. | string | N | 쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다 | |
| document. | number | N | 블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다 | |
| document. | boolean | Y | 이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다 |
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
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| status | string | 저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다. | |
| log_ | number | 수정한 초안의 글 번호(logNo)입니다. | |
| verified_ | boolean | 저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다. | |
| outcome | string | 쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요. | |
| verdict_ | object | 판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다. | |
| note_ | string | 수정 내용을 임시저장했고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다. |
// 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__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
준비한 제목과 본문으로 네이버 블로그에 새 글 초안을 만들어 임시저장합니다. 최종 발행은 고객이 직접 합니다. 네이버 연동이 필요합니다.
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 | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
- 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| document | object | Y | 임시저장할 글의 내용입니다. 빈 글은 만들 수 없어 제목과 본문 참조를 함께 보내야 하고, 게시하지 않고 임시저장만 합니다 | |
| document. | string | Y | naver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다 | |
| document. | string | Y | 글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다 | |
| document. | string | N | 쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다 | |
| document. | number | N | 블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다 | |
| document. | boolean | Y | 이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다 |
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
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| status | string | 저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다. | |
| log_ | number | 새로 만든 초안에 네이버가 매긴 글 번호(logNo)입니다. 이어서 고칠 때 이 번호를 씁니다. | |
| verified_ | boolean | 저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다. | |
| outcome | string | 쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요. | |
| verdict_ | object | 판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다. | |
| note_ | string | 임시저장까지 마쳤고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다. |
// 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__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
고객이 만든 글을 네이버 블로그에 임시저장합니다. 최종 발행은 고객이 네이버 블로그에서 직접 합니다. 콘텐츠 생성은 고객 몫이며 네이버 연동이 필요합니다.
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 | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
- 대괄호 []는 목록의 각 항목을, 점은 객체의 속성을, {key}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| document | object | Y | 임시저장할 글의 내용입니다. 임시저장까지만 하고 최종 발행은 고객이 네이버 블로그에서 직접 합니다 | |
| document. | string | Y | naver__content__stage 또는 POST /v1/naver/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다 | |
| document. | string | Y | 글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다 | |
| document. | string | N | 쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 본문을 보관할 때 넣은 태그를 씁니다 | |
| document. | number | N | 블로그 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다 | |
| document. | boolean | Y | 이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다 | |
| log_ | number | N | 이어서 저장할 기존 초안의 번호(logNo)입니다. 선택이고 1 이상의 정수이며, 보내면 그 초안에 이어서 저장하고 보내지 않으면 새 초안을 만들어 저장합니다 |
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
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| status | string | 저장 상태입니다. 임시저장까지만 하므로 성공 응답에서는 항상 saved_as_draft 입니다. | |
| log_ | number | 저장한 초안의 글 번호(logNo)입니다. 요청에 log_no 를 보냈다면 그 번호이고, 보내지 않았다면 새로 만든 초안에 네이버가 매긴 번호입니다. | |
| verified_ | boolean | 저장한 뒤 네이버에서 그 글 번호를 다시 읽어 확인했는지입니다. 성공 응답에서는 항상 true 입니다. | |
| outcome | string | 쓰기 결과의 판정입니다. 성공 응답에서는 항상 confirmed 입니다. 네이버가 받았는지 확인하지 못한 저장은 이 응답으로 오지 않고 실패로 끝납니다. 그 경우 글이 만들어졌을 수 있으니 다시 보내기 전에 네이버 블로그의 임시저장 글을 먼저 확인해 주세요. | |
| verdict_ | object | 판정의 근거입니다. 어떤 신호를 보고 무엇을 받아들였는지가 담기며, 안쪽 칸은 판정 엔진이 정합니다. | |
| note_ | string | 임시저장까지 마쳤고 최종 발행은 네이버 블로그에서 직접 한다는 안내 문장입니다. |
// 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__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
네이버 블로그에 글을 임시저장하기 전에 필요한 입력(제목, 콘텐츠 자산 참조, 게시 권리 선언 등)을 알려 줍니다. 조회 전용이며 네이버 연동 없이 부를 수 있습니다.
- 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.
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: requirements-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "naver",
"action": "naver.blog.post_via_retired_api.requirements",
"params": {}
}'Response
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| required | array | 글을 임시저장하려면 꼭 보내야 하는 입력의 목록입니다. 지금은 content_artifact_ref, title, rights_declared 가 들어 있습니다. | |
| required[]. | string | 꼭 필요한 입력 항목의 이름입니다. | |
| required[]. | string | 그 입력이 무엇인지 한국어로 설명한 문장입니다. | |
| optional | array | 보내지 않아도 되는 입력의 목록입니다. 지금은 tags, category_id, log_no 가 들어 있습니다. | |
| optional[]. | string | 선택 입력 항목의 이름입니다. | |
| optional[]. | string | 그 입력이 무엇인지 한국어로 설명한 문장입니다. | |
| note_ | string | 저장 범위와 역할 분담을 알리는 안내 문장입니다. 이 상품은 임시저장까지만 하고, 최종 발행은 고객이 직접 합니다. |
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
"required": [
{
"field": "<string>",
"description_ko": "<string>"
}
],
"optional": [
{
"field": "<string>",
"description_ko": "<string>"
}
],
"note_ko": "<string>"
}