QuotaMint

/v1/consume은 플랜, 기능 권한, 크레딧 비용, 잔액을 확인하고 allowed: true 또는 allowed: false로 답한다. 거부는 오류가 아니라 정상 응답이라서 앱이 스택 트레이스 대신 업그레이드 안내를 보여줄 수 있다. 승인할 때 같은 호출이 원장 한 줄을 기록한다.

/v1/check는 크레딧을 예약하거나 차감하지 않고 같은 형태의 판단을 돌려준다. 버튼을 회색으로 만들거나, 설정 화면에 남은 잔액을 보여주거나, 긴 작업 전에 고객에게 알릴 때 쓴다. 쓰는 값이 없어서 사용자가 아직 고민 중일 때도 안전하게 호출할 수 있다.

consume 요청에는 HTTP 시도가 아니라 업무 작업을 식별하는 멱등 키를 실을 수 있다. 요청이 시간 초과되어 같은 키로 다시 보내면 QuotaMint가 원래 결과를 돌려주고 추가로 차감하지 않는다. 같은 키의 동시 요청은 첫 처리가 끝날 때까지 기다렸다가 저장된 응답을 받는다.

Starter 월 500크레딧, Pro 월 2,000크레딧 같은 플랜을 만들고 기능마다 비용을 정한다. 텍스트 1, 이미지 10, 영상 50크레딧이다. 기능 권한이 플랜별 도달 범위를 결정한다. 가격 변경은 다음 호출에 적용되고 배포는 필요 없다.

동시 소비로 잔액이 마이너스가 되지 않는다. 10크레딧 잔액에 비용 10짜리 호출이 20건 동시에 들어오면 한 건만 통과하고 나머지 19건은 insufficient_credits로 거부된다. 승인된 호출은 원장에 한 줄을 남기고, 이력에서 언제 어디서 어떤 기능이 크레딧을 썼는지 볼 수 있다. 지원과 재무가 필요로 하는 API 사용량 추적이 여기서 해결된다.

프로젝트마다 테스트 키와 라이브 키가 있고, 플랜의 키 한도에는 따로 계산된다. 테스트 데이터가 실제 잔액에 섞이지 않아서 개발자는 업그레이드, 다운그레이드, 잔액 소진을 실제 API로 연습한 뒤 프로덕션으로 넘어갈 수 있다.

/v1/events는 크레딧을 쓰지 않는 측정된 사용량을 기록한다. API 호출, 처리한 문서, 전사 1분 같은 항목이다. 토큰, 이미지, 분, 자체 단위를 측정하고 고객별 이력은 한곳에서 읽는다. 크레딧을 쓰지 않는 제품은 권한과 이벤트만으로 운영할 수 있다.

설치하거나 유지할 클라이언트 라이브러리가 없다. HTTPS POST를 보낼 수 있는 언어면 되고 TypeScript, Go, Python, Ruby가 모두 해당한다. 요청 본문은 기본 64 KiB 아래로 유지된다. 서버가 QuotaMint를 직접 호출하므로 API 트래픽이 프록시를 거치지 않는다.