피드로 돌아가기
Dev.toBackend
원문 읽기
Notion Has a Free API — Build Custom Dashboards and Automate Your Workflow
Notion이 공개한 무료 API를 통해 데이터베이스 쿼리, 페이지 생성, 블록 추가를 프로그래매틱하게 처리 가능
AI 요약
Technical Solution
- Notion API를 통한 데이터베이스 쿼리: POST 요청으로
https://api.notion.com/v1/databases/{db_id}/query엔드포인트에 필터 객체 전달하여 조건별 데이터 조회 - 페이지 생성 기능: 부모 데이터베이스 ID와 속성(Name, Status 등)을 JSON 형식으로 POST 요청하여 새 페이지 생성
- 블록 콘텐츠 추가: PATCH 요청으로
https://api.notion.com/v1/blocks/{page_id}/children에 제목, 문단, 불릿 리스트 등 블록 객체 배열 전송 - API 인증: Bearer 토큰 기반 Authorization 헤더와
Notion-Version: 2022-06-28헤더를 모든 요청에 포함 - 레이트 제한: 초당 3개 요청 제한 적용, 일일 제한 없음, 대량 데이터 조회 시 페이지당 100개 항목 단위로 페이지네이션
실천 포인트
Notion 데이터베이스를 외부 애플리케이션과 통합해야 하는 팀에서 Python의 requests 라이브러리로 Status 필터링을 통한 쿼리, 자동 페이지 생성, 콘텐츠 삽입을 구현하면 스탠드업 자동화, CRM 리드 수집, 콘텐츠 캘린더 동기화 같은 워크플로우 자동화를 달성할 수 있다.