API — 관련 콘텐츠 141건

JSON.parse, Unexpected token, HTML 응답 | 파서가 '<'에서 멈추면?

JSON.parse가 Unexpected token '<'를 내면 파서가 틀린 게 아니라 받은 본문이 JSON이 아니라 HTML입니다. 상태 코드, Content-Type, 상대 경로가 페이지로 붙는 배포. Node.js, Next.js, fetch, 한국 1인 개발자 기준. 2026년 9월 MDN JSON.parse·Route Handlers 문서.

504 Gateway Timeout, maxDuration, 스트리밍 | 응답이 끊기기 전에 어디를 자를까?

배포만 504면 함수가 라우트 최대 실행 초 안에 응답을 못 끝낸 상태다. 오류 이름의 함수 호출 시간 초과, maxDuration, 스트리밍 시계, after로 일을 자르는 순서를 본다. 한도만 키우지 말고 첫 바이트를 먼저 보낸다. Next.js, 버셀, 클라우드플레어, API, 함수, 개발자 기준. 2026년 9월 MDN, RFC 9110, 버셀 공식 문서.

502 Bad Gateway, 업스트림, 함수 타임아웃 | 버셀 로그에 함수는 성공인데 화면이 502면?

버셀 함수 로그는 성공인데 화면만 502면 업스트림 응답이 프록시에 유효하게 안 도착한 상태다. x-vercel-error의 NO_RESPONSE_FROM_FUNCTION, 첫 바이트 지연, 스트림 중단을 본다. 응답을 먼저 보내고 긴 일은 after로 뺀다. Next.js, 버셀, 클라우드플레어, API, 함수, 개발자 기준. 2026년 9월 MDN, RFC 9110, 버셀 공식 문서.

403 Forbidden, RLS, 권한 | 슈퍼베이스에서 select는 되고 insert만 막히면?

조회는 되고 저장만 403이면 행 수준 보안의 넣기 정책이 그 행을 거절한 상태다. 조회 조건과 쓰기 검사, 사용자 아이디, 익명 키와 서비스 롤 키를 나눈다. 슈퍼베이스, 포스트그레, Next.js, API, 백엔드, 보안, 카카오 로그인, 서버 액션, 개발자 기준. 2026년 9월 MDN, 포스트그레, 슈퍼베이스 공식 문서.

401 Unauthorized, Bearer, 만료 토큰 | 로그인은 됐는데 저장만 거절되면?

로그인은 됐는데 저장만 401이면 화면 세션과 요청 자격이 갈린 상태다. Bearer 헤더 누락, 만료된 액세스 토큰, 서버 액션에 안 실리는 인증부터 본다. WWW-Authenticate의 invalid_token이면 리프레시 한 번 후 재시도한다. 개발자, Next.js, 서버 액션, API, 카카오 로그인, 보안, 백엔드 기준. 2026년 9월 MDN·RFC 6750·카카오 공식 문서.

429 Too Many Requests, Retry-After, 백오프 | API 한 번에 몰리면 어디를 줄일까?

429는 인증 실패가 아니라 짧은 시간에 호출이 많아 서버가 기다리라고 한 응답이다. Retry-After 초와 HTTP 날짜를 읽고, 헤더가 없으면 지수 백오프에 지터를 넣는다. 크론·웹훅·액션이 같은 키를 쓰면 동시 호출과 배치부터 줄인다. 개발자, API, 백엔드, Node.js, Next.js, 깃허브 기준. 2026년 9월 MDN·RFC 6585·깃허브 REST 문서.

ETIMEDOUT, fetch failed, undici | 배포 함수에서만 타임아웃이면?

배포 함수에서만 fetch가 끊기면 로컬 회선이 빠른 게 아니라 함수 대기 한도와 아웃바운드 경로가 다르다. ETIMEDOUT과 undici fetch failed의 cause.code를 남기고, maxDuration·AbortSignal·리전을 맞춘다. 개발자, Node.js, 버셀, Next.js, 백엔드, API 기준. 2026년 8월 Node.js·MDN·버셀 문서.

CORS 에러, 프리플라이트, Access-Control-Allow-Origin | 로컬은 되는데 배포하면 막히면?

CORS 에러는 코드가 틀려서가 아니라 서버가 응답에 허용 헤더를 안 붙여서 브라우저가 읽기를 막는 것이다. 프로토콜·도메인·포트가 하나라도 다르면 교차 출처가 되고, JSON 본문이나 Authorization 헤더가 붙으면 OPTIONS 프리플라이트가 먼저 날아간다. Access-Control-Allow-Origin·Methods·Headers, 쿠키를 쓸 때 와일드카드 금지와 정확한 출처 반사, Vary Origin, Next.js rewrites 회피까지. 개발자, Next.js, 프론트엔드, 백엔드, API, 보안 기준. 2026년 8월 MDN·Fetch 표준.

클로드 AI 가격, 무료 한도, 부가세, 소넷 | 결제 직후 첫 주에 어디를 찍을까?

클로드 AI 가격을 결제한 직후 7일 체크리스트다. 웹·앱스토어 청구 경로, 부가세 10% 예산, 설정 사용량 북마크, 소넷 기본, 한국어 장문 쪼개기, 추가 사용량 상한, 콘솔 API 줄, 막힌 횟수, 카드 명세 대조까지. 결제 전·한도 직후·갱신 전과 자리를 섞지 않는다. LLM, API, 개발자, SDK, 클로드 코드, AI 에이전트 기준. 2026년 8월 공식 문서.

클로드 AI 가격, 무료 한도, 부가세, 소넷·오퍼스 | 월 실비용은 어디서 갈라지나?

클로드 AI 가격 표시 달러와 카드 실청구가 어긋나면 세금과 둘째 줄을 본 것이다. 프로 20달러·연 200달러·맥스 100·200달러에 부가세 10%를 가정하고, 구독·콘솔 API·추가 사용량을 나눈다. 무료 한도·한국어 장문 소진, 소넷·오퍼스 코딩 비용, 클로드 코드 동일 풀까지. LLM, API, 개발자, SDK, AI 에이전트, Next.js 기준 심층. 2026년 8월 공식 문서.

error.tsx, not-found, global-error, digest | 없는 글인데 500이 뜨면?

없는 글인데 500이 뜨면 행이 없을 때 throw 한 것이다. notFound는 없음 칸을 열고, 에러 파일은 예기치 않은 예외만 받는다. 같은 폴더 레이아웃은 에러 파일이 안 감싸고, 프로덕션은 digest로 서버 로그와 맞춘다. 개발자, Next.js, 프론트엔드, React, API, 버셀 기준으로 404와 500 칸만 보고 폼 훅 글, 프록시 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

lefthook, husky, git 훅, pre-commit | 커밋은 됐는데 린트가 안 돌면?

허스키를 깔아도 커밋이 그냥 나가면 훅 파일이 저장소에 없는 것이다. 허스키는 준비 스크립트가 훅 자리를 만들고, 레프트훅은 설정 파일과 설치 한 줄이다. 피엔피엠은 빌트 의존에 없으면 설치 후 스크립트를 건너뛴다. 개발자, 오픈소스, 깃허브, Next.js, 프론트엔드, 린트, API, 데브옵스 기준으로 로컬 훅 칸만 보고 시크릿 글, 액션 동시성 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

direnv, .envrc, dotenv, 폴더 환경 | 옆 사이트 키가 셸에 남으면?

옆 사이트 슈퍼베이스 주소가 셸에 남으면 넥스트 환경 파일이 아니라 터미널이 안 지운 것이다. source는 폴더를 나가도 남고, 디렉브는 나갈 때 뺀다. 넥스트는 프로세스 값이 파일보다 앞이다. 개발자, Next.js, 슈퍼베이스, 백엔드, API, 깃허브, 데브옵스 기준으로 셸 언로드 칸만 보고 시크릿 글, 미즈 글, includeIf 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

프록시, matcher, 서버 액션, 관리자 경로 | 화면만 잠그면 저장이 열릴까?

관리 화면이 로그인으로 튕겨도 서버 액션 POST는 남을 수 있다. 넥스트 16 프록시는 미들웨어 자리이고, matcher가 api나 그 경로를 빼면 그 칸의 액션은 안 탄다. 페이지 권한은 화면만 가리고, 액션 안에서 세션을 다시 본다. 개발자, Next.js, 보안, API, 백엔드, 프론트엔드, 서버 액션 기준으로 matcher와 액션 칸만 보고 세임사이트 글, 폼 훅 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

쿼리 타임아웃, 락 대기, 트랜잭션 유휴 | 문의 저장이 안 끝나고 풀이 차면?

문의 저장이 안 끝나면 풀부터 늘리지 않는다. 포스트그레 기본은 문장 제한, 락 대기, 트랜잭션 안 유휴를 0으로 둔다. 액션이 커밋 전에 메일을 기다리면 세션이 idle in transaction으로 남는다. 슈퍼베이스 역할은 익명 3초, 인증 8초, 대시보드 역할은 전역 2분 상한이다. 개발자, Next.js, 백엔드, API, PostgreSQL, 슈퍼베이스 기준으로 제한 숫자 칸만 보고 풀 글, 오토배큠 글과 자리를 섞지 않는다. 2026년 8월 공식 문서.

클로드 AI 가격, 추가 사용량, 맥스 5배, 맥스 20배 | 한도가 닳으면 어디를 켤까?

점심에 클로드 코드 한도가 닳으면 맥스부터 올리지 않는다. 설정 사용량에서 5시간 창과 주간 한도를 가르고, 소넷으로 맞춘 뒤 추가 사용량 월 상한을 맥스 5배 차이보다 낮게 둔다. 클로드 AI 가격, LLM, API, 개발자, SDK, AI 에이전트, 부가세 10% 기준으로 구독과 크레딧 줄을 나눈다. 2026년 8월 공식 화면.

깃허브 환경, 필수 검토, 대기 타이머, 환경 시크릿 | 프로덕션 토큰이 프리뷰 잡에 열리면?

프리뷰 잡이 프로덕션 토큰을 읽으면 값이 저장소 시크릿에 있습니다. 깃허브 환경 시크릿은 그 환경을 적은 잡만 열고, 필수 검토와 대기 타이머는 무료, 프로, 팀의 공개 저장소에만 있습니다. 개발자, 깃허브, Next.js, 데브옵스, 클라우드, API, 백엔드, 버셀 기준으로 배포 잡이 여는 시크릿 칸만 보고 동시성 글, 오아이디씨 글과 자리를 섞지 않습니다. 2026년 8월 깃허브 공식 문서.

깃허브 릴리스, 체인지로그, git-cliff, 공개 노트 | 사용자가 뭐가 바뀌었는지 못 찾으면?

사용자가 뭐가 바뀌었는지 못 찾으면 공개 노트가 커밋 로그이거나 깃허브에만 있습니다. 체인지로그 파일은 저장소에 두고, 깃허브 릴리스는 그 칸을 복사합니다. 깃클리프는 규약 커밋 초안만 뽑습니다. 개발자, Next.js, 깃허브, 백엔드, 데브옵스, API 기준으로 공개 노트 칸만 보고 알림톡 글, 기능 플래그 글과 자리를 섞지 않습니다. 2026년 8월 킵어체인지로그, 깃클리프, 깃허브 공식 문서.

노드 권한, 허용 읽기, 허용 쓰기, 크론 | 검수 스크립트가 홈 폴더를 열면?

검수 스크립트가 홈 폴더를 열면 허용 목록이 없거나 별표입니다. 노드 권한 모델은 22.13부터 안정이고, 퍼미션 플래그를 켜면 읽기 쓰기가 기본 거절입니다. 쓰기는 포스트 폴더만 엽니다. 2026년 7월 보안 배포 패치를 먼저 봅니다. 개발자, Next.js, 노드, API, 백엔드, 데브옵스, 깃허브, 보안 기준으로 프로세스 칸만 보고 테스트 러너 글, 시크릿 글과 자리를 섞지 않습니다.

after, waitUntil, 응답 후 작업, 페이지뷰 | 문의 저장이 끝났는데 버튼이 안 풀리면?

문의 저장이 끝났는데 버튼이 안 풀리면 액션이 메일을 기다린 겁니다. Next.js after는 응답을 보낸 뒤에 로그와 페이지뷰를 돌리고, 버셀은 15.1부터 대기 유틸 대신 이 함수를 권합니다. 정적 페이지에서는 빌드 때 돕니다. 프론트엔드, React, 서버 액션, API, 개발자, 백엔드, 넥스트 기준으로 응답 뒤 칸만 보고 폼 훅 글, 캐시 헤더 글과 자리를 섞지 않습니다. 2026년 8월 넥스트, 버셀 공식 문서.