릴리즈 노트

3Min API의 모든 업데이트 이력. 최신 변경사항부터 차례로 확인할 수 있습니다.

2026-09-01 v1.9.0

월 호출 한도를 크게 올렸습니다

보관 기간보다 호출 한도에 대한 요청이 훨씬 많았습니다. 그래서 데이터 보관 정책을 정리하고, 그 여력을 한도로 옮겼습니다. Basic과 Pro 모두 3배 이상 늘어납니다.

  • Basic 월 30,000건 → 100,000건, Pro 300,000건 → 1,000,000건
  • 프로덕션 레코드는 최소 60일 보관됩니다 (샌드박스는 기존과 동일하게 30일)
  • 사용량 통계는 그대로 보관되어 대시보드 그래프는 유지됩니다
  • 아카이브 다운로드는 종료됩니다. 보관 기간 안의 레코드는 로그에서 계속 조회할 수 있어요
  • 데이터를 오래 남기려면 웹훅이나 GET /api/v1/data/<your-slug>/poll 로 들어오는 즉시 받아 두세요
2026-08-28 v1.8.0

폴링 전용 엔드포인트가 생겼습니다

새 레코드를 받으려던 클라이언트는 목록 API의 첫 페이지를 계속 다시 읽는 수밖에 없었습니다. 최신순인 데다 "언제부터"를 지정할 방법이 없어, 매 폴링마다 같은 레코드를 다시 받아 대부분을 버렸습니다. 이제 마지막 호출 이후 들어온 것만 오래된 순으로 돌려주고, 어디까지 읽었는지 기억하는 전용 엔드포인트가 있습니다.

  • 새 엔드포인트 GET /api/v1/data/<슬러그>/poll — 마지막 호출 이후 생성된 레코드를 오래된 순으로, 페이지당 최대 100건
  • 직전 응답의 커서를 그대로 돌려보내면 되므로 시각을 직접 관리할 필요가 없습니다. 첫 호출은 since(전부 UTC)를 쓰거나, 아무것도 넘기지 않으면 그 시점부터 구독합니다
  • 응답에는 두 커서 중 정확히 하나만 담깁니다. next_cursor는 아직 밀린 데이터가 남았다는 뜻이니 즉시 다시 호출하고, poll_cursor는 따라잡았다는 뜻이니 저장한 뒤 다음 주기까지 기다립니다
  • 최신 약 60초는 큐가 따라잡을 때까지 보류됩니다. 레코드를 건너뛰는 게 아니라 다음 폴링으로 미루는 것입니다
  • 재시도·재시작 시 같은 레코드가 다시 올 수 있으므로 레코드 id 기준으로 멱등 처리하세요
  • API 레퍼런스, 샌드박스 콘솔 코드 샘플, 연동 문서에 모두 반영했습니다
2026-08-28 v1.7.1

웹훅 재시도 횟수를 모든 곳에서 같은 방식으로 셉니다

문서마다 웹훅 재시도를 세는 방식이 달랐습니다. 어떤 곳은 재시도만, 어떤 곳은 총 시도를 세서 같은 정책이 읽는 페이지에 따라 5회로도 6회로도 보였습니다. 이제 모든 곳이 같은 숫자를 말합니다. 여러분 쪽 처리가 실패했을 때 무엇을 반환해야 하는지도 수신기 계약에 명시했습니다.

  • 프로덕션은 총 6회 시도입니다 — 최초 배달 1회 + 재시도 5회(30초·2분·10분·1시간·4시간). 샌드박스는 약 12분에 걸쳐 총 4회입니다
  • 2xx는 "성공했다"가 아니라 "받았다"는 뜻입니다 — 여러분 쪽 처리가 실패해도 2xx를 반환하고, 그 실패는 여러분 시스템에 기록하세요
  • 5xx는 그것이 실제로 뜻하는 상황에만 쓰세요 — 수신기나 그 의존 대상이 일시적으로 죽어서 같은 레코드를 나중에 받으면 성공할 수 있는 경우입니다
  • 로그 화면의 재시도 배지가 2/5 대신 3/6으로 표시됩니다 — 같은 배달을 문서와 같은 기준으로 센 것입니다
  • 배달과 재시도 동작 자체는 아무것도 바뀌지 않았습니다 — 설명 방식만 바뀌었습니다
2026-08-28 v1.7.0

웹훅이 멈추면 이제 메일로 알려드립니다

배달이 끊긴 웹훅은 조용합니다 — 데이터는 그대로 저장되니 로그를 들여다보기 전까지는 아무 문제도 없어 보이죠. 이제 재시도를 모두 소진하는 순간 알려드립니다.

  • 어느 엔드포인트인지, 응답 코드와 실패 사유, 그리고 수신 서버가 돌려준 응답 본문까지 담습니다 — 방화벽이 막은 것인지 앱이 거부한 것인지를 가르는 단서예요
  • 한 번 튄 실패로는 오지 않습니다. 배달을 포기한 시점에 오는데, 프로덕션 재시도를 다 쓰면 약 5시간 뒤이고 재시도하지 않는 영구 응답이면 곧바로예요
  • 몇 건이 실패하든 엔드포인트당 하루 한 통까지입니다. 데이터는 안전하게 저장돼 있다는 사실도 함께 알려드려요
  • 무료 플랜도 받습니다. 프로덕션의 소유자 웹훅만 해당하고, 협업자 웹훅은 그 URL을 소유자가 바꿀 수 없어 제외했어요
  • 복구 알림도 후속 메일도 없습니다 — 수신 서버를 고치면 다음 호출부터 정상 전달됩니다
2026-08-27 v1.6.0

이벤트 알림 기능을 제거했습니다

웹훅 실패나 사용량 임계치 같은 이벤트를 Discord·Slack·Telegram으로 알려주던 기능을 제거했습니다. 필요한 알림은 이미 이메일로 나가고 있어, 따로 하실 일은 없습니다.

  • 엔드포인트 상세 페이지의 알림 카드가 사라졌고, AI 연동 도구도 알림 설정을 더 이상 받지 않습니다
  • 사용량 경고와 한도 초과, 배포 요청·완료 알림은 이메일로 그대로 옵니다 — 달라지는 것 없습니다
2026-08-25 v1.4.0

실패한 웹훅이 로그 화면에 보입니다

로그 화면은 요청을 받아 저장했는지만 보여줬어요. 그래서 웹훅이 서버에 끝내 도달하지 못해도 성공으로 표시됐고, 데이터가 조용히 사라질 수 있었죠. 이제 실패한 배달이 같은 화면에 나타납니다.

  • 웹훅 컬럼이 배달에 실패했거나 아직 재시도 중인 호출을 응답 코드와 함께 표시합니다
  • 웹훅 실패 필터로 아직 서버에 도달하지 못한 호출만 골라 볼 수 있어요
  • 로그 상세에서 서버가 돌려준 응답 본문을 그대로 확인할 수 있습니다 — 방화벽 차단인지 앱이 거부한 것인지 가르는 유일한 단서예요
  • 자동 재시도를 포함해 모든 시도가 시각·소요 시간과 함께 나열됩니다
  • 실패한 배달만 기록되므로 빈 칸이 곧 성공은 아닙니다 — 웹훅을 설정하지 않은 엔드포인트에서는 컬럼 자체가 보이지 않아요
2026-08-25 v1.3.0

모든 웹훅에 서명이 붙습니다

지금까지 진짜 웹훅과 위조된 요청을 구분할 방법은 고정 인증 헤더뿐이었어요. 설정이 선택이고, 매 요청 같은 값이 가고, 본문이 바뀌어도 알 수 없었죠. 이제 배달마다 HMAC-SHA256 서명이 함께 갑니다.

  • Standard Webhooks 규격을 따라, 9개 언어 공식 라이브러리로 서너 줄이면 검증됩니다
  • 검증은 선택입니다 — 이미 웹훅을 받고 있다면 켜기 전까지 달라지는 것이 없어요
  • 시크릿은 엔드포인트 상세 화면의 웹훅 서명 시크릿에서 확인하세요. 샌드박스와 프로덕션이 각각 다릅니다
  • 재발급해도 24시간은 이전 시크릿이 함께 유효해, 배달을 놓치지 않고 서버를 교체할 수 있어요
  • 직접 지정한 콜백 URL로 받는 웹훅도 서명됩니다
2026-08-24 v1.2.0

웹훅 재시도가 초 단위에서 시간 단위로 늘어났습니다

웹훅 재시도가 요청 하나 안에 갇혀 있어 3회 시도가 24초 안에 모두 끝났습니다. 그 사이에 되살아나는 수신 서버는 거의 없었습니다. 재시도를 큐로 옮겼습니다.

  • 타임아웃을 7초에서 15초로 늘렸습니다
  • 프로덕션은 약 5시간에 걸쳐 5회, 샌드박스는 약 12분에 걸쳐 3회 재시도합니다
  • 새 X-3minapi-Record-Id 헤더는 재시도 간에도 값이 같습니다 — 중복 판단에 쓰세요
  • 429를 제외한 4xx는 더 이상 재시도하지 않습니다. 409도 포함됩니다 — 이미 받았다는 뜻으로 읽습니다
  • 실패한 배달이 기록으로 남습니다 — 로그 화면에서 보는 것은 다음 릴리즈에 들어갑니다
2026-08-07 v1.1.0

Google Sheets 연동 종료

API 데이터를 받고, 저장하고, 전달하는 핵심에 집중하기 위해 Google Sheets 연동을 제거했습니다.

  • 기존 스프레드시트는 본인 Google Drive에 그대로 남습니다 — 삭제된 것은 없습니다
  • 모든 API 기록은 로그·통계·아카이브에서 계속 확인할 수 있습니다
  • 스프레드시트 작업은 아카이브의 CSV 내보내기로 대체됩니다
  • 3Min API에 부여됐던 Google Drive 권한은 해제되었습니다
2026-05-22 v1.0.3

검색(Search) 엔드포인트 추가

payload 안의 텍스트로 레코드를 찾는 새 API 엔드포인트.

  • 대소문자 무시 부분 매칭, 최소 3자
  • 기간 지정 가능 — 미지정 시 최근 30일
  • 커서 페이지네이션 (페이지당 1~30, 기본 10)
2026-05-15

WordPress 플러그인 제공 (zip 설치)

WordPress 페이지에서 입력 폼과 데이터 화면을 코드 없이 만들고 3Min API와 직접 연결.

  • zip 파일 다운로드 후 수동 설치
  • 폼/리스트/단건 조회 스니펫 자동 생성
2026-05-08 v1.0.2

목록(List) 엔드포인트 추가

record_id 없이 GET 호출 시 최근 레코드 목록을 반환합니다.

  • 시간 역순 정렬
  • 커서 페이지네이션 (페이지당 1~30, 기본 10)
2026-04-30 v1.0.1

MCP 지원 및 ChatGPT 플러그인 등록

AI 에이전트가 자연어로 API를 직접 호출할 수 있습니다.

  • 모든 엔드포인트에 MCP 서버 자동 제공
  • Claude / Cursor / ChatGPT 플러그인 지원
2026-03-26 v1.0.0

정식 오픈

3Min API가 정식 출시되었습니다. 무료/유료 플랜과 가이드 문서를 함께 제공합니다.

2026-01-01 v0.9.5

클로즈 베타

초청받은 초기 사용자만 사용하는 클로즈 베타로 출발했습니다.