Notion API 시작하기

이 글을 Notion API를 사용해보며 방법을 익히기 위해 작성합니다.

잘못된 정보가 있을 수 있고 베타인만큼 추후 내용이 수정될 수 있습니다.

 

 

드디어 Notion API의 공개 베타가 시작되었습니다.

티스토리에 편하게 노션을 연동하기 위해서는 API가 필수였는데 활용할만한게 있을지 기대하는 중입니다.

 

우선 간단하게 노션에 새로운 컨텐츠를 만드는 법을 작성해보겠습니다.

(Postman을 사용하여 테스트하였습니다.)

 

Header

API를 사용하기 위해선 우선 Secret key 를 발급받아야 합니다.

키 발급 방법은 아래 링크를 참조하세요.

Getting started

 

 

글을 작성하기 위해서는 POST 요청으로 보내야 하고 헤더에 다음과 같은 정보를 포함해야 합니다.

중괄호 부분을 각자의 키값으로 바꿔서 채워주세요~

Authorization: Bearer {SECRET_KEY}
Content-Type: application/json
Notion-Version: 2021-05-13

 

JSON body

parent

A database parent or page parent

데이터베이스 또는 상위 페이지의 아이디 값을 넣습니다.

properties

Property values of this page. The keys are the names or IDs of the property and the values are property values.

이 페이지의 속성 값입니다. 키는 속성의 이름 또는 ID 이고 값은 속성의 값입니다.

children

Page content for the new page as an array of block objects

새 페이지의 내용을 입력하는 속성이며 문단 구분은 블록 개체의 배열로 입력하면 됩니다.

 

글을 작성하기 위해서는 작성할 페이지 혹은 데이터베이스의 32자리 아이디값이 필요합니다.

32자리 아이디값은 share 를 누르면 보이는 링크에서 확인할 수 있습니다.

 

{
    "parent": {
        "database_id": "{DATABASE_ID}"
    },
    "properties": {
        "Name": {
            "title": [
                {
                    "text": {
                        "content": "Tuscan Kale"
                    }
                }
            ]
        },
        "Description": {
            "rich_text": [
                {
                    "text": {
                        "content": "A dark green leafy vegetable"
                    },
                    "annotations": {
                        "bold": true,
                        "italic": true,
                        "underline": true,
                        "color": "blue"
                    }
                }
            ]
        },
        "Food group": {
            "select": {
                "name": "Vegetable"
            }
        },
        "Price": {
            "number": 2.5
        }
    },
    "children": [
        {
            "object": "block",
            "type": "heading_2",
            "heading_2": {
                "text": [
                    {
                        "type": "text",
                        "text": {
                            "content": "Lacinato kale"
                        }
                    }
                ]
            }
        },
        {
            "object": "block",
            "type": "paragraph",
            "paragraph": {
                "text": [
                    {
                        "type": "text",
                        "text": {
                            "content": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.",
                            "link": {
                                "url": "https://en.wikipedia.org/wiki/Lacinato_kale"
                            }
                        }
                    }
                ]
            }
        }
    ]
}

 

위 속성값들을 모두 채워주고 HTTP 요청을 보내면 다음과 같이 글이 생성되는 것을 확인할 수 있습니다.

 

 

 

Reference

Create a page