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. 웹훅 전달이 실패하면 어떻게 되나요?
큐에서 재시도합니다 — 프로덕션은 약 5시간에 걸쳐 총 6회, 샌드박스는 약 12분에 걸쳐 총 4회 시도이며 최초 배달이 1회차입니다. 429를 제외한 4xx는 영구 오류로 보고 재시도하지 않습니다. 로그에서 웹훅 상태를 확인할 수 있습니다.
5. 저장된 데이터를 API로 조회할 수 있나요?
네, 레코드 ID를 사용한 GET 요청으로 개별 레코드를 조회할 수 있습니다. 대시보드에서도 로그 검색을 제공합니다.
6. 협업 키와 협업자는 어떻게 사용하나요?
협업 키를 만들면 별도의 API 키가 발급되고, 해당 협업 키에 여러 명의 협업자를 초대하여 그룹으로 관리할 수 있습니다. 기본 API 키를 공유해서 운영하는 것도 가능하지만, 협업 키를 만들어 협업자를 초대하면 그룹별로 로그와 통계를 분리할 수 있어 관리에 유리합니다. 협업 키는 여러 개 생성할 수 있습니다.
7. 데이터는 얼마나 보관되나요?
프로덕션 레코드는 최소 60일 보관되며, 이후 월 단위로 한꺼번에 삭제됩니다. 샌드박스는 테스트용이라 30일 후 삭제되고, Free 플랜은 엔드포인트 자체가 생성 7일 후 삭제됩니다. 사용량 통계는 별도로 보관되어 레코드가 지워져도 남으므로 대시보드 그래프는 그대로예요. 보관 기간이 지난 뒤에도 데이터를 남기려면 엔드포인트에 웹훅을 설정하거나 GET /api/v1/data/<your-slug>/poll 로 폴링해서 직접 받아 두세요.
8. 프로덕션 콘솔이 무엇인가요?
프로덕션 콘솔은 엔드포인트 소유자가 외부 API 호출 없이 대시보드에서 직접 프로덕션 데이터를 관리(생성, 조회, 수정, 삭제)할 수 있는 기능입니다. 엔드포인트 상세의 프로덕션 탭에서 접근할 수 있습니다.
데이터
1. 구독을 해지하면 데이터는 어떻게 되나요?
구독을 해지하면 결제 기간 종료 후 Free 플랜으로 전환됩니다. 이후에는 Free 플랜 데이터 정책이 예외 없이 적용되어, 생성한 지 7일이 지난 엔드포인트는 샌드박스·프로덕션 데이터와 함께 다음 정리 주기에 삭제됩니다. 남겨야 할 데이터는 해지 전에 내려받아 주세요.