Home [Notion API] Authorization
Post
Cancel
Preview Image

[Notion API] Authorization

Notion API 에서 인증은 간단하다. 기본적으로

1
2
GET /v1/pages/b55c9c91-384d-452b-81db-d1ef79372b75 HTTP/1.1
Authorization: Bearer {MY_NOTION_TOKEN}

처럼 bearer token을 HTTP Authorization request header에 넣어서 보내주면 된다.

다만 Integration types에 따라 조금 달라지긴 한다.

Integration types

앞에서 간략히 설명했지만 다시 짚고 넘어가자면, Integration에는 두 가지 타입이 있다.

  • Internal integrations
    • 사용자, 워크플로우 및 리소스에 맞게 사용자 및 팀이 사용 중인 툴과 서비스를 통합할 때 사용된다.
  • Public OAuth integrations
    • 많은 노션 워크스페이스에서 다양한 사람들이 프로덕트를 만들때 사용된다.

기본적으로 생성되는 IntegrationInternal integrations로 생성되며, 생성 후에 Public OAuth integrations로 바꿀 수 있다.

Internal integrations은 개발할 때 훨씬 쉬우며, Public integrations은 OAuth 2.0의 클라이언트 부분의 추가적인 구성과 구현이 필요하다.

Authorizing internal integrations

간단하게, 모든 requests에 integration token을 bearer token으로 사용하면 된다.

1
2
GET /v1/pages/b55c9c91-384d-452b-81db-d1ef79372b75 HTTP/1.1
Authorization: Bearer {MY_NOTION_TOKEN}

Authorizing public integrations

사용자가 integration 접속 권한을 받을 때마다, access token을 받는다.

자세한 내용은 나중에 테스트하면서 추가하겠다.

References

This post is licensed under CC BY 4.0 by the author.

[Notion API] integrations

GitHub Actions 수동으로 실행하기 (Run GitHub Actions Manually)