아이폰 메모앱에서 노션으로 글 보내기 NotesToNotion 2

1. 단축어를 통해 메모 생성 하기. 



단축어 앱에 들어가셔서 다음과 같이 메모를 생성하고 입력 요청을 받습니다.  (밑의 검색창에 메모, 변수, 입력 요청을 검색하시면 위의 5개 명령은 간단히 설정하실 수 있으실 겁니다.)

 

2. 사전에 변수들을 넣어주기. 

사실 이 변수들을 직접 설정하는 것도 좋지만 이후에 함께 사용할 경우도 있어서 하나의 사전으로 묶어주었습니다. 총 세 개의 값을 저장하는데 

 

첫 번째, dbid 에는 저희가 이전에 저장해두었던 데이터베이스의 아이디를 value값으로 넣어주시면 됩니다. 

두 번째, API URL은 노션 API문서 Create Pages부분을 보시면 POST로 보낼 URL이 적혀있습니다. 이 URL을 복사하여 붙여 넣어 주시면 됩니다. 

그리고 마지막 세번째API Key에는 이전에 저장해두었던 Token의 값을 저장해 주시면 됩니다. 하지만 이때, Notion API는 토큰의 포맷을 Bearer로 사용하기 때문에 앞에 Bearer를 적어주시고, 그 이후에 복사한 token값을 붙여 넣어 주시면 됩니다.

 

 사전의 값을 가져올 때는 사전의 이름을 클릭한 후 key값을 입력하면 됩니다. 

3. JSON작성하기. 

Notion API는 데이터는 json형식으로 주고받습니다. 이때 형식을 notion api가 원하는 형식으로 하지 않을 경우 반영이 되지 않고 오류를 리턴하는데요, 이때 중요한 type 세 가지가 있습니다. 

1. Parent 

parent는 데이터 베이스를 사용한다면 database_id라는 key 값에 저희가 사용하고자하는 database_id를 넣어 주시면 됩니다.

공식문서의 설명을 참고하시면 더욱 쉽게 이해하실 수 있으실 겁니다.

2. Properties

properties는 page안에 들어있는 property를 가리킵니다.

만약 제가 이러한 page를 가지고 있다면 우선순위, 중요한가?, 긴급한가?, 결과..... 이 모든것이 property입니다.

그렇기 때문에 json으로 요청을 보낼 때에도 이것들과 이름을 맞추어 주어야 합니다. 

참고로, json요청을 보낼 때 모든 properties를 적으실 필요는 없습니다. 요청 보내지 않은 properties는 자동으로 null값이 적용됩니다.

3. Children

Children은 페이지안에 작성되는 모든 것들을 가리킵니다. database, page, paragraph, image 등등 모든 것들이 될 수 있습니다. 필요하다면 Notion API를 참고하셔서 다른 것들을 더 넣으셔도 됩니다. 이번에는 글만 추가할 것이기 때문에 실습에서는 paragraph만 추가하도록 하겠습니다.

iphone에서 텍스트를 불러와 json형식으로 글을 적어 넣습니다.

이때 모든 key와 value들에는 따옴표("")로 감싸주셔야 제대로 전달이 됩니다. 

json형식을 작성하실 때 이 곳을 참고해주세요. (후에 설명이 부족하시다면 댓글 남겨주세요).

위의 우선순위를 예시로 드리자면 저는 우선순위라는 property에 (이 property는 선택할 수 있는 선택 property입니다.) NotesToNotion이라는 속성을 만들어 놓았습니다. 그래서 제가 note를 추가할 때 이 속성으로 전달되게끔 한 것입니다.

 

children property에도 앞서 언급했듯이 paragrph만 추가하였습니다. 이때 content에는 저희가 notes에 적었던 속성이 적용되도록 매직 변수로 넣어주었습니다. 

이렇게 작성해주시면 json작성은 끝이 납니다. 여기서 더 추가하시거나 빼셔도 상관없습니다. property를 설정하지 않으시면 자동으로 null로 적용됩니다.

 

4.Content 가져오기. 

단축어 검색 페이지에 '콘텐츠 가져오기'를 검색하시면 URL콘텐츠 가져오기가 있습니다. 이것을 선택하시면 됩니다. 

그리고 오른쪽의 그림처럼 API URL을 넣어주시고  메서드를 POST로 변경합니다. 

Create a page요청을 보내실 때는 3개의 헤더가 필요합니다. 

Authorization : API Key

Content-Type : application/json

Notion-Version : 2022-02-22 (2022-06-18 기준)

이렇게 헤더를 넣어주신 후 본문 요청을 파일로 변경하시고 값으로 이전에 저희가 작성한 텍스트를 넣어주시면 끝입니다. 

 

처음에 실행하시면 API 접속 허용이 뜨실 텐데 이것을 계속 허용으로 해주시면 작성하실 때마다 팝업이 나오지 않을 것입니다. 

설명이 부족하시다면 댓글 달아주세요!! 긴 글 읽어주시느라 고생하셨습니다.