자주 묻는 질문

언제든 해지할 수 있습니다. 월간 구독은 해지한 뒤에도 이미 결제한 이용기간이 끝날 때까지 Pro 기능을 그대로 쓸 수 있고, 종료일에 자동으로 Free 플랜으로 전환됩니다. 연간 구독은 해지 요청이 환불 요청으로 접수되어 검토와 승인을 거쳐 처리되며, 승인 전까지는 Pro 이용이 유지됩니다. 결제 실패로 이용이 중단된 구독을 해지하면 즉시 Free 플랜으로 전환됩니다.

Pro 플랜은 정기결제로 제공됩니다. 등록하신 결제 수단으로 매 결제 주기(월간 또는 연간)마다 다음 이용기간 요금이 자동으로 청구됩니다. 다음 결제 예정일 전에 마이페이지 > 구독 관리에서 해지하면 자동결제가 중단됩니다. 결제에 실패하면 일정 기간 재시도하며, 그 기간에도 결제되지 않으면 Free 플랜으로 전환됩니다.

네, 마이페이지 > 구독 관리에서 변경할 수 있습니다. 월간과 연간 어느 방향이든 지금 바로 청구되지 않고, 현재 이용기간이 끝나는 다음 결제일에 새 주기 요금으로 청구됩니다. 변경하려면 등록된 결제 수단이 있어야 하며, 해지를 예약했거나 환불 승인을 기다리는 중에는 변경할 수 없습니다.

유예기간(30일) 안에 다시 구독하면 비활성 상태였던 프로젝트와 엔드포인트가 모두 복구됩니다. 유예기간이 지나 삭제된 데이터는 복구할 수 없습니다. 다시 만들어야 합니다.

Free 플랜은 프로젝트 3개, 엔드포인트 5개까지 만들 수 있고 탐색 페이지에 광고가 표시됩니다. Pro 플랜은 프로젝트와 엔드포인트 개수 제한이 없고, 모든 페이지에서 광고가 제거되며, 하나의 엔드포인트가 여러 API를 병렬 호출해 결과를 합치는 멀티소스 기능과 SDK 사용량 분석을 쓸 수 있습니다. 자세한 비교는 요금제 페이지에 있습니다.

탈퇴하면 계정과 함께 프로젝트, 가공 설정, SDK 키가 모두 삭제됩니다. 배포된 설정도 더 이상 서빙되지 않으므로 그 SDK 키를 쓰던 앱은 호출에 실패하게 됩니다. 구독 중이라면 탈퇴 전에 해지와 환불 절차를 먼저 마치는 것을 권합니다. 커뮤니티에 공개한 가공 설정을 다른 사용자가 Fork해 간 경우, 그 사본은 각자의 것이므로 함께 삭제되지 않습니다.

결제일로부터 7일 이내에 요청하시면 전액 환불됩니다. 7일이 지난 뒤에는 남은 이용기간만큼 일할 계산해 환불하며, 환불액은 결제 금액에 남은 이용기간을 전체 이용기간으로 나눈 비율을 곱해 원 단위로 절사해 산정합니다. 이용기간이 이미 끝났다면 환불액은 없습니다. 환불 요청은 접수 후 검토와 승인을 거쳐 결제하신 수단으로 처리됩니다. 자세한 내용은 이용약관 제4조의4를 확인해 주세요.

월간 구독은 별도 환불 없이 이미 결제한 이용기간이 끝나는 시점에 해지됩니다. 해지해도 그 기간까지는 Pro 기능을 그대로 쓸 수 있습니다.

아닙니다. 결제가 실패하면 일정 기간 자동으로 재시도하며, 그동안은 Pro 기능을 계속 쓸 수 있습니다. 이 기간에는 결제 수단을 갱신해 달라는 안내가 화면에 표시됩니다. 재시도 기간에도 결제되지 않으면 Free 플랜으로 전환됩니다. 마이페이지 > 구독 관리에서 결제 수단을 바꾸면 바로 정상화됩니다.

국내 신용카드와 체크카드로 결제할 수 있습니다. 정기결제 특성상 카드 등록이 필요하며, 카드 정보는 결제대행사가 보관하고 ApiCook 서버에는 저장되지 않습니다.

결제 내역은 마이페이지 > 결제 내역에서 확인하고 영수증을 내려받을 수 있습니다. 사업자 세금계산서가 필요하시면 문의 페이지의 이메일로 사업자등록번호와 해당 결제 건을 알려주세요.

결제 완료 후 플랜 반영까지 최대 1분 정도 걸릴 수 있습니다. 페이지를 새로고침해 보세요. 몇 분이 지나도 그대로라면 마이페이지 > 결제 내역에서 결제가 정상 완료됐는지 먼저 확인해 주세요. 결제는 됐는데 플랜이 그대로라면 문의 페이지로 결제 시각과 함께 알려주시면 확인해 드립니다.

Free 플랜은 프로젝트 3개, 엔드포인트 5개까지 만들 수 있습니다. 한도에 도달하면 새로 만드는 것만 제한되고, 이미 만든 프로젝트와 엔드포인트는 정상적으로 동작합니다. Pro로 업그레이드하면 즉시 제한이 풀립니다.

Free 한도(프로젝트 3개·엔드포인트 5개)를 초과하는 프로젝트와 엔드포인트는 비활성 상태로 전환되고 30일의 유예기간이 주어집니다. 유예기간에는 마이페이지에서 계속 사용할 항목을 직접 고를 수 있고, 다시 Pro를 구독하면 모두 복구됩니다. 유예기간이 끝나면 비활성 상태로 남은 데이터는 삭제되며 복구할 수 없습니다.

ApiCook 쪽에는 일반적인 사용에서 부딪힐 만한 호출 제한이 없습니다. 다만 실제 데이터를 주는 것은 원본 API이므로 그쪽의 일일 호출 한도가 그대로 적용됩니다. 공공데이터포털은 보통 일 1,000회에서 시작하고 신청으로 늘릴 수 있습니다. 각 API의 한도는 자료실 상세 페이지에 표시됩니다.

호출되지 않습니다. 비활성 엔드포인트는 배포에서 빠지므로 SDK가 설정을 받아올 때 목록에 나타나지 않고, 호출하면 엔드포인트를 찾을 수 없다는 오류가 납니다. 유예기간 안에 다시 활성으로 바꾸거나 Pro를 구독하면 복구됩니다.

공개 API의 응답을 원하는 모양으로 바꿔주는 도구입니다. 공공데이터 API는 실제 데이터가 여러 단계 안쪽에 들어 있고, 숫자도 문자열로 오고, 브라우저에서는 CORS에 막혀 호출조차 안 되는 경우가 많습니다. ApiCook에서는 웹 에디터로 어디를 읽고 어떤 이름과 타입으로 내보낼지를 정해두고, SDK로 한 줄 호출해 가공된 결과를 받습니다. 자세한 설명은 문서 > ApiCook이란에 있습니다.

아니요. 현재 ApiCook은 JSON 응답만 가공할 수 있습니다. XML이나 CSV로 응답하는 API는 호출 단계에서 지원하지 않는 응답 형식 오류가 납니다. 자료실 상세 페이지의 응답 형식 항목에서 미리 확인할 수 있습니다. 같은 기관의 서비스라도 엔드포인트마다 형식이 다를 수 있으니 원본 문서도 함께 보시는 편이 안전합니다.

ApiCook이 아니라 데이터를 제공하는 기관에서 발급받습니다. 공공데이터포털이라면 해당 서비스의 활용 신청을 하고 일반 인증키를 받으시면 됩니다. 자동 승인이면 몇 분, 심의가 필요한 서비스는 하루 이상 걸리기도 합니다. 자료실 상세 페이지의 원본 문서 링크에서 바로 이동할 수 있습니다.

네, 다릅니다. SDK 키(apk_로 시작)는 ApiCook이 발급하며, 여러분의 가공 설정을 내려받고 프록시를 호출할 때 씁니다. 원본 API 인증키는 데이터 제공 기관이 발급하며, 실제 데이터를 가져올 때 원본 API로 전달됩니다. 둘 다 코드에 직접 쓰지 말고 환경변수로 관리하세요.

저장과 배포는 별개입니다. 저장은 작업 내용을 보관할 뿐이고, 배포를 해야 규칙이 SDK가 내려받는 설정에 반영됩니다. 에디터에서 배포하기를 누르셨는지 확인해 주세요. 배포했는데도 그대로라면 SDK가 설정을 최대 60초간 캐시하기 때문일 수 있습니다. 코드에서 refresh를 호출하면 즉시 다시 받아옵니다.

다시 확인할 수 없습니다. 서버에는 키의 해시만 저장되고 원문은 발급 직후 화면에서만 볼 수 있습니다. 에디터에서 재발급하시면 됩니다. 다만 재발급하는 순간 이전 키는 무효가 되므로, 그 키를 쓰던 앱의 환경변수도 함께 바꿔야 호출이 이어집니다.

됩니다. SDK가 브라우저 환경을 감지해 ApiCook 프록시를 경유하므로 CORS에 막히지 않고, 원본 API 인증키도 브라우저에 노출되지 않습니다. 다만 브라우저 번들에 들어간 SDK 키는 공개된 것으로 봐야 합니다. 프로젝트 설정에서 허용 도메인을 지정해 다른 사이트에서 그 키를 쓰지 못하게 막아두세요.

대개 데이터 위치 설정이 실제 응답 구조와 어긋난 경우입니다. 공공데이터포털 API는 보통 실제 목록이 response.body.items.item 안에 있습니다. 에디터의 미리보기에서 원본 응답 트리를 펼쳐 실제 경로를 확인하고 다시 지정해 보세요. 원본 API가 오류를 JSON으로 돌려주는 경우도 있습니다. 이때는 형식은 정상이지만 지정한 위치에 값이 없어 null이 됩니다. 미리보기의 원본 응답에 오류 메시지가 있는지도 함께 확인해 보세요.

Pro 플랜의 멀티소스 기능으로 가능합니다. 하나의 엔드포인트에 API를 여러 개 연결하면 병렬로 호출해 결과를 소스 이름별로 묶어 돌려줍니다. 일부가 실패해도 나머지는 정상적으로 받을 수 있고, 어떤 소스가 왜 실패했는지도 함께 전달됩니다. 자세한 내용은 문서 > 병렬 멀티소스 호출에 있습니다.

ApiCook은 원본 API를 대신 호출할 뿐이므로 원본이 멈추면 호출도 실패합니다. 데이터를 따로 저장해두지 않기 때문입니다. 대신 자료실의 각 API가 지금 정상인지를 주기적으로 점검해 가동률과 응답시간, 최근 장애 이력을 상세 페이지에 기록해 둡니다. API를 고르기 전에 확인해 보시면 도움이 됩니다.

원본 API의 응답 데이터를 쌓아두지 않습니다. 호출할 때마다 원본에서 가져와 가공해 전달합니다. 성능을 위한 짧은 캐시는 있습니다. 프록시 응답은 설정된 시간(기본 60초) 동안 캐시되며, 이 시간은 엔드포인트별로 조정할 수 있습니다.

원본 데이터의 이용 조건을 따릅니다. ApiCook은 데이터의 권리자가 아니라 호출을 돕는 도구입니다. 공공데이터포털 데이터는 대개 공공누리 라이선스를 따르며 유형에 따라 출처 표시나 상업적 이용 조건이 다릅니다. 자료실 상세 페이지의 출처 정보에 각 API의 라이선스 유형을 표시해 두었으니 확인 후 이용해 주세요.

자료실 페이지의 API 등록 요청으로 알려주세요. 확인 후 수집 대상에 추가합니다. 요청하실 때 API 이름과 원본 문서 주소를 함께 적어주시면 처리가 빠릅니다.

문의 페이지의 이메일로 보내주세요. 오류 신고라면 어느 페이지에서 무엇을 하다가 생겼는지, 화면에 나온 메시지가 있다면 그 내용을 함께 적어주시면 원인을 찾는 데 큰 도움이 됩니다. 자료실 데이터의 오류(설명이 실제와 다르거나 엔드포인트 정보가 낡은 경우)도 같은 경로로 알려주시면 원본을 다시 확인해 보정합니다.