읽기 라이브러리
빈 결과와 전송 실패에 서로 다른 화면 제공하기
성공한 빈 양자화 검색을 HTTP 오류나 응답 유실과 구분하세요. 제출한 질문을 보존하고 재시도는 의식적으로 선택하게 합니다.
응답 종류를 정하세요
결과 영역이 비어 있는 것만으로 검색에 무슨 일이 생겼는지 설명할 수 없습니다. 제안하는 LocalLLaMA 노트에서는 진행 중, 레코드가 있는 성공, data 배열이 빈 성공, HTTP 오류, 이용할 응답을 받지 못한 전송을 구분하세요. 이들은 다른 관찰입니다. 빈 성공은 관련 토론이 아카이브에 없다는 증거가 아니고, 응답 유실은 서버의 완료 여부를 알려 주지 않습니다. 그런 해석을 모두 “결과 없음”이라는 간단한 표시로 합치지 마세요.
HTTP 상태와 검증된 응답 형태를 함께 쓰세요. 200 응답에 data: []가 있으면 성공한 빈 조회입니다. HTTP 400, 401, 402, 429, 502는 오류 응답이지 성공한 빈 데이터의 다른 종류가 아닙니다. 네트워크 예외에는 HTTP 상태 자체가 없을 수 있습니다. 오류만으로 요청이 모든 백엔드 단계를 지났는지 추정하지 마세요. 제출 매개변수와 앱의 요청 식별자를 각 결과와 보관해 늦은 응답도 정확한 검색에 붙일 수 있게 합니다.
빈 상태의 다음 행동을 쓰세요
“이 요청에서 반환된 레코드가 없습니다”처럼 절제된 문구를 사용하세요. q=quantization, subreddit=LocalLLaMA와 적용된 날짜나 점수 제한을 가까이 표시합니다. 조건 하나를 고쳐 다시 제출할 수 있는 명시적 방법을 제공하세요. 빈 응답을 꾸민 인기 토론으로 채우거나 옛 라벨을 유지한 채 검색을 자동 확장하지 마세요. 독자가 필터를 빼면 다음 결과는 바뀐 요청에 속하며 1페이지의 새 순서로 시작해야 합니다.
부재의 원인을 알아냈다고 주장하지 말고 관련 조건을 설명하세요. quantization memory의 분석 단어들은 일치하는 한 title 또는 text 안에 있어야 하며 두 필드로 나뉘면 부족합니다. 이는 고려할 수 있는 조건이지 그 응답이 빈 이유의 증거가 아닙니다. 과금 차이도 유지하세요. 빈 성공 조회도 1크레딧입니다. 뒤쪽의 빈 페이지는 전체 수가 불명확할 수 있습니다. 이를 아카이브 전체에 일치가 없다는 주장이나 무한 페이지 요청의 근거로 바꾸지 마세요.
실패 상태의 다음 행동을 쓰세요
행동할 수 있는 사람에게 오류를 연결하세요. HTTP 400이면 지원하지 않는 매개변수나 YYYY-MM-DD 형식이 아닌 날짜처럼 실제 입력을 확인합니다. 401은 서비스 API 키, 402는 서비스 계정 잔액 문제입니다. 어느 것도 독자 자신의 앱 로그인이 끝났다는 증거는 아닙니다. 운영자가 백엔드 인증 정보를 수정하거나 잔액을 확인해야 할 수 있습니다. 공개 검색 화면에 서비스 키를 붙이라고 독자에게 요구하지 마세요.
429에서는 Retry-After를 따르고 반복 제출을 줄이세요. 502에서는 쿼리를 보존하고 필요하면 의도적인 재시도를 제공합니다. 예약 크레딧 환급은 대조를 기다릴 수 있습니다. 응답이 없으면 다른 문구가 필요합니다. 결과를 모르며 성공 요청의 과금 여부도 모르는 상태입니다. 예약 전에 거부된 잘못된 요청은 비과금이지만, 연결 실패가 그런 거부를 입증하지는 않습니다. 무료 /v1/status는 정적 서비스 설명과 HTTP 응답만 나타내며 유실 요청이나 검색 상태를 판정하지 않습니다.
탐색 중의 연속성을 시험하세요
연속성에는 입력 상태 보존도 포함됩니다. 유효한 빈 응답, HTTP 오류, 응답 전 네트워크 예외를 위한 로컬 픽스처를 계획하세요. 명시적인 가상 자료를 사용합니다. 이런 픽스처는 화면을 시험하지 아카이브 가용성을 입증하지 않습니다. 각 경우에 문구가 달라지고 제출 쿼리에 접근할 수 있는지 확인하세요. 요청 대기 중 폼을 바꾸는 사례도 넣어 이전 결과가 새 표현의 답처럼 나타나지 않게 합니다.
다음 페이지가 실패하면 이미 받은 레코드는 남기고, 완료된 자료와 실패한 진행을 구분하세요. 조용히 추가 요청을 보내지 않고 그 페이지를 재시도하거나 폼으로 돌아가게 합니다. 화면에서 늦은 응답을 무시한다고 서버 작업 취소가 보장되지는 않습니다. 실제로 시험한 전환과 아직 제안 단계인 전환을 나눠 기록하세요. 목표는 응답으로 뒷받침되지 않는 안심 문구가 아니라 알려진 사실과 유용한 다음 행동을 보여 주는 화면입니다.
