개발자 문서
API 레퍼런스

블로그 글 - 티스토리

1. 티스토리 글 초안 만들기tistory.retired_openapi.create

MCP 도구 이름 tistory__retired_openapi__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호출할 기관입니다.
  • tistory이 API 고정값 (기본값)

예시 : tistory

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

예시 : tistory.retired_openapi.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}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
documentobjectN함께 저장할 글의 내용입니다. 선택이고, 넣으면 새 초안을 만들고 바로 임시저장까지 하며 넣지 않으면 빈 초안만 만듭니다
document.content_artifact_refstring조건부tistory__content__stage 또는 POST /v1/tistory/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다
document.titlestring조건부글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다
document.tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 빈 문자열로 처리합니다
document.categoryIdnumberN티스토리 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다
document.rights_declaredboolean조건부이 글을 게시할 권리가 있다는 고객의 확인입니다. 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": "tistory",
  "action": "tistory.retired_openapi.create",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • 이 API 가 돌려주는 데이터: 새 초안 번호, 임시저장 결과

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

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

예시 : tistory

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

예시 : tistory.retired_openapi.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_refstringYtistory__content__stage 또는 POST /v1/tistory/content 응답의 content_artifact_ref를 그대로 넣으세요. 임의 URL은 받지 않습니다
document.titlestringY글 제목입니다. 1자 이상 200자 이하로 보내며 벗어나면 저장하지 않고 거절합니다
document.tagsstringN쉼표로 구분한 태그를 문자열 하나로 보냅니다(예: 세무,급여). 보내지 않으면 빈 문자열로 처리합니다
document.categoryIdnumberN티스토리 카테고리 번호입니다. 0 이상의 정수이고 보내지 않으면 0 입니다. category_id 로 보내도 됩니다
document.rights_declaredbooleanY이 글을 게시할 권리가 있다는 고객의 확인입니다. true 를 보내야 하고 false 이면 저장하지 않고 거절합니다
sequencenumberN이어서 저장할 기존 초안의 번호입니다. 선택이고 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": "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 가 돌려주는 데이터: 저장한 초안 번호, 임시저장 결과

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

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

예시 : tistory

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

예시 : tistory.retired_openapi.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": "tistory",
  "action": "tistory.retired_openapi.requirements",
  "params": {}
}'

Response

  • 이 API 가 돌려주는 데이터: 제목, 보관한 본문 참조, 게시 권리 확인, 선택 입력(태그, 카테고리, 초안 번호) 목록

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

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

예시 : tistory

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

예시 : tistory.retired_openapi.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}는 실제 키로 바꿔 넣는 사전 항목을 뜻하며, 선택인 부모를 보낼 때 하위 필수 칸은 조건부로 표시합니다.
순번변수명타입필수설명
sequencenumberY고칠 기존 초안의 번호입니다. 1 이상의 정수이고, 글쓰기 결과로 받은 초안 번호를 그대로 넣습니다
documentobjectY바꿀 글의 내용입니다. 기존 초안을 이 내용으로 바꾸어 다시 임시저장하고, 최종 발행은 하지 않습니다
document.content_artifact_refstringYtistory__content__stage 또는 POST /v1/tistory/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": "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 가 돌려주는 데이터: 고친 초안 번호, 임시저장 결과

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

json
{
    "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"
}