블로그 글 - 티스토리
1. 티스토리 글 초안 만들기tistory. retired_ openapi. create
MCP 도구 이름 tistory__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
티스토리에 새 글 초안을 만듭니다. 콘텐츠를 함께 주면 임시저장까지 합니다. 최종 발행은 고객이 직접 합니다. 티스토리 연동이 필요합니다.
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 | N | 함께 저장할 글의 내용입니다. 선택이고, 넣으면 새 초안을 만들고 바로 임시저장까지 하며 넣지 않으면 빈 초안만 만듭니다 | |
| document. | string | 조건부 | tistory__content__stage 또는 POST /v1/tistory/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다 | |
| document. | string | 조건부 | 글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다 | |
| document. | string | N | 쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 빈 문자열로 처리합니다 | |
| document. | number | N | 티스토리 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다 | |
| document. | boolean | 조건부 | 이 글을 게시할 권리가 있다는 고객의 확인입니다. 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": "tistory",
"action": "tistory.retired_openapi.create",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {}
}'Response
- 이 API 가 돌려주는 데이터: 새 초안 번호, 임시저장 결과
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "tistory",
"action": "tistory.retired_openapi.create",
"submitted_at": "2026-05-27T12:34:56+09:00"
}2. 티스토리 글쓰기 임시저장tistory. retired_ openapi. publish
MCP 도구 이름 tistory__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
고객이 만든 글을 티스토리에 임시저장합니다. 최종 발행은 고객이 티스토리에서 직접 합니다. 콘텐츠 생성은 고객 몫이며 티스토리 연동이 필요합니다.
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 | tistory__content__stage 또는 POST /v1/tistory/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 이면 저장하지 않고 거절합니다 | |
| sequence | number | N | 이어서 저장할 기존 초안의 번호입니다. 선택이고 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": "tistory",
"action": "tistory.retired_openapi.publish",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {
"document": {
"content_artifact_ref": "<필수>",
"title": "<필수>",
"rights_declared": "<필수: boolean>"
}
}
}'Response
- 이 API 가 돌려주는 데이터: 저장한 초안 번호, 임시저장 결과
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "tistory",
"action": "tistory.retired_openapi.publish",
"submitted_at": "2026-05-27T12:34:56+09:00"
}3. 티스토리 글쓰기 필요입력 안내tistory. retired_ openapi. requirements
MCP 도구 이름 tistory__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
티스토리에 글을 임시저장하기 전에 필요한 입력(제목, 콘텐츠 자산 참조, 게시 권리 선언 등)을 알려 줍니다. 조회 전용이며 티스토리 연동 없이 부를 수 있습니다.
- 이 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": "tistory",
"action": "tistory.retired_openapi.requirements",
"params": {}
}'Response
- 이 API 가 돌려주는 데이터: 제목, 보관한 본문 참조, 게시 권리 확인, 선택 입력(태그, 카테고리, 초안 번호) 목록
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "tistory",
"action": "tistory.retired_openapi.requirements",
"submitted_at": "2026-05-27T12:34:56+09:00"
}4. 티스토리 글 초안 수정tistory. retired_ openapi. update
MCP 도구 이름 tistory__
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
기존 티스토리 글 초안의 내용을 수정(임시저장)합니다. 최종 발행은 고객이 직접 합니다. 티스토리 연동이 필요합니다.
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}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| sequence | number | Y | 고칠 기존 초안의 번호입니다. 1 이상의 정수이고, 글쓰기 결과로 받은 초안 번호를 그대로 넣습니다 | |
| document | object | Y | 바꿀 글의 내용입니다. 기존 초안을 이 내용으로 바꾸어 다시 임시저장하고, 최종 발행은 하지 않습니다 | |
| document. | string | Y | tistory__content__stage 또는 POST /v1/tistory/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": "tistory",
"action": "tistory.retired_openapi.update",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {
"sequence": "<필수: number>",
"document": {
"content_artifact_ref": "<필수>",
"title": "<필수>",
"rights_declared": "<필수: boolean>"
}
}
}'Response
- 이 API 가 돌려주는 데이터: 고친 초안 번호, 임시저장 결과
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "tistory",
"action": "tistory.retired_openapi.update",
"submitted_at": "2026-05-27T12:34:56+09:00"
}