API 키는 ImageToTable.ai 계정의 자격 증명입니다. 외부 도구가 여러분의 계정으로 작동할 수 있게 해줍니다. Google Sheets 애드온은 로그인 대신 이 키로 연결할 수 있고, v1 API는 모든 호출에서 이 키를 사용합니다. 이 페이지에서는 키가 있는 위치, 교체 방법, 그리고 교체 후 업데이트해야 할 사항을 다룹니다.
API 키 찾는 방법
키는 프로필 페이지의 API 키 섹션에 있습니다. 앱 오른쪽 상단의 계정 메뉴를 열고 프로필을 선택하면 됩니다.
해당 섹션에는 키에 필요한 모든 정보가 표시됩니다:
- 키 자체는 기본적으로 점으로 숨겨져 있습니다. 눈 모양 버튼을 사용하여 표시하고, 복사 버튼을 사용하여 복사할 수 있습니다.
- 키가 이미 있으면 API 키 재생성 버튼이 표시되고, 아직 없으면 API 키 생성 버튼이 표시됩니다.
- 키가 외부 도구용이며 비밀로 유지해야 한다는 짧은 안내와 API 문서 링크가 표시됩니다.
키를 비밀번호처럼 취급하세요. 키는 특정 도구가 아닌 계정에 속하므로 키가 허용되는 모든 곳에서 동일한 값이 작동합니다. 그리고 키를 가진 사람은 누구나 여러분의 계정으로 작동할 수 있습니다. 이것이 섹션에서 비밀로 유지하라고 안내하는 이유입니다.
API 키 재생성
계정에는 API 키가 하나만 저장됩니다. 재생성은 두 번째 키를 추가하는 대신 기존 값을 교체하므로, 활성화된 키는 항상 하나뿐입니다. 확인 단계는 계정의 로그인 방식에 따라 달라집니다. Google 로그인으로 만든 계정에는 여기에 입력할 비밀번호가 없기 때문입니다.
비밀번호로 로그인하는 계정인 경우
API 키 재생성을 선택하면 비밀번호 입력 창이 열립니다. 키가 이미 존재하는 경우, 입력 창은 비밀번호를 묻기 전에 현재 키가 무효화될 것임을 안내합니다. 아직 키가 없는 경우에는 키 생성을 위해 비밀번호를 요청합니다. 계정 비밀번호를 입력하고 확인하여 완료합니다.
비밀번호가 일치하지 않으면 변경되는 사항이 없으며, 페이지에 비밀번호가 올바르지 않다고 표시됩니다.
계정이 Google 로그인에 연결된 경우
Google로 로그인하는 계정의 경우, 확인은 비밀번호 대신 Google 로그인 단계로 진행됩니다. API 키 재생성을 선택하면 본인 확인이라는 제목의 대화 상자가 열리며, Google을 통해 확인하도록 요청합니다. 계정에 이미 키가 있는 경우, 대화 상자는 현재 키가 먼저 무효화될 것임을 안내합니다.
위의 비밀번호 입력 창을 사용할 수 없는 경우 이 경로를 사용하면 됩니다. Google 로그인으로 만든 계정이 이에 해당합니다.
재생성 후: 키를 사용하는 곳을 업데이트하세요
새 키 생성은 즉시 적용됩니다. 이전 값은 그 순간부터 작동이 중지됩니다. 유예 기간이 없으며 두 키를 동시에 활성화할 방법도 없습니다. 이전 키를 계속 보내는 모든 요청은 새 키를 받기 전까지 거부됩니다.
| 키가 사용되는 위치 | 재생성 후 해야 할 작업 |
|---|---|
| Google Sheets 애드온 | 사이드바에서 계정 섹션을 열고 API 키 붙여넣기 상자에 새 키를 붙여넣습니다. 애드온이 대신 Google로 로그인으로 연결된 경우 키를 전혀 사용하지 않으므로 변경할 필요가 없습니다. |
| v1 API | 애플리케이션이 키를 저장하는 모든 곳에서 기존 키를 새 키로 교체하세요. 이전 키로 보낸 호출은 더 이상 인증되지 않으므로, 다음 실행 전에 키를 업데이트하세요. |
재생성은 키만 변경합니다. 파일, 템플릿, 크레딧, 플랜은 그대로 유지되며, 새 키는 이전 키와 동일한 접근 권한을 갖습니다.
자주 묻는 질문
키를 분실했습니다. 다시 조회할 수 있나요?
네, 로그인만 가능하면 됩니다. 프로필 페이지에 현재 키가 항상 표시되며, 눈 모양 버튼을 누르기 전까지는 점으로 가려져 있습니다. 거기서 복사할 수 있습니다. 재사용하는 대신 교체하려면 API 키 재생성을 사용하세요.
키를 여러 개 동시에 보유할 수 있나요?
아니요. 계정에는 API 키가 하나만 저장됩니다. 재생성하면 기존 키가 교체되므로, 새 키가 생성되는 즉시 이전 키는 더 이상 작동하지 않습니다.
Google Sheets 애드온은 항상 키가 필요한가요?
아니요. 애드온은 Google 로그인 또는 API 키 붙여넣기 중 하나로 연결할 수 있습니다. Google 로그인으로 연결하면 사이드바에서 키를 사용하지 않으며, 키를 재생성해도 해당 연결에는 영향을 미치지 않습니다. 키 자체를 사용하는 곳만 업데이트하면 됩니다. Google Sheets 애드온을 참조하세요.
v1 API도 이 키를 사용하나요?
네. 모든 v1 API 호출은 키로 인증되므로, 재생성 후에는 이전 키를 교체해야 합니다. API 액세스에서 API의 대상과 요구 사항을 확인할 수 있으며, 전체 참조 문서는 개발자 문서 사이트에 있습니다.