API 연동을 붙이다 보면 코드는 멀쩡한데 응답이 이상한 순간이 온다. Postman으로는 되는데 서버에서 curl로 때리면 401이 나거나, 로컬은 빠른데 운영에서만 첫 응답이 늦거나 하는 식이다…

요즘 사내에서 "간단한 관리 화면 하나만 빨리 띄워달라"는 요청을 자주 받습니다. 예전 같으면 Next.js 프로젝트부터 만들고 컴포넌트를 하나씩 붙였을 텐데, 이번에는 Vercel의 v0를 처음부…

API 설계 리뷰를 하다 보면 "OAuth 붙였으니 권한 관리는 끝났다"는 말을 종종 듣습니다. 반대로 사내에서 만든 RBAC 테이블을 외부 연동에도 그대로 쓰려는 경우도 있습니다. 둘 다 '권한'…

REST API를 만들고 나면 문서가 항상 뒤로 밀린다. 코드는 계속 바뀌는데 위키나 노션에 손으로 적어둔 파라미터 표는 금세 낡는다. 저는 이럴 때 문서를 사람이 쓰지 않고 코드에서 뽑아내는 방향…

외부 서비스 웹훅을 로컬에서 테스트하고 서명 검증하기: smee, ngrok, HMAC, 재전송 방어

외부 서비스 연동을 붙이다 보면 웹훅(webhook) 처리에서 한 번은 멈춘다. 결제 완료, 저장소 push, 메시지 수신 같은 이벤트를 상대 서비스가 우리 서버로 POST해주는 구조인데, 문제는 …