검색

가이드 본문

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

오픈API 가이드

API가이드 방명록
방명록 목록 API

블로그내 방명록을 조회할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/guestbook/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/guestbook/list \
								 ?access_token=abcdefguhjklmnopqrstuvw \
								 &blogName=sampleUserName"
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
item 방명록 node. 아래는 item 이하
url 블로그 url
secondaryUrl 2차 도메인
totalCount 해당 블로그의 방명록 총 개수
guestbooks 각각의 guestbook node의 parent node 아래는 guestbooks 이하 guestbook nodes
id 방명록ID
name 블로그 이름
parentId 부모 방명록 ID 값이 없을 경우 방명록의 답글이 아님
homepage 블로그 주소
visibility 승인 여부 0:승인을 기다리는 방명록 / 그 외:승인을 사용하지 않음
open 공개/비공개 여부 Y:공개 / N:비공개
content 방명록 내용
date 방명록 작성 시간
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<item>
								<url>http://oauth.tistory.com</url>
								<secondaryUrl></secondaryUrl>
								<page>1</page>
								<totalCount>2</totalCount>
								<guestbooks>
									<guestbook>
										<id>8177011</id>
										<date>1303798898</date>
										<name><![CDATA[잘못들어온 사람]]></name>
										<homepage>http://wrongway.com</homepage>
										<comment><![CDATA[아.. 저 여기 잘못들어왔나봐요..]]></comment>
										<open>Y</open>
										<replies>
											<reply>
												<id>8177015</id>
												<date>1303799030</date>
												<name><![CDATA[Tistory API]]></name>
												<parentId>8177011</parentId>
												<homepage>http://oauth.tistory.com</homepage>
												<comment><![CDATA[들어올때는 마음대로 들어왔겠지만 나갈때는 아니란다]]></comment>
												<open>Y</open>
											</reply>
										</replies>
									</guestbook>
									<guestbook>
										<id>8177008</id>
										<date>1303798795</date>
										<name><![CDATA[개발자]]></name>
										<homepage>http://somedeveloper.com</homepage>
										<comment><![CDATA[좋은 API 많이 만들어주세요!]]></comment>
										<open>Y</open>
										<replies>
										</replies>
									</guestbook>
								</guestbooks>
							</item>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
									"item": {
										"url":"http://oauth.tistory.com",
										"secondaryUrl":"",
										"page":"1",
										"totalCount":"2",
										"guestbooks": {
											"guestbook": [
												{
													"id":"8177011",
													"date":"1303798898",
													"name":"잘못들어온 사람",
													"homepage":"http://wrongway.com",
													"comment":"아.. 저 여기 잘못들어왔나봐요..",
													"open":"Y",
													"replies": {
														"reply": {
															"id":"8177015",
															"date":"1303799030",
															"name":"Tistory API",
															"parentId":"8177011",
															"homepage":"http://oauth.tistory.com",
															"comment":" 들어올때는 마음대로 들어왔겠지만 나갈때는 아니란다",
															"open":"Y"
														}
													}
												},
												{
													"id":"8177008",
													"date":"1303798795",
													"name":"개발자",
													"homepage":"http://somedeveloper.com",
													"comment":"좋은 API 많이 만들어주세요!",
													"open":"Y",
													"replies":""
												}
											]
										}
									}
								}
							}
						
방명록 작성 API

방명록 또는 방명록의 답변을 작성할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/guestbook/write

2. Request Method

POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
content 방명록 내용
4. Request Parameter (Optional)
파라미터 명 설명 비고
parentId 부모 방명록 ID 방명록의 답글일 경우만 사용
secret 비밀글 여부 1:비밀 방명록 / 그외 공개 방명록
output 출력 포맷 입력하지 않으면 XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'content=%EB%B0%A9%EB%AA%85%EB%A1%9D%EB%82%B4%EC%9A%A9'
								 https://www.tistory.com/apis/guestbook/write
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
guestbookUrl 방명록 주소
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<commentUrl>http://oauth.tistory.com/guestbook</commentUrl>
							<result>OK</result>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
									"guestbookUrl":"http://oauth.tistory.com/guestbook",
									"result":"OK"
								}
							}
						
방명록 수정 API

이미 작성된 방명록을 수정할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/guestbook/modify

2. Request Method

POST

3. Request Parameter
파라미터 명 설명 비고
access_token 엑세스 토큰
blogName 블로그 name xxx.tistory.com 의 xxx
targetUrl
(deprecated. blogName 사용 권장)
조회할 티스토리 주소 http://xxx.tistory.com 일경우 xxx 만 입력, 2차도메인일 경우 http://제거한 url 입력
guestbookId 방명록ID
content 방명록 내용
4. Request Parameter (Optional)
파라미터 명 설명 비고
parentId 부모 방명록 ID 방명록의 답글일 경우만 사용
secret 비밀글 여부 1:비밀 방명록 / 그외 공개 방명록
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'guestbookId=5876544123' \
								 -F 'content=%EB%B0%A9%EB%AA%85%EB%A1%9D%EB%82%B4%EC%9A%A9'
								 https://www.tistory.com/apis/guestbook/modify
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
guestbookUrl 방명록 주소
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
							<commentUrl>http://oauth.tistory.com/guestbook</commentUrl>
							<result>OK</result>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
									"guestbookUrl":"http://oauth.tistory.com/guestbook",
									"result":"OK"
								}
							}
						
방명록 삭제 API

방명록을 삭제할 수 있는 API입니다.

1. Request URL

https://www.tistory.com/apis/guestbook/delete

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 입력
guestbookId 방명록ID
4. Request Parameter (Optional)
파라미터 명 설명 비고
output 출력 포맷 json: JSON출력, xml: XML출력, 그외: XML출력
5. Request Sample
							curl -F 'access_token=abcdefguhjklmnopqrstuvw' \
								 -F 'blogName=sampleUserName' \
								 -F 'guestbookId=5876544123' \
								 https://www.tistory.com/apis/guestbook/delete
						
6. Response Sample
파라미터 명 설명 비고
status 응답 코드 예)200 : 성공, 기본적인 Http response code를 따름
7. Request Method

1) XML


						<?xml version="1.0" encoding="utf-8"?>
						<tistory>
							<status>200</status>
						</tistory>
												

2) JSON

							{
								"tistory":{
									"status":"200",
								}
							}
						
TISTORY GUIDE 티스토리 사용법을 알려드립니다.