검색

가이드 본문

티스토리에 대해서 알려드립니다.

오픈API 가이드

API가이드 카테고리
카테고리 목록 API

카테고리 목록을 가져올 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/category/list

2. Request Method

GET/POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
								curl "https://www.tistory.com/apis/category/list \
									 ?access_token=abcdefguhjklmnopqrstuvw \
									 &blogName=sampleUserName"
							
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
url 블로그 기본 URL
secondaryUrl 블로그 2차 도메인
categories 각각의 category node의 parent node 아래는 categories 이하 category nodes
id 카테고리 ID
name 카테고리 명
parent 부모 카테고리 하위 카테고리일때 표시
label 부모 카테고리명이 포함된 카테고리명 '부모카테고리/자식카테고리' 형태로 표시
entries 카테고리내 글 수 비공개글 제외
entriesInLogin 카테고리내 글 수 비공개글을 포함한 수 (주인 권한)
7. Request Method

1) XML


							<?xml version="1.0" encoding="utf-8"?>
							<tistory>
								<status>200</status>
								<item>
									<url>oauth</url>
									<secondaryUrl></secondaryUrl>
									<categories>
										<category>
											<id>403929</id>
											<name><![CDATA[OAuth2.0 Athentication]]></name>
											<parent></parent>
											<label><![CDATA[OAuth2.0 Athentication]]></label>
											<entries>0</entries>
										</category>
										<category>
											<id>403930</id>
											<name><![CDATA[Blog API Series]]></name>
											<parent></parent>
											<label><![CDATA[Blog API Series]]></label>
											<entries>0</entries>
										</category>
										<category>
											<id>403931</id>
											<name><![CDATA[Post API Series]]></name>
											<parent></parent>
											<label><![CDATA[Post API Series]]></label>
											<entries>0</entries>
										</category>
										<category>
											<id>403932</id>
											<name><![CDATA[Category API Series]]></name>
											<parent></parent>
											<label><![CDATA[Category API Series]]></label>
											<entries>0</entries>
										</category>
										<category>
											<id>403933</id>
											<name><![CDATA[Comment API Series]]></name>
											<parent></parent>
											<label><![CDATA[Comment API Series]]></label>
											<entries>0</entries>
										</category>
										<category>
											<id>403934</id>
											<name><![CDATA[Guestbook API Series]]></name>
											<parent></parent>
											<label><![CDATA[Guestbook API Series]]></label>
											<entries>0</entries>
										</category>
									</categories>
								</item>
							</tistory>						

2) JSON

								{
									"tistory": {
										"status":"200",
										"item": {
											"url":"oauth",
											"secondaryUrl":"",
											"categories": {
												"category":	[
													{
														"id":"403929",
														"name":"OAuth2.0 Athentication",
														"parent":"",
														"label":"OAuth2.0 Athentication",
														"entries":"0"
													},
													{
														"id":"403930",
														"name":"Blog API Series",
														"parent":"",
														"label":"Blog API Series",
														"entries":"0"
													},
													{
														"id":"403931",
														"name":"Post API Series",
														"parent":"",
														"label":"Post API Series",
														"entries":"0"
													},
													{
														"id":"403932",
														"name":"Category API Series",
														"parent":"",
														"label":"Category API Series",
														"entries":"0"
													},
													{
														"id":"403933",
														"name":"Comment API Series",
														"parent":"",
														"label":"Comment API Series",
														"entries":"0"
													},
													{
														"id":"403934",
														"name":"Guestbook API Series",
														"parent":"",
														"label":"Guestbook API Series",
														"entries":"0"
													}
												]
											}
										}
									}
								}
							
TISTORY GUIDE 티스토리 사용법을 알려드립니다.