FAQ
자주 묻는 질문과 답변입니다.
안정성
1. 데이터가 유실될 수 있나요?
API가 202 Accepted를 반환하면, 3단계 자동 복구 체계(약 56시간)를 통해 처리를 보장합니다. 요청은 먼저 큐에 저장되므로, 데이터베이스 장애 시에도 데이터는 유실되지 않습니다.
2. API가 5xx 에러를 반환하면 어떻게 해야 하나요?
5xx 에러는 요청이 시스템에 도달하지 못했다는 의미입니다. 코드에서 지수 백오프로 재시도 로직을 구현하세요. API가 202를 반환하면 처리는 시스템이 보장합니다.
요금제
1. 무료 체험이 있나요?
네, Free 플랜은 매월 1,000건의 요청이 제공되며 유효기간이 없습니다. 유료 플랜과 동일한 모든 기능을 사용할 수 있습니다. 샌드박스와 프로덕션 환경 모두 포함됩니다. 더 높은 한도가 필요하면 언제든 업그레이드할 수 있습니다.
2. 플랜을 변경하려면 어떻게 하나요?
대시보드에서 즉시 업그레이드할 수 있습니다. 다운그레이드도 즉시 적용되며 남은 기간에 대한 크레딧이 발급됩니다. 플랜 변경은 결제 주기당 1회로 제한됩니다.
3. 환불받을 수 있나요?
30일 이내이며 서비스를 사용하지 않은 경우 전액 환불됩니다. 30일 경과 또는 첫 API 호출 후에는 환불이 불가하며 잔여 기간은 계속 사용할 수 있습니다.
4. 웹훅 호출도 요청 횟수에 포함되나요?
아니요, 웹훅 호출은 별도로 계산하지 않습니다. API 1회 호출 시 웹훅이 여러 번 호출되어도 1건으로 계산됩니다.
서비스
1. 엔드포인트를 몇 개까지 만들 수 있나요?
제한이 없습니다. 모든 플랜에서 무제한으로 엔드포인트를 생성할 수 있습니다.
2. 초당 요청 제한이 있나요?
초당 제한은 없습니다. 월간 총 요청량만 기준으로 제한됩니다.
3. 스키마를 수정하면 기존 데이터는 어떻게 되나요?
변경 사항은 새로운 요청에만 적용됩니다. 기존 데이터는 영향을 받지 않습니다.
4. 웹훅 전달이 실패하면 어떻게 되나요?
최대 3회까지 재시도합니다 (60초 간격). 로그에서 웹훅 상태를 확인할 수 있습니다.
5. 웹훅 실패나 사용량 경고를 알림으로 받을 수 있나요?
네. 엔드포인트 상세의 알림 설정에서 Discord, Slack, Telegram 알림을 설정할 수 있습니다. 웹훅 실패, 사용량 경고, 처리 지연, 배포 알림 등을 지원합니다.
6. 저장된 데이터를 API로 조회할 수 있나요?
네, 레코드 ID를 사용한 GET 요청으로 개별 레코드를 조회할 수 있습니다. 대시보드에서도 로그 검색을 제공합니다.
7. 협업 키와 협업자는 어떻게 사용하나요?
협업 키를 만들면 별도의 API 키가 발급되고, 해당 협업 키에 여러 명의 협업자를 초대하여 그룹으로 관리할 수 있습니다. 기본 API 키를 공유해서 운영하는 것도 가능하지만, 협업 키를 만들어 협업자를 초대하면 그룹별로 로그와 통계를 분리할 수 있어 관리에 유리합니다. 협업 키는 여러 개 생성할 수 있습니다.
8. 데이터 아카이빙은 어떻게 동작하나요?
프로덕션 데이터는 30일이 지나면 일 단위로 자동 아카이빙됩니다. 아카이빙된 레코드는 로그에서 계속 조회할 수 있으며, 대시보드 > 아카이브에서 일별 파일로 다운로드할 수 있습니다. 샌드박스 데이터는 테스트 목적이므로 30일 후 자동 삭제됩니다.
9. 프로덕션 콘솔이 무엇인가요?
프로덕션 콘솔은 엔드포인트 소유자가 외부 API 호출 없이 대시보드에서 직접 프로덕션 데이터를 관리(생성, 조회, 수정, 삭제)할 수 있는 기능입니다. 엔드포인트 상세의 프로덕션 탭에서 접근할 수 있습니다.
데이터
1. 구독을 해지하면 데이터는 어떻게 되나요?
구독을 해지하면 결제 기간 종료 후 Free 플랜으로 전환됩니다. 프로덕션 데이터는 아카이빙 주기에 따라 자동 아카이빙된 후, Free 플랜의 데이터 정책(엔드포인트 생성 7일 후 삭제)이 적용됩니다. 회원 탈퇴 시에만 모든 데이터가 즉시 삭제됩니다.