요청 지도를 먼저 그리세요
하이킹 앱 안에서 오프라인 지도에 관한 토론을 읽는 기능의 예산을 계획할 때는 비용이 반환되는 데이터양이 아니라 조회 요청에 연결된다는 점부터 알아야 합니다. 정상 검색 한 번은 3레코드, 100레코드, 빈 목록 중 무엇을 반환하든 1크레딧입니다. 작은 페이지가 읽기에는 도움이 될 수 있지만 그 요청의 크레딧 단가를 낮추지는 않습니다.
실제로 서비스에 도달하는 동작을 그려 보세요. 첫 검색, 요청한 다음 페이지, 명시적 새로고침, 단일 항목 조회는 각각 별도의 조회가 될 수 있습니다. 이미 로드한 글을 스크롤하는 것은 새 요청이 아닙니다. 백엔드가 한 번의 버튼 조작을 여러 호출로 나누면 버튼 한 번이 반드시 1크레딧은 아닙니다.
가정한 하루를 계산하세요
다음은 관측한 트래픽이나 이용 예측이 아니라 계획용 예시입니다. 앱이 첫 페이지 120회, 추가 페이지 30회, 새로고침 10회를 정상 완료했다고 가정합니다. 정상 요청 160회, 160크레딧이며 명시된 단가로 $0.16에 해당합니다. 첫 페이지 응답 중 20개가 비어 있어도 요청은 성공했으므로 총 160크레딧은 그대로입니다.
이번에는 아무도 읽지 않더라도 첫 검색마다 세 페이지를 자동으로 조회한다고 가정합니다. 새로고침을 세기 전부터 360회가 되며, 앞선 예시의 첫 검색과 의도적인 다음 페이지 요청 합계 150회와 다릅니다. 이 비교는 주어진 가정에 따른 계산이지 실제 사용자 행동의 증거가 아닙니다. 구현 후에는 가정을 자체 측정 요청 로그로 바꾸세요.
사용 단가와 구매 금액을 구분하세요
표준 단가는 정상 조회 요청 1,000회당 $1입니다. 최소 유료 충전액은 $50이고 유료 크레딧 50,000개를 제공합니다. 구독은 없으며 유료 크레딧은 만료되지 않습니다. 따라서 가상의 하루 $0.16은 잔액 소비를 설명하는 것이지 $0.16만 충전할 수 있다는 뜻이 아닙니다.
선택적 100크레딧 체험은 네트워크 전체의 부정 사용 방지 자격에 따른 조건부 제공이며 유료 환산과 별개입니다. 모든 가입자가 받는다고 가정하거나 무료 API라고 소개하지 마세요. 로그인한 상태에서 청구서를 만들고 정확한 지급 금액, 수신 주소, 토큰과 네트워크를 사용하세요. 「키와 크레딧」에 계정 및 결제 단계가 있습니다.
실패와 불확실성을 구별하세요
HTTP 400, 401, 402, 429는 조회 크레딧 예약 전에 거부됩니다. 각각 잘못된 입력, 없거나 유효하지 않은 키, 크레딧 부족, 요청 속도 제한을 알립니다. 상위 요청이 실패하면 예약된 크레딧을 해제하지만 대사가 보류될 수 있습니다. 모든 오류 경로를 이전 과금의 즉시 반환이라고 설명하지 마세요.
요청을 보낸 뒤 앱이 응답을 잃으면 서버가 정상 조회를 완료했는지 모를 수 있습니다. 재시도는 새로운 요청이지 무료로 이어지는 처리가 아닙니다. 불확실한 결과를 기록하고 쿼리를 보존하며 자동 재시도가 몰리지 않게 하세요. 계정 화면에서 대사를 위한 성공, 보류, 반환 요청 수를 제공합니다.
기능에도 상한을 두세요
쿼리마다 1–100페이지, 요청마다 최대 100레코드를 허용합니다. 이는 서비스의 한계이지 모든 페이지를 가져오라는 권장은 아닙니다. 앱은 대화형 읽기 세션에 더 낮은 페이지 예산을 설정하고 추가 조회 전에 확인할 수 있습니다. 반복 요청으로 빈 페이지를 찾기보다 pagination.has_more와 최종 범위 경계를 지키세요.
최대 10,000레코드의 조회 범위를 보장된 수확량으로 계산하지 마세요. 응답이 비거나 레코드에 필드가 없을 수 있으며 아카이브는 완전한 수록 범위를 약속하지 않습니다. /v1/status는 무료지만 계정 잔액을 반환하지도, 검색 상태를 검사하지도 않습니다. 로컬 카운터에도 대사가 필요하며 응답을 잃은 요청이 무료였다고 증명할 수 없습니다.
독자가 실제로 필요한 선택을 검토하세요
제안된 하이킹 패널에서는 짧은 첫 페이지와 의도적인 더 보기만으로 토론 참조를 비교할 수 있을지도 모릅니다. 이미 앱에 저장한 내용을 저장하거나 다시 열 때 몰래 재조회하지 마세요. 독자가 명시적으로 항목 재확인을 요청하면 새 조회임을 설명하고 조회할 수 없는 결과도 처리하세요.
한도나 표시를 조정할지는 자체 트래픽 증거로 판단하세요. 계획 예시를 사용자당 비용, 유지율 또는 성능의 약속으로 바꾸지 마세요. 범위를 제한하는 페이지네이션과 기기 내 읽기 목록 설계는 /ko/#field-notes에서 확인하세요.
