post.rst

Post API

게시글 목록 조회

최근 게시물 목록을 가져올 수 있는 API입니다. 해당 API에 관한 정보는 게시물 목록 API 를 통해 살펴보실 수 있습니다.

from pytistory import PyTistory

pytistory = PyTistory()
pytistory.configure()

response = pytistory.post.list(blog_name='oauth')

결과값은 아래처럼 받을 수 있습니다.

{
  "status": "200",
  "item": {
    "url": "http://oauth.tistory.com",
    "secondaryUrl": "",
    "page": "1",
    "count": "10",
    "totalCount": "4",
    "posts": {
      "post": [
        {
          "id": "4",
          "title": "티스토리 OAuth Open API 일단 써보세요!",
          "postUrl": "http://oauth.tistory.com /4",
          "visibility": "0",
          "categoryId": "0",
          "comments": "6",
          "trackbacks": "0",
          "date": "1303796661"
        },
        {
          "id": "3",
          "title": "View에 보냅니다~",
          "postUrl": "http://oauth.tistory.com /3",
          "visibility": "3",
          "categoryId": "0",
          "comments": "0",
          "trackbacks": "0",
          "date": "1303372106"
        },
        {
          "id": "2",
          "title": "View에 보내봅니다.",
          "postUrl": "http://oauth.tistory.com /2",
          "visibility": "3",
          "categoryId": "0",
          "comments": "0",
          "trackbacks": "0",
          "date": "1303372007"
        },
        {
          "id": "1",
          "title": "티스토리 OAuth2.0 API 오픈!",
          "postUrl": "http://oauth.tistory.com /1",
          "visibility": "0",
          "categoryId": "0",
          "comments": "0",
          "trackbacks": "0",
          "date": "1303352668"
        }
      ]
    }
  }
}

게시글 작성

게시글을 작성할 수 있는 API입니다. 해당 API에 관한 정보는 게시글 작성 API 를 통해 살펴보실 수 있습니다.

from pytistory import PyTistory

pytistory = PyTistory()
pytistory.configure()

response = pytistory.post.write("Post Title",
                                blog_name='sampleUrl',
                                visibility=1,
                                category=12,
                                content="Post Content",
                                tag=["Tag1", "Tag2"])

인자는 다음처럼 받습니다.

title

포스트 제목입니다. str타입입니다.

blog_name

블로그 명입니다. 기본값은 None. str타입입니다.

target_url

블로그의 url입니다. deprecated된 옵션입니다. 기본값은 None. str타입입니다.

visibility

• 0: 비공개
• 1: 보호
• 2: 공개
• 3: 발행

기본값은 0입니다.

published

발행 시간. 만약 설정시 예약 발행이 됨., None. 타입은 datetime.datetime타입입니다.

category

카테고리를 뜻하고, 0은 분류없음입니다. 값 설정시 카테고리가 설정됩니다. 기본값은 0입니다.

content

글 내용, 기본값은 None이고 str타입입니다.

slogan

문자 주소. 이는 아마 블로그 주소 형식을 문자로 설정했을 때의 값인 듯 합니다. 기본값은 None.

tag

게시글에 태그를 설정합니다, 기본값은 None. 값 설정할 때 타입은 list입니다.

결과값은 아래처럼 받을 수 있습니다.

{
  "status": "200",
  "postId": "74",
  "url": "http://sampleUrl.tistory.com/74"
}

게시글 수정

작성된 게시글을 수정할 수 있는 API입니다. 해당 API에 관한 정보는 게시글 수정 API 를 통해 살펴보실 수 있습니다.

from pytistory import PyTistory

pytistory = PyTistory()
pytistory.configure()

response = pytistory.post.modify("Post Title",
                                1,
                                blog_name='sampleUrl',
                                visibility=1,
                                category=12,
                                content="Post Content",
                                tag=["Tag1", "Tag2"])

인자값은 위의 게시글 작성 API에서, 두가지 변경사항만 있습니다.

published값을 설정할 수 없고, int타입의 post_id를 추가적으로 전달해주어야 합니다.

결과값은 아래처럼 받을 수 있습니다.

{
  "status": "200",
  "postId": "74",
  "url": "http://sampleUrl.tistory.com/74"
}