아키텍처

서비스의 기술적 특성을 안내합니다.

1. 성능

빠른 응답

• API 호출은 유효성 검증 후 큐에 삽입되어 빠르게 응답합니다
• 실제 데이터 저장 및 웹훅 호출은 비동기로 처리됩니다

자동 스케일링

• 트래픽 증가 시 백엔드가 자동으로 확장됩니다
• 호출량이 많아도 응답 속도가 저하되지 않습니다

요청 제한

• 악의적인 공격이 아닌 이상 초당 요청 제한이 없습니다
• 월간 요청 한도 내에서 자유롭게 호출할 수 있습니다

2. 보안

악성 공격 차단

• DDoS 공격이 자동으로 탐지 및 차단됩니다
• 악성 트래픽이 서비스에 도달하기 전에 필터링됩니다

데이터 전송 암호화

• 모든 API 통신은 HTTPS/TLS로 암호화됩니다

3. 데이터

지원 형식

• 표준 JSON 형식이면 어떤 데이터든 저장 가능합니다
• 중첩된 객체와 배열도 지원됩니다

용량 제한

• 요청당 최대 100KB

스크립트 포함 대책

• JSON 데이터는 그대로 저장되며 실행되지 않습니다
• 웹훅으로 전달되는 데이터는 원본 그대로 전송됩니다
• 데이터를 활용하는 측에서 적절한 이스케이프 처리가 필요합니다

4. 안정성

데이터 유실 방지

• 큐 우선 설계: 요청은 처리 전에 큐에 저장되어, 데이터베이스 장애 시에도 데이터가 유실되지 않습니다
• 3단계 자동 복구: 애플리케이션 재시도 → 큐 재시도 (5분 간격, ~8시간) → DLQ 복구 (30분 간격, ~48시간)
• 총 약 56시간의 자동 복구 범위

백업

• 데이터베이스는 매일 자동 백업됩니다
• 최근 7일간의 백업을 보관합니다

에러 처리 책임

• API가 202 Accepted를 반환하면, 데이터 처리는 시스템이 보장합니다
• API Gateway에 도달하지 못한 경우 (5xx), 호출자가 지수 백오프로 재시도 로직을 구현해야 합니다

5. 제한 사항

실시간 처리

• 비동기 배치 처리 방식으로 인해 실시간성이 필요한 용도에는 적합하지 않습니다
• 실시간 게임 등 즉각적인 처리가 필요한 경우 다른 솔루션을 고려하세요

예상 처리 시간