피드로 돌아가기
Dev.toBackend
원문 읽기
YouVersion API 통합을 통한 다국어 성경 콘텐츠 파이프라인 최적화
4 footguns integrating YouVersion's new platform API — and a clean Verse of the Day
AI 요약
Context
FastAPI, React, Supabase 기반의 오픈소스 LMS에서 사용자 리텐션을 위한 '오늘의 말씀' 기능을 구현함. 1,400개 이상의 성경과 1,200개 이상의 언어를 제공하는 YouVersion Platform API를 도입하여 콘텐츠 관리 비용을 제거하고 글로벌 확장성을 확보함.
Technical Solution
- ISO 639-3 언어 필터 기반의
language_ranges[]쿼리 파라미터 적용을 통한 API 422 에러 해결 all_available=true플래그 설정을 통해 App Key 권한 기반의 제한적 리스트가 아닌 전체 카탈로그 데이터 확보- API 응답 내 HTML 태그 및 불필요한 Whitespace를 제거하는 Regex 기반의 Data Sanitization 로직 구현
- 플랫폼 제공 VOTD 엔드포인트의 큐레이션 제약을 극복하기 위해 250개의 자체 reference 리스트를 구축한 Custom Selection 구조 설계
X-YVP-App-Key전용 헤더를 통한 인증 체계 적용 및 통합 문서 내 명시를 통한 개발 생산성 향상
실천 포인트
- 외부 API 도입 시 4xx 에러의 Response Body를 통해 숨겨진 필수 쿼리 파라미터를 식별할 것 - API 제공자의 필터링 로직(예: 권한 기반 노출)과 실제 데이터 존재 여부를 분리하여 검증할 것 - 신뢰할 수 있는 소스의 HTML 응답이라도 UI 일관성을 위해 정규식을 활용한 텍스트 정규화 과정을 거칠 것 - 플랫폼의 기본 큐레이션 기능이 서비스의 도메인 특성(예: 교단 중립성)과 맞지 않을 경우 자체 메타데이터 리스트를 운영할 것