변경 이력
임베드 위젯의 모든 변경 사항(URL, 파라미터, 키, 도메인, 한도)을 최신순으로 정리했습니다. 한 버전 안에서 무엇이 안정적으로 유지되는지는 정책에 나와 있습니다.
위젯은 더 이상 Bitculator와 웹소켓 연결을 열지 않으며, 방문자의 브라우저 저장소에 번역 데이터를 기록하지도 않습니다. 화면에 보이는 것은 달라지지 않습니다. 위젯은 원래 실시간 가격을 스트리밍하지 않았으므로 수치는 항상 페이지 로드 시점 기준입니다.
복리 기간 중간에 끝나는 기간에도 이제 비례 이자가 붙고 그 안에서 이루어진 입금도 반영되며, 성장 곡선은 경과 시간에 맞춰 간격이 정해집니다. 입력값에는 상한이 있습니다. 원금 1,000,000,000,000, 납입액 1,000,000,000, 이율 1,000%, 기간 50년 또는 600개월이며, 상한을 넘는 값은 상한으로 재설정됩니다.
이율은 이제 연 명목 이율이며 복리 기간에 나누어 적용됩니다. 이전에는 전체 이율이 매 기간에 적용되어 월 복리 5%가 매월 5%씩 불어났습니다. 기존 임베드의 결과는 그에 맞게 낮아집니다.
유료 임베드 요금제를 해지하면 이제 예약해 둔 다운그레이드도 함께 취소됩니다. 요금제는 결제한 기간이 끝날 때까지 그대로 유지됩니다.
DCA 시작일·종료일 선택기는 날짜를 UTC 자정으로 읽었기 때문에, UTC보다 서쪽에 있는 방문자에게는 전날이 표시되었습니다. 이제 방문자의 현지 달력 날짜를 사용합니다.
{locale} 경로 세그먼트는 이제 9월 19일부터 24일 사이에 추가된 ar(오른쪽에서 왼쪽으로 표시), sk, th, ko, ro, hu, sr, fi도 받으며, 총 27개 언어를 지원합니다.
위젯 페이지는 더 이상 세션 쿠키나 XSRF 쿠키를 설정하지 않으며, 방문자의 브라우저에 서비스 워커도 등록하지 않습니다. 키 없는 방문자별 카운터는 이제 IP 주소의 키 기반 해시를 사용하며, 리퍼러 없이 이루어진 키 없는 로드는 IP 대신 "직접 유입"으로 보고됩니다.
/embed/zoom/{slug}의 월별·주별 행은 이제 세션 토큰 없이 가져옵니다. 다른 사이트의 iframe 안에 있는 위젯은 세션 토큰을 받을 수 없기 때문입니다.
두 자산 중 하나라도 사용할 수 있는 가격이 없으면 변환기는 "1 X = 0 Y" 대신 아무 수치도 표시하지 않으며, 시가총액 플리퍼는 쌍에 시가총액이 없으면 이전 쌍의 숫자를 새 이름 아래에 남겨 두지 않고 수치를 지웁니다.
코인의 이전 슬러그를 사용하는 위젯 URL은 이제 현재 슬러그의 같은 위젯으로 향하는 301을 반환하며, embed_key를 포함한 쿼리 문자열은 그대로 유지됩니다. 이전에는 404를 반환했습니다.
등록하는 도메인은 브라우저가 URL을 읽는 방식대로 해석됩니다. 스킴, 경로, 포트, 맨 앞의 www.는 제거되고, 이름은 소문자로 바뀌며, 국제화 도메인 이름은 퓨니코드로 변환됩니다. 호스트 이름이 아닌 값은 모두 거부됩니다. 임베드하는 페이지의 Referer도 같은 방식으로 정규화됩니다. www 이외의 하위 도메인은 여전히 따로 등록해야 합니다.
더 낮은 임베드 요금제로의 변경은 이제 결제한 기간이 끝날 때 적용됩니다. 이전에는 같은 결제 주기 안의 다운그레이드가 즉시 적용되어 기간 중간에 월 한도가 줄어들었습니다. 업그레이드는 여전히 즉시 적용됩니다.
알 수 없거나 비활성인 코인 슬러그는 이제 iframe 안에 헤더, 사이드바, 푸터까지 갖춘 Bitculator 사이트 전체를 렌더링하는 대신 "Not Found"라는 텍스트만 담긴 응답을 반환합니다.
이제 임베드 키를 만들려면 인증된 이메일 주소가 필요합니다. 암호화폐 지갑으로 만든 계정은 예외입니다. 키 생성은 분당 10회로 제한되며, 기존 키는 계속 작동합니다.
8월 14일부터 도메인 검사 결과가 "등록되지 않음" 결과까지 포함해 5분 동안 캐시되었기 때문에, 방금 추가한 도메인이 최대 5분 동안 계속 403을 반환할 수 있었습니다. 이제는 일치에 성공한 결과만 캐시합니다. 도메인을 제거한 경우에는 반영까지 여전히 최대 5분이 걸릴 수 있습니다.
임베드 콘솔의 키 마지막 사용 시각은 이제 최대 1시간에 한 번만 기록되며, 위젯 로드는 더 이상 Bitculator 자체 사이트 통계에서 방문으로 집계되지 않습니다. 임베드 사용량 집계에는 영향이 없습니다.
좁은 화면에서는 이제 주별 구역과 연간·분기별·월별 구역이 각각 따로 스크롤되므로, 긴 주별 행을 드래그해도 더 짧은 구역이 옆으로 끌려가지 않습니다.
7월 12일부터 16일 사이에 계산기 위젯과 플리퍼에 새 레이아웃과 입력 항목이 적용되었고, 일부 섹션이 제거되었습니다: 플리퍼의 picker, 이자 계산기의 chart와 table, 세금·대출 계산기의 results, 그리고 스테이킹 계산기의 banner, table, chart입니다(스테이킹 계산기는 이제 일별부터 연간까지의 보상을 본문에 바로 나열합니다). 방문자가 저장해 둔 배치는 초기화되었으니, 제거된 섹션을 지정하는 layout 또는 visible 값은 다시 구성하세요.
호스트 페이지는 위젯 창에 {type: 'bitculator-embed-host-growable'}을 보낼 수 있습니다. 그러면 위젯은 선택기를 아래쪽으로 열고, bitculator-embed-resize로 보고하는 높이에 선택기를 포함합니다. 이 메시지가 없으면 선택기는 고정 프레임 안에서 오버레이로 열립니다.
/embed/zoom/{slug}는 이제 연도별로 연간·분기별·월별·주별 수익률을 하나의 그리드에 보여 주며, 평균 행과 승률 요약, 그리고 분기별 "토네이도" 보기를 함께 제공합니다. 기존의 분기별·월별·주별 표를 대체하며, 바깥쪽 카드 테두리는 없습니다.
임베드 콘솔에 이제 현재 결제 기간의 일별 요청 수 차트가 표시됩니다.
/{locale}/pricing/embed는 이제 /{locale}/crypto-tools로 리디렉션되며, 이 페이지에는 결제 기능을 갖춘 요금제 선택기와, 스니펫 빌더 옆에서 위젯을 하나씩 미리 볼 수 있는 위젯 탐색기가 추가되었습니다.
이 레퍼런스가 /{locale}/documentation/embed/v1에서 공개되었습니다. 스니펫 빌더, 인증, 도메인, 쿼터, 요금제, 모든 위젯의 파라미터, 클릭해서 불러오는 미리보기를 제공합니다.
임베드 로드는 이제 자체 요금제, 결제 기간, 카운터를 갖습니다. 처음 이틀 동안은 Data API가 임베드 요금제에서 차감되었습니다. 임베드 키 한도에는 임베드 키만 집계되고, 위젯 URL에 Data API 키나 만료된 키를 넣으면 403을 받으며, 위젯 응답에는 X-Quota-* 헤더가 붙지 않습니다.
유료 임베드 요금제를 해지한 뒤에도 사용량은 기간 중간에 달력 월로 바뀌지 않고, 요금제가 끝날 때까지 결제일 기준 기간으로 계속 집계됩니다. 또한 월말 결제일에도 콘솔의 초기화 날짜가 올바르게 표시됩니다.
임베드 키를 받던 초기 JSON 엔드포인트 /api/v1/prices와 /api/v1/widgets/convert/{from}/{to}는 자체 키만 받는 Data API로 대체되었습니다. 임베드 키는 /user/developer/embed에서 관리합니다.
임베드하는 호스트는 등록된 도메인과 비교하기 전에 소문자로 바뀌고 끝에 붙은 마침표가 제거됩니다.
/{locale}/crypto-tools는 실시간 변환기, 복사할 수 있는 스니펫, Free·Starter·Pro 비교를 갖춘 위젯 페이지가 되었습니다.
embed_key는 있지만 Referer 헤더나 Origin 헤더가 없는 로드는 이제 403을 받습니다. 이전에는 도메인 검사를 건너뛰었습니다. 브라우저의 기본 리퍼러 정책을 유지하고, iframe에 referrerpolicy="no-referrer"를 설정하지 마세요.
월 1,000회 로드라는 키 없는 허용량은 이제 임베드 도메인마다 하나의 풀로 집계되는 대신, 모든 사이트의 모든 키 없는 위젯에 걸쳐 방문자 IP별로 집계됩니다.
모든 위젯 하단의 링크가 4월 4일에 제거되었다가 다시 돌아왔습니다. bitculator.com의 해당 도구로 연결되며, 끌 수 없습니다.
빌더 스니펫이 다시 단순한 <iframe>으로 돌아갔습니다. 4월 3일에 복사한 스니펫에는 래퍼, 별도의 Powered-by 링크, 자동 크기 조절용 <script>도 들어 있었습니다. 같은 시기에 위젯 안의 푸터 링크도 제거되었다가 5월 2일에 다시 돌아왔습니다.
각 도구 페이지에 빌더가 생겼습니다. 임베드 키를 붙여 넣고, 위젯 언어, 레이아웃 템플릿, 표시할 섹션을 고르고, 너비, 높이, 모서리 둥글기, 지연 로드 또는 즉시 로드를 설정하면 스니펫과 실시간 미리보기가 함께 갱신됩니다.
계산기와 플리퍼 위젯은 기본으로 표시할 섹션 ID를 쉼표로 구분한 목록인 ?visible=을 받습니다. 방문자가 브라우저에 저장한 자신의 선택이 우선합니다.
키는 ?embed_key=로 전달하세요. ?api_key=도 별칭으로 계속 작동합니다. 콘솔은 /{locale}/user/developer/embed로 옮겨졌으며, 새 키의 전체 값은 생성 직후 한 번만 표시됩니다.
위젯 페이지가 여전히 X-Frame-Options: SAMEORIGIN과 frame-ancestors 'self'를 담아 전송되었기 때문에, 브라우저가 다른 도메인에서 위젯 표시를 거부했습니다. 이제는 frame-ancestors *를 보내고 X-Frame-Options는 보내지 않습니다.
3월 22일에 도입된 요금제는 자체 결제를 갖춘 임베드 요금제가 되었고, 요금 페이지는 /{locale}/pricing/embed로 옮겨졌습니다. 한도는 바뀌지 않았습니다.
DCA, 손익, 이자, 세금, 대출, 스테이킹, 플리퍼 위젯이 섹션으로 나뉘어, 방문자가 섹션을 드래그하고 크기를 조절하고 정렬할 수 있으며, 이 배치는 방문자의 브라우저에 저장되고 "레이아웃 초기화" 버튼도 제공됩니다. ?layout=은 시작 배치를 지정합니다. 예를 들어 c(stats::cc,settings::cc)에서 c()는 열, r()은 행이며, 섹션은 id:width:alignment로 표기합니다.
위젯은 URL에 담긴 키를 받으며, 키를 사용하는 로드는 콘솔에 등록한 도메인에서 와야 하고 그렇지 않으면 403을 받습니다. 키 없는 로드는 여전히 렌더링됩니다. Free는 월 10,000회 로드, 도메인 1개, 키 2개를, Starter는 50,000회, 3개, 5개를, Pro는 500,000회, 10개, 10개를 허용합니다. 한도를 넘으면 위젯은 사용 한도 페이지(HTTP 429)를 표시합니다.
변환기 위젯에서 비교 표가 빠졌기 때문에, 그 이후로 hideTable은 아무 효과가 없습니다. 이 파라미터는 계속 허용됩니다.
위젯은 높이가 바뀔 때마다 부모 창에 {type: 'bitculator-embed-resize', height}를 보내므로 호스트 스크립트가 iframe 크기를 맞출 수 있으며, 준비될 때까지 로딩 자리 표시자를 보여 줍니다. 모든 도구 페이지에 복사할 수 있는 임베드 스니펫이 추가되었습니다.
출시: 변환기(/{locale}/embed/converter/{from}/{to}), Zoom(/zoom/{slug}), 시가총액 플리퍼(/flip/{entity1}/{entity2}), 그리고 /dca, /profit, /interest, /tax, /loan, /staking 계산기. 모든 위젯은 ?compact=1과 ?theme=dark를 받고, 배경이 투명하며, noindex이고, "Powered by Bitculator" 링크가 붙어 있습니다.
위젯 버전 제거나 한도 축소는 최소 6개월 전에 이곳과 이메일로 공지됩니다 - 지원 종료 정책을 참고하세요.