티스토리 API 오류 해결 방법 | 자주 발생하는 오류 사례와 대응법

티스토리 API 오류 해결 방법 | 자주 발생하는 오류 사례와 대응법

 

 

티스토리 Open API를 사용하면서
“posts API에서 posts 속성 누락”,
“파일 첨부 API 400·503 오류”,
“CORS 에러” 등 다양한 이슈가 발생할 수 있습니다.
이 글에서는 대표 오류 사례, 원인 분석, 실제 해결 방법을
비교하기 쉽게 정리했습니다.

---

posts API에서 posts 누락 오류

티스토리 블로그에 글이 없거나 모두 비공개 상태일 경우
response JSON에 "posts" 속성이 없거나 빈 배열로 오기도 합니다.
이로 인해 KeyError가 발생할 수 있으며,
totalCount가 0인지 확인하거나 if 'posts' not in response['tistory']['item']
조건을 넣어 처리하면 오류를 방지할 수 있습니다 

---

파일 첨부 API 400 오류

HTTP 400 오류의 경우,
Python의 requests 모듈로 multipart/form-data 전송할 때
User-Agent 헤더가 없으면 에러가 발생할 수 있습니다.
Java는 자동으로 붙지만, Python은 수동 설정해야 하며
headers={'User-Agent': '…'}를 추가한 후 오류가 해결되는 사례가 많습니다 

---

파일 첨부 API 503 오류

REST 방식으로 파일을 첨부하면 503 Service Unavailable 오류가 발생하는 경우가 있습니다.
이는 multipart form 구성 혹은 잘못된 엔드포인트 사용 때문인 경우가 많아
API 가이드에 맞는 POST 방식 구현이 필요합니다 

---

CORS 오류

웹 브라우저 환경에서 클라이언트 JS로 티스토리 API 호출 시
CORS 정책 위반으로 요청 자체가 차단될 수 있습니다.
이 경우에는 브라우저가 아닌 서버에서 호출하거나,
Firebase Functions 프록시 등 서버 중계 방식을 사용해 요청해야 합니다 

---

자주 묻는 질문

Q "posts" 속성 없다고 오류가 나요.
A totalCount == 0 또는 posts 존재 여부를 먼저 확인하세요.

Q Python에서 파일 첨부 400 에러 납니다.
A User-Agent 헤더를 반드시 추가해야 합니다.

Q 이미지 첨부 시 503 에러가 발생합니다.
A multipart form 구성과 REST 엔드포인트가 올바른지 확인하세요.

Q 브라우저에서 API 호출 시 CORS 오류 해결 방법은 무엇인가요.
A 브라우저가 아닌 서버에서 호출하거나 프록시 서버를 활용해야 합니다.

---

총평

티스토리 API 오류는
posts 누락, 파일 첨부의 400/503 에러, CORS 문제 등 다양하게 나타나지만,
각각 속성 검사, 헤더 추가, POST 방식 및 엔드포인트 맞춤,
프록시 서버 활용 등을 통해 해결이 가능합니다.
API 사용 전 가이드 문서를 다시 확인하고
실환경에 맞는 대응 로직을 준비하면 안정적으로 API를 활용할 수 있습니다.

 

 

 

안양 벼룩시장 종이신문 그대로 보기 – PC·모바일로 종이신문 열람하는 법

 

사업자 공인인증서 발급방법 – 홈택스 전자세금 업무까지 한 번에

 

전국 휘발유 주유소 가격, 오피넷에서 실시간 확인하는 방법

 

2025 기초연금 인상 확정 – 수급 대상과 신청 방법 총정리

 

농협 공동인증서 발급방법 완전 정복! 인터넷뱅킹부터 앱까지 5분 해결