API_BASE_URL

출처: API_BASE_URL 발행일: 2025-10-8 최종 편집: 2025-10-11 원래 섹션: 사이트 설정

이는 4.9.0 → 4.9.1 버전에서 Notion 인터페이스 변화로 사이트가 컴파일되지 않는 예외를 해결하기 위한 임시 설정입니다. 모든 사용자가 겪는 문제는 아닙니다. 사이트가 정상적으로 배포되고 530 오류가 없다면 이 문서는 무시해도 됩니다.

관련 커밋과 설명은 https://github.com/tangly1024/NotionNext/pull/3632를 참고하세요.

설정의 역할

blog.config.js에서 다음 설정이 추가된 것을 볼 수 있습니다.

API_BASE_URL: process.env.API_BASE_URL || 'https://www.notion.so/api/v3', // API 기본 요청 주소. 자신의 https://<xxxx>.notion.site/api/v3 로 설정 가능

Notion 공식 도메인 API(https://www.notion.so/api/v3/queryCollection)를 사용할 수 없어 API 요청이 모두 530 오류를 반환하는 경우가 있습니다.

해결 방법: 이 글을 읽는 시점에도 해당 API 페이지가 복구되지 않았다면, 임시로 대체 도메인을 사용할 수 있습니다. Notion DNS 네트워크가 복구된 뒤에는 이 설정을 더 이상 켜지 않아도 됩니다.

커스텀 URL 주소를 얻는 방법

각 사용자의 Notion 페이지가 공개 공유되면 Notion은 https://[your-company].notion.site/ 형식의 독립 도메인을 할당합니다. 자신의 Notion 페이지 링크를 브라우저에 복사해 열면 주소창이 개인화된 링크 주소로 자동 이동된 것을 볼 수 있습니다.

개인 도메인 주소를 완성된 API 주소로 조합합니다. 예: https://[xxxx].notion.site/api/v3. 그런 다음 NotionNext 환경 변수 API_BASE_URL에 추가하면 됩니다.

먼저 NotionNext를 최신 버전으로 업그레이드하세요. 환경 변수는 local.env 파일 또는 Vercel 환경 변수 등으로 추가할 수 있습니다.

이론적으로는 같은 API 주소를 함께 사용할 수 있지만, 인터페이스 네트워크 혼잡을 피하려면 모두가 같은 개인 도메인을 쓰지 않아야 합니다. 각자 자신의 개인 도메인을 API 주소의 prefix로 사용하세요.

환경 변수를 추가한 뒤 코드를 다시 시작하면 사이트가 정상으로 복구됩니다.

원문 링크

https://docs.tangly1024.com/article/notion-next-api_base_url