Question 1

이름이 남성과 여성 모두에게 사용될 수 있는 경우에는 어떻게 되나요?

Accepted Answer

사용하는 API 버전이나 연동 방식에 따라, 엔드포인트는 응답에서 accuracy(정확도) 값 또는 probability(확률) 값을 반환해. accuracy 파라미터는 해당 이름이 남성 또는 여성일 가능성에 대해 우리가 얼마나 확신하는지를 나타내.  
          이 값은 우리 데이터베이스에 있는 레코드 수를 기반으로 계산돼. 예를 들어, 어떤 이름에 대한 샘플이 100개 있고, 그중 96개가 여성, 4개가 남성이라면  
          accuracy는 96%% (또는 0.96 probability)이야. accuracy가 낮다는 건 이 이름이 여러 성별에서 함께 사용되고 있어서  
          특정 성별로 확정하기 어렵다는 의미야.

Question 2

같은 이름이라도 국가에 따라 결과가 달라질 수 있나요?

Accepted Answer

예를 들어, 이탈리아에서는 Andrea가 남성 이름이지만, 독일에서는 여성 이름이고, 미국에서는 남녀 모두에 사용될 수 있어.  
          이런 경우, 우리는 조회 결과에 0에서 100 사이의 accuracy 값(또는 0에서 1 사이의 probability 값)을 제공해.  
          이 값은 우리가 올바른 성별을 감지했다고 확신하는 정도를 알려 줘.
          조회 시 약간의 지리 정보를 함께 보내면 API 결과의 품질을 크게 높일 수 있어. 예를 들어  
          국가 코드, 브라우저 로케일, IP 주소 등을 넘길 수 있어. 쿼리 로컬라이징에 대해서는 우리 API docs에서 더 자세히 확인할 수 있어

Question 3

데이터를 어떻게 수집하나요?

Accepted Answer

최대한 높은 정확도를 제공하기 위해, 우리는 여러 출처의 데이터를 함께 활용하고 있어.  
새로운 이름 레코드의 주요 출처는 공개된 데이터, 정부 데이터, 그리고 수동으로 추가/수정한 데이터야.  
이름이 어떤 출처에서 왔는지에 따라, 우리 목록에 추가되기 전에 두 번째 출처로 검증을 거쳐야 할 수도 있어.

예를 들어, 공개된 데이터에서 새로운 이름을 추가하는 경우, 최종적으로 데이터베이스에 반영되기 전에 수동 확인과 같은 추가 검증 절차를 거치게 돼.

지원되는 국가 목록은 here에서 확인할 수 있어.

Question 4

이름 데이터는 얼마나 자주 업데이트돼?

Accepted Answer

우리는 국가별 공개 데이터의 가용성을 기준으로 데이터를 정기적으로 업데이트하고 있어.  
대부분의 서구 국가 데이터는 1년에 한 번씩 갱신되고, 이름의 성별 분포도 시간이 지나면서 달라질 수 있어.

예를 들어, 1970년대에 거의 여성에게만 쓰이던 이름이 수십 년 뒤에는 주로 남성에게 사용되는 이름이 될 수도 있어.  
그래서 미국을 포함한 여러 국가의 출생 데이터도 함께 활용해 결과를 더욱 풍부하게 만들고 있어.  
우리 모델은 이런 여러 요소들을 가능한 한 모두 반영하도록 설계되어 있어.

반환되는 정확도(accuracy) 값은 실제 인구에서의 사용 양상을 최대한 잘 반영할 수 있도록 정기적으로 조정돼.  
이 값은 지난 수십 년간의 데이터를 기반으로 합리적인 평가를 제공하고, 향후 변동 가능성도 어느 정도 표현해 줘.  
우리는 대략 최근 40년 정도의 데이터를 중점적으로 살펴보고 있어.

오늘 한 쿼리를 1년 뒤에 다시 실행하면, 결과가 달라질 수도 있어.  
우리 시스템이 오래된 데이터를 제거하고, 그 사이에 새로운 데이터를 추가했기 때문일 수 있어.

새로운 데이터가 추가될 때마다, 우리는 반드시 이른바 통합 테스트(integration tests)를 수행해.  
이 과정에서 API를 사전에 검증된 데이터 세트에 대해 다시 테스트해 품질을 확인해.  
이 테스트용 데이터 세트는 더 넓은 범위를 커버할 수 있도록 이름과 테스트 케이스를 계속 추가하며 확장하고 있어.

Question 5

AI를 어떻게 활용하고 있어?

Accepted Answer

인공지능(AI)은 매일 우리 데이터베이스와 API 결과의 품질을 높이는 데 활용되고 있어.  
AI의 도움으로 새로운 이름 데이터를 빠르고 정확하게 추가할 수 있어서, 언제나 최신 정보가 유지되도록 관리하고 있어.

또한 AI는 API 결과의 전반적인 품질을 개선하는 데에도 핵심적인 역할을 해.  
머신러닝 알고리즘을 활용해 데이터를 더 깊이 분석하고 패턴을 찾아냄으로써, 너에게 더 정확하고 관련성 높은 결과를 제공할 수 있어.

Question 6

API를 구현할 때 도와줄 수 있는 지원이 있나요?

Accepted Answer

네, 모든 고객에게 이메일 지원을 제공해. contact gender-api.com로 이메일을 보내줘. 최대한 빨리 답장할게. 코딩 예제는 here에서 확인할 수도 있어.

다만, 모든 프로그래밍 언어나 모든 사용 사례에 대해 직접 도와줄 수는 없다는 점을 이해해 줘. 대부분의 경우, 앱에서 표준 REST 클라이언트를 사용해 우리 API를 호출할 수 있어.

또한 많은 라이브러리가 OpenAPI 정의 파일 가져오기를 지원해. 우리 openapi.yml 정의 파일은 here에서 다운로드할 수 있어.

Question 7

정확도를 아주 높게 맞춰야 하면 어떻게 하나요?

Accepted Answer

언어와 이름은 시간이 지나면서 유동적으로 변합니다. 고객마다 보유한 데이터 세트의 품질, 범위, 출처 역시 크게 다를 수 있습니다.  
따라서 우리 API에서 받는 모든 결과가 항상 100% 정확하고, 너의 데이터 풀과 완벽히 일치한다고 보장할 수는 없습니다.  

하지만 우리는 언제나 가능한 한 최고의 결과를 제공하기 위해 최선을 다하고 있으며, 알고리즘을 꾸준히 개선하고 업데이트하고 있어. 또한 새로운 데이터도 매우 자주 추가하고 있어.  

업데이트에 대해 더 알고 싶다면 here에서 확인해 줘. 서비스가 기대에 미치지 못하는 드문 경우에도, 걱정하지 마. 우리는 간단한 14-day money-back guarantee(14일 환불 보장)을 제공해.

물론, 우리 서비스를 완전히 무료로 테스트해 볼 수도 있어. here에서 가입하면, 매달 100 요청을 every month 무료로 받아볼 수 있어.

이름을 조회하면, 사용하는 API 버전에 따라 응답에 정확도(accuracy) 또는 확률(probability) 값이 함께 반환돼.

accuracy 파라미터는 우리가 그 이름이 남성 이름인지 여성 이름인지 얼마나 확신하는지를 나타내.
The value is calculated by the number of records for this in our database.

사용 사례는 매우 다양하기 때문에, 우리는 특정 정확도 수준에 대한 일반적인 권장 값을 제공하지 않아. 어떤 결과와 정확도 수준을 받아들일지는, 네 사용 목적에 따라 직접 결정하면 돼.

정확도가 최소 99%여도 결과가 틀릴 가능성은 여전히 있어.
하지만 일반적으로 95% 이상의 값이면 대부분의 사용 사례에 잘 들어맞아

Question 8

데이터베이스에 이름이 얼마나 저장되어 있나요?

Accepted Answer

우리 데이터베이스에는 6,084,389개의 검증된 이름이 191개 국가에서 수집되어 있습니다. 전 세계적으로는 6,196,452개의 고유한 이름을 보유하고 있어.
평균적으로 한 달에 약 10,000,000개의 데이터를 분석해 결과의 품질을 계속 향상시키고 있어.

Question 9

어떤 국가들이 지원되나요?

Accepted Answer

이 API는 191개 국가를 완벽하게 지원해. ‘완전 지원’이란, 각 해당 국가에서 최소 개 이상의 이름을 수집했다는 뜻이야.
하지만 대부분의 국가에서는 그보다 훨씬 더 큰 데이터셋을 보유하고 있어. 아래 표를 보면 각 국가별로 우리가 얼마나 많은 이름을
지원하는지 자세히 확인할 수 있어. 만약 우리가 특정 국가에 대해 충분한 지원을 제공하지 못하더라도,
전체 데이터셋을 기준으로 이름을 조회해서 충분히 유의미한 결과를 얻을 수 있어.

Question 10

아랍어 이름도 지원하나요?

Accepted Answer

응, 우리 API는 아랍어 이름도 지원해. 아랍어 알파벳 문자로 된 이름도 그대로 사용할 수 있어.
아랍어는 오른쪽에서 왼쪽으로 쓰는 필기체 스타일의 문자 체계이며, 28개의 문자로 구성되어 있어.
예를 들어 "عبد ال" 이라는 이름으로 조회하면 다음과 같은 결과를 받게 돼: "gender": "male", "accuracy": 100.
이 예제에서 아랍어 이름 "عبد ال"는 URL 인코딩되어 있으며, 실제 요청 URL은 다음과 같아: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
지원되는 국가의 전체 목록은 here에서 확인할 수 있어

Question 11

한 번의 요청으로 여러 이름을 조회할 수 있나요?

Accepted Answer

네, 물론 가능합니다. 한 번에 최대 100개의 이름까지 조회할 수 있어.

자세한 내용은 API Docs를 확인해 줘.

Question 12

이메일 API에 대해 들었어. 정확히 뭐야?

Accepted Answer

우리의 이메일 API는 이메일 주소에서 이름을 추출하고, 해당 주소에 맞는 올바른 성별 정보를 제공할 수 있어. 이렇게 하면 이메일 발송 시 적절한 호칭을 사용해 개인화된 메일을 보낼 수 있어.

예를 들어, "marie.johnson@gmail.com"이라는 이메일 주소에서 API는 이름 "Marie"를 추출하고, 그 이름의 성별이 "female"임을 판별해 줘.

자세한 내용은 API Docs를 참고해 줘.

Question 13

데이터가 아주 많아요. CSV 파일을 한 번에 업로드해서 처리할 수 있나요?

Accepted Answer

등록한 사용자라면, 이름 열이 포함된 어떤 CSV 파일이든 업로드할 수 있어.  
더 정확한 결과를 얻으려면 선택 사항으로 국가 열을 데이터셋에 추가할 수도 있어. 열 이름을 반드시 특정 형식으로 지정할 필요는 없고, 어떤 열이 이름인지, 어떤 열이 국가인지 등을 선택할 수 있도록 도와주는 어시스턴트가 단계별로 안내해 줄 거야.

이 기능은 your account 안에서 사용할 수 있어. 처리된 레코드는 일반 요청과 동일하게 과금되므로, 매달 최대 100개 항목이 들어 있는 CSV 파일을 무료로 업로드할 수 있어. CSV bulk upload 기능을 사용하려면 Gender-API.com 계정이 필요해.  
데이터 보호를 위해, 업로드된 파일은 1년 후 자동으로 삭제돼.

Question 14

CSV 파일은 어떻게 형식을 맞춰야 하나요?

Accepted Answer

Windows, MacOS, Linux에서 생성된 CSV 파일을 모두 지원해.  
또한 구분 기호로는 ";", "," 또는 탭(tab)을 사용할 수 있어. 필드 감싸기(enclosure) 문자는 반드시 " 이어야 해.  
최대 10,000,000개의 행과 301MB까지의 여러 줄(multi-line) CSV 파일 업로드를 지원해.  
가장 좋은 결과를 얻으려면 구분 기호로 세미콜론을 사용한 UTF-8 형식의 CSV 파일을 추천해.  
그 외에 추가적인 임의의 열이 포함되어 있어도 괜찮고, 이 열들도 결과 파일에 그대로 포함돼.  
파일에는 반드시 이름(First Name)만 들어 있는 열 하나 이상 또는 전체 이름(Full Name)이 들어 있는 열 하나 이상이 있어야 해.  
샘플 파일을 다운로드하려면 here를 클릭해 줘. CSV 파일을 업로드하려면 먼저 Gender-API.com account를 만들어야 해.

Question 15

엑셀 파일도 업로드할 수 있어?

Accepted Answer

최대 300,000행까지의 Excel 파일을 업로드할 수 있어. 그보다 큰 데이터셋은 CSV 업로드를 사용해 줘.  
단일 시트로 된 .xlsx 파일을 지원해. 여러 시트가 있는 파일을 업로드하면 첫 번째 시트만 처리돼.  
시트의 첫 번째 행에는 반드시 열 이름이 들어 있어야 해. 파일에는 최소한 이름(First Name)이 들어 있는 열 하나 이상이 있어야 하고, 국가(country) 열은 선택 사항이야.  
데이터 보호를 위해 업로드된 파일은 1년 후 자동으로 삭제돼. 샘플 파일 다운로드. 예시:

Question 16

버그를 발견했어요. 어떻게 해야 하나요?

Accepted Answer

도와줘서 정말 고마워. contact gender-api.com로 이메일을 보내 주면  
가능한 한 빨리 문제를 수정할 수 있도록 할게.

Question 17

Gender-API는 GDPR(일반 데이터 보호 규정)을 준수하나요?

Accepted Answer

모든 Gender-API.com 서비스는 GDPR을 100% 준수합니다.  
우리는 GDPR 의무를 충족할 수 있도록 데이터 처리 계약서(DPA)를 제공하고 있어.

이 계약서는 내 계정에서 here에서 요청할 수 있어.  
또한 샘플 계약서는 here에서 다운로드할 수 있어.  
그리고 우리가 너의 데이터를 어떻게 보호하는지에 대한 더 자세한 정보는 here에서 확인할 수 있어.

Question 18

프로그래밍 언어별로 사용할 수 있는 라이브러리를 제공하나요?

Accepted Answer

우리 API는 구조가 아주 단순해서, jQuery 플러그인을 제외하고는 별도의 언어별 라이브러리를 제공하지 않아.  
대부분의 프로그래밍 언어는 기본적으로 JSON 파서를 지원하고, 그렇지 않은 언어들도 이미 외부 라이브러리가 많이 있어.

API를 바로 써보고 싶다면, 아래의 코딩 예제를 참고해 시작해 봐

Question 19

요청은 어떻게 계산되나요?

Accepted Answer

Every account will be recharged to 100 requests on the first day of every month if there are less than this number of requests left.
                Only if a result is found, the request will be counted. One name lookup will be counted as one request. 
                If multiple names are requested in one query, each name will be counted as a single request.

Question 20

API 키는 어디에서 확인하고 관리할 수 있나요?

Accepted Answer

Gender-API.com 계정을 만들면, 처음 가입할 때 기본 API 키가 자동으로 생성돼. 이 API 키는 내 계정 개요 페이지 맨 아래에서 확인할 수 있어.  
만약 이 키를 폐기하고 새로 만들고 싶다면, "Revoke and Regenerate" 버튼을 클릭해 줘.  
그러면 기존 API 키는 더 이상 유효하지 않게 되고, 새로운 키가 발급돼. 예전 토큰을 사용하던 모든 애플리케이션은, 새 API 키로 코드를 교체하기 전까지는 우리 API에 더 이상 접근할 수 없게 돼. [apiKeyImage] 

원한다면 API 키를 여러 개 생성할 수도 있어. 예를 들어, 우리 API를 여러 개의 애플리케이션에 각각 따로 연동해서 사용하려고 할 때 아주 유용해. 키별로 사용된 요청 수는 따로 구분되지 않습니다. 모든 요청은 합산되어 함께 계산돼. 여러 개의 API 키를 관리하거나 새로 만들려면 계정 메뉴에서 "Settings" 버튼을 클릭한 뒤 "API Keys"를 선택해.

[multipleKeysImage] "Create New Key" 버튼을 클릭하면 새로운 API 키를 생성할 수 있어. 각 토큰에 이름을 붙여 두면, 나중에 이 키가 어디에서 사용되고 있는지 더 쉽게 알아볼 수 있어. 이 이름은 언제든지 변경할 수 있어. 또한, 우리의 일부 위젯은 여기에서 자동으로 키를 생성하기도 해. 예를 들어, 계정에서 "Quick Lookup Widget"을 사용하면, 시스템이 미리 키를 하나 만들어 두고, 이 위젯이 그 토큰을 사용해 우리의 API를 호출하게 돼.

추가로, 서드파티 앱들도 연결되는 순간 여기에서 자체 키를 생성해. 각 토큰은 "x"를 클릭하는 것만으로 언제든지 사용 취소(폐기)할 수 있어. 한 번 취소된 후에는 연결된 애플리케이션이 더 이상 우리의 API에 접근할 수 없어.

Question 21

내 계정을 여러 사람이 함께 써도 될까?

Accepted Answer

계정 하나로 최대 50명까지 동료나 프로젝트에 참여하는 사람들과 함께 쓸 수 있어. 팀을 관리하려면 계정에 로그인한 뒤, 계정 메뉴에서  
"Settings" => "Manage Your Team"를 클릭해 줘.  

이 페이지에서 "Invite a new member" 버튼을 눌러 이메일로 팀 초대를 보낼 수 있어. 초대할 때는 두 가지 계정 유형 중에서 선택할 수 있어:

A) 사용자(User)  
- API 키를 조회, 생성, 수정, 삭제  
- CSV 및 Excel 파일 업로드 및 genderize 기능 사용  
- 모든 API 엔드포인트에 접근  
- 요청량(requests) 구매  
- 서드파티 앱 연결  

B) 관리자(Administrator)  
- 사용자 권한으로 할 수 있는 모든 작업  
- 계정 설정 및 청구지 주소 변경  
- 데이터 처리 계약(Data Processing Agreement) 생성 및 조회  
- 팀 구성원 초대, 수정 및 삭제

Question 22

내 계정을 이중 인증으로 보호할 수 있나요?

Accepted Answer

계정을 더 안전하게 보호하려면 2단계 인증을 활성화해 줘.  
이 추가 보안 기능을 켜려면 계정에 로그인한 뒤, 계정 메뉴에서 "Settings" =>  
        "Change Password / 2FA"를 클릭해. 휴대폰에 인증 앱이 설치되어 있는지 먼저 확인해 줘. Authy(App Store, Play Store)나 Google Authenticator(App Store, Play Store) 같은 앱을 사용하는 것을 추천해.

그다음 "Enable Now" 버튼을 눌러서 화면에 나오는 안내를 따라 진행해 줘.  
여기에서 여러 기기를 추가할 수도 있어서, 예를 들어 기기를 분실했을 때도 계정에 계속 접속할 수 있도록 대비할 수 있어.

2단계 인증을 활성화한 후에는, 로그인할 때마다 휴대폰의 인증 앱에서 생성된 코드를 입력해야 정상적으로 로그인할 수 있어.

Question 23

2단계 인증을 켠 상태에서도 서드파티 앱을 사용할 수 있나요?

Accepted Answer

일부 연동 기능이나 서드파티 앱은 2단계 인증이 활성화된 상태에서도 문제 없이 작동해.  
하지만 다른 것들은 2단계 인증 없이만 연결이 가능할 수도 있어.

만약 Gender-API.com 계정 정보를 사용해서 어떤 앱에 로그인할 때 문제가 생기면, 먼저 Gender-API 계정에 직접 로그인한 다음, 계정 메뉴에서 "Settings" => "Change Password / 2FA"를 클릭해.  
그다음 "Two-Step Verification" 탭을 선택하고, "Third-party app access"를 "Not restricted"로 설정해 줘.

주의: 이 설정은 2단계 인증이 이미 활성화되어 있어야만 변경할 수 있어.

Question 24

유료 계정과 무료 계정의 차이는 뭐야?

Accepted Answer

두 계정 유형은 모두 동일한 기능을 제공해. 모든 API 엔드포인트를 어떤 계정으로 사용하든지, 같은 결과를 받게 될 거야.  
무료 계정은 월별 요청 가능 횟수에 제한이 있어. 회원가입을 하면 바로 100건의 요청을 무료로 사용할 수 있어. 매달 1일이 되면 시스템이 이 숫자를 초기화해서, 무료 요청 횟수가 다시 채워져.  

계정은 하나만 만들어 줘. 더 많은 요청이 필요하다면 언제든지 유료 플랜으로 업그레이드할 수 있어. 업그레이드는 here에서 가능해.

Question 25

모든 기기에서 어떻게 로그아웃할 수 있나요?

Accepted Answer

계정에서 로그아웃 버튼을 누르면, 현재 사용 중인 기기에서만 로그아웃돼.  
계정과 데이터를 안전하게 보호하려면, 필요할 때는 모든 기기에서 완전히 로그아웃하는 게 중요해. 아래 안내를 따라 우리 API 플랫폼에서 모든 기기에서 로그아웃해 줘.

로그인한 상태에서 here를 클릭하면 모든 기기에서 로그아웃할 수 있어.  
또한 비밀번호를 변경하거나 2단계 인증 설정을 수정하면, 현재 IP 주소와 일치하지 않는 모든 기기에서 자동으로 로그아웃돼. 이렇게 하면 계정 보안이 한층 더 강화돼.

각 팀 구성원마다 separate accounts를 만들어 사용하는 것을 추천해. 이렇게 하면 보안이 강화될 뿐 아니라 팀 협업도 훨씬 편해져.

추가로, 계정 보안을 더욱 강화하기 위해 꼭 2단계 인증(2FA)을 활성화하길 권장해.  
2FA는 로그인 과정에 한 단계 더 추가해서, 허가받지 않은 사람이 계정에 접근하기 훨씬 어렵게 만들어 줘.

Question 26

구독과 1회 결제는 뭐가 다른가요?

Accepted Answer

패키지를 구매할 때, 한 번만 결제하는 방식과 구독 방식 중에서 선택할 수 있어.

서비스를 정기적으로 사용할 계획이라면 구독을 추천해. 항상 계정에 충분한 요청 수가 남아 있도록 관리해 줄게.  
구독으로 구매한 요청 수는 1개월 동안 사용할 수 있어. 구독이 활성화되어 있으면, 매달 선택한 요청 수만큼 계정이 자동으로 충전돼.

예를 들어, 25,000건 요청 패키지를 구독 중이고 그중 21,500건을 사용했다면, 한 달 후에 계정이 다시 25,000건으로 채워져.

일회성 패키지는 특정 작업에 한 번 사용하는 용도로 적합하며, 구매일로부터 1년 동안 사용할 수 있어.  
예를 들어, Excel이나 CSV 파일을 한 번 처리하려는 경우에는 일회성 구매를 추천해.

일회성 구매는 자동으로 갱신되지 않아. 요청 수가 떨어지지 않도록 직접 확인해야 해.

두 패키지 유형은 언제든지 purchase page에서 변경할 수 있어.

[difference]
정확히 이해하고 있지 않거나 먼저 우리 지원팀과 상의하지 않았다면, 두 가지 구매 유형을 섞어서 사용하지 않는 것이 좋아.  
정기 구독 중에 일회성 패키지를 추가로 구매하면, 구독으로 인한 자동 충전이 제대로 이루어지지 않을 수 있어.  
예를 들어, 일회성 구매로 남아 있는 요청 수가 월 구독으로 채워질 예정인 요청 수보다 더 많을 경우, 구독이 요청 수를 다시 채우지 못할 수 있어.

Question 27

거주지 증명서가 필요해요. 이런 증명서를 발급해 줄 수 있나요?

Accepted Answer

우리 회사에서 발행한 거주지 증명서가 필요하다면, support로 연락해서 요청해 줘.  
이 증명서는 회사별로 개별 발급 요청이 필요해.  
요청 시에는 회사의 전체 주소, 거주 국가, 그리고 가능하다면 세금 번호를 함께 보내줘.  

거주지 증명서는 우리 세무 부서에서 서명해야 해.  
보통 서명된 양식을 받는 데 2–3주 정도 걸리며, 그 후에 디지털 스캔본으로 제공해 줄 수 있어.

[certificate-of-residence]

Question 28

패키지 / 추가 요청은 어떻게 구매할 수 있나요?

Accepted Answer

구독 플랜 또는 일회성 결제 중에서 here에서 선택할 수 있어.  

대용량 CSV 파일을 한 번에 처리하거나, 요청을 비정기적으로 사용하고 싶다면 일회성 결제를 추천해.  
필요한 요청 수만큼 언제든지 계정에 충전할 수 있어.  
일회성 결제로 구매한 요청은 1년 동안 사용할 수 있어.  

정기 구독 플랜을 선택하면, 매달 계정이 선택한 요청 수까지 자동으로 다시 채워져.  
구독은 언제든지 변경하거나 취소할 수 있어.

Question 29

구독은 어떻게 취소할 수 있나요?

Accepted Answer

언제든지 here에서 구독을 변경하거나 취소할 수 있어. 정기 결제를 중단하고 싶다면 "Cancel this subscription" 버튼을 클릭해 줘.

Question 30

일반적인 API 응답 속도는 어느 정도인가요?

Accepted Answer

우리의 API는 고성능으로 설계되어 있고, 보통 10~200밀리초 내에 응답해. 
        응답 속도는 사용자의 위치, 네트워크 상태, 요청의 복잡도에 따라 조금씩 달라질 수 있어. 
        여러 이름을 한 번에 보내는 배치 요청의 경우, 요청 개수에 비례해서 응답 시간이 늘어나. 우리는 전 세계에 CDN과 최적화된 인프라를 구축해 전 세계 어디서나 낮은 지연 시간을 제공하고 있어. 응답 속도가 계속 느리게 느껴진다면 support team에 문의해 줘.

Question 31

사용량 제한이나 요청 제약이 있나요?

Accepted Answer

모든 사용자가 안정적으로 서비스를 이용할 수 있도록 공정 사용 정책에 따른 요청 제한을 적용하고 있어. 
        무료 계정은 시간당 최대 100건, 하루 최대 500건까지 요청할 수 있어. 유료 계정은 더 높은 제한이 적용되며, 
        분당 1500건까지 요청 가능하고, 크레딧이 남아 있는 한 일별 제한은 없어. 
        특정 사용 사례를 위해 더 높은 요청 한도가 필요하다면, 맞춤형 플랜 논의를 위해 contact us로 연락해 줘. 
        한 번에 최대 100개의 이름을 보낼 수 있는 배치 요청은 각각이 개별 요청으로 계산되지만 훨씬 더 효율적이야.

Question 32

API 가동 시간은 얼마나 보장해 주나요?

Accepted Answer

모든 유료 플랜에서 99.9% API 가동 시간을 보장해. 우리의 인프라는 자동 장애 조치(failover)와 로드 밸런싱이 적용된 엔터프라이즈급 
        서버에서 운영되고 있어. 24/7로 시스템을 지속 모니터링하고, 문제가 발생하면 자동 알림이 동작하도록 설정돼 있어.
        또한 엔터프라이즈 고객을 위해 서비스 수준 협약(SLA)도 제공하고 있어. 아주 드물게 장시간 장애가 발생할 경우, 
        유료 고객은 SLA 조건에 따라 자동으로 서비스 크레딧을 받게 돼.

Question 33

API 응답 형식은 무엇을 사용하나요?

Accepted Answer

우리 API는 기본적으로 JSON 형식으로 응답을 반환해. JSON은 대부분의 최신 
        프로그래밍 언어에서 널리 지원되고 있어. 각 응답에는 요청한 이름, 감지된 gender, 정확도/확률 값, 
        그리고 추가 메타데이터가 포함돼. 예를 들어: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"} 와 같아. 
        자세한 응답 스키마는 API documentation 에서 확인할 수 있고, 
        자동 클라이언트 생성을 위한 OpenAPI 스펙도 내려받을 수 있어.

Question 34

API 오류는 어떻게 처리해야 하나요?

Accepted Answer

우리 API는 성공 또는 실패를 나타내기 위해 표준 HTTP 상태 코드를 사용해. 
        200은 성공, 401은 잘못된 API 키, 429는 rate limit 초과, 500은 서버 오류를 의미해. 
        각 오류 응답에는 디버깅을 쉽게 할 수 있도록 설명 메시지와 오류 코드가 함께 포함돼. 
        rate limit 오류에 대해서는 지수 백오프(exponential backoff)를 구현하고, 가능하다면 성공한 응답은 캐싱할 것을 권장해. 
        지속적인 오류가 발생한다면 API documentation 를 확인하거나 support 로 문의해 줘. 
        모든 오류는 문제 해결을 위해 로그로 기록되고 있어.

Question 35

API 버전 관리는 어떻게 하나요?

Accepted Answer

현재 우리는 두 가지 API 버전을 운영하고 있어: V1과 V2야.  
V2는 최신 버전으로, 확률 값 제공, 더 많은 국가 지원, 향상된 정확도 등 기능이 크게 강화됐어.  
V1도 하위 호환성을 위해 계속 제공되지만, 새로운 연동을 할 때는 V2로의 마이그레이션을 권장해.

모든 API 엔드포인트의 URL 경로에는 버전이 포함돼 있어 (예: /v2/name).  
이전 API 버전들도 계속 정상적으로 동작하도록 보장하고 있어.  
마이그레이션 가이드는 우리의 API documentation에서 확인할 수 있어.  
호환성이 깨지는 변경 사항은 항상 충분한 사전 공지를 통해 안내할게.

Question 36

이름 변형이나 별칭(닉네임)은 어떻게 처리해?

Accepted Answer

우리 데이터베이스에는 일반적인 이름 변형, 애칭, 줄임 이름이 모두 포함돼 있어. 예를 들어  
"Bob" 은 "Robert" 의 변형으로, "Liz" 는 "Elizabeth" 의 변형으로 인식돼.  
하지만 가능한 경우에는 항상 전체 이름으로 조회하는 걸 추천해. 그래야 가장 정확한 결과를 얻을 수 있어.

우리 AI 시스템은 방대한 데이터셋을 기반으로 새로운 이름 변형을 계속해서 학습하고 있어. 만약 인식되지 않는 별명이나 애칭을 발견하면 let us know 로 알려줘. 곧바로 데이터베이스에 추가할게.

"Juan" 과 "John" 처럼 지역마다 다른 이름 변형은 국가별 전용 데이터셋을 통해 따로 처리하고 있어.

Question 37

API에서 특수 문자나 악센트가 들어간 이름도 지원하나요?

Accepted Answer

네! 우리의 API는 악센트 문자(é, ñ, ü)는 물론, 움라우트, 발음 구별 기호, 그리고 아랍어·키릴 문자·중국어 등 비(非)라틴 문자까지 포함한 유니코드 문자를 완벽하게 지원해.  
API 요청에 포함되는 이름은 UTF-8로 인코딩되어야 해. 예를 들어 "François", "José", "Müller", "Søren" 같은 이름도 모두 정확하게 처리돼.  

대부분의 HTTP 클라이언트는 URL 인코딩을 자동으로 처리하지만, 특수 문자가 있을 경우 올바르게 인코딩되었는지 꼭 확인해 줘.  
우리 데이터베이스에는 전 세계 주요 문자 체계를 아우르는 191개 국가의 이름 데이터가 포함돼 있어. 더 자세한 내용은 API 문서에서 확인해 줘.

Question 38

어떤 데이터 소스를 사용하나요?

Accepted Answer

우리는 여러 신뢰도 높은 데이터 소스를 결합해 최대한 정확한 결과를 제공해. 여기에는 다음이 포함돼:  
정부 인구조사 및 출생 기록(여러 국가), 공개 이름 데이터베이스,  
소셜 미디어 및 프로페셔널 네트워크(익명 처리 및 GDPR 준수),  
과거 이름 기록, 그리고 데이터 팀의 수동 검증 작업까지 모두 포함돼.

모든 데이터 소스는 꼼꼼하게 검증하고 서로 교차 확인해 사용해. 사용할 수 있는 경우 공식 정부 데이터를 최우선으로 반영하고 있어.  
또한, 우리의 AI 모델이 패턴을 분석하고 각 데이터 소스 간의 일관성을 확인하는 데 도움을 줘.

지원되는 국가의 전체 목록은 here에서 확인할 수 있어.  
새로운 공식 데이터가 공개될 때마다 데이터베이스를 정기적으로 업데이트하고 있어.

Question 39

개인정보와 데이터 보호는 어떻게 보장하나요?

Accepted Answer

우리는 개인정보 보호를 무엇보다 중요하게 생각하며, GDPR, CCPA를 포함한 국제 데이터 보호 규정을 엄격히 준수하고 있어.  
질의에 사용한 이름은 서비스 운영에 필요한 최소한의 로그 목적 외에는 저장하지 않아.

모든 API 통신은 HTTPS/TLS로 암호화돼. 엔터프라이즈 고객을 위해 Data Processing Agreements도 제공하고 있어.  
업로드한 CSV/Excel 파일은 1년이 지나면 자동으로 삭제돼. 고객 데이터를 제3자에게 판매하거나 공유하는 일은 절대 없어.

서버는 보안이 갖춰진 유럽 데이터 센터에 위치해 있어. 자세한 내용은 전체 privacy policy에서 확인할 수 있어.  
정기적인 보안 감사로 항상 규정을 준수하고 있는지 점검하고 있어.

Question 40

결제에 대한 인보이스와 영수증을 받을 수 있나요?

Accepted Answer

네, 모든 결제에 대한 인보이스(세금계산서 겸용 영수증)는 자동으로 생성되며, account dashboard에서 확인할 수 있어.  
언제든지 PDF 인보이스를 다운로드할 수 있고, 등록된 이메일 주소로도 함께 발송돼.

인보이스에는 회계 처리에 필요한 모든 정보가 포함되어 있으며, 필요한 경우 VAT 정보도 함께 제공돼.  
청구 정보와 회사 정보는 언제든지 수정할 수 있어서, 인보이스에 항상 최신 정보가 반영되도록 할 수 있어.

이전 인보이스가 필요하거나 맞춤 인보이스가 필요한 경우, contact support로 문의해 줘.

Question 41

환불 정책은 어떻게 되나요?

Accepted Answer

처음 구매하신 경우, 14일 이내라면 단순 변심이라도 100% 환불해 드리는 간편한 14일 환불 보장 제도를 운영하고 있어. 
        서비스가 기대에 미치지 못한다고 느낀다면, 첫 14일 안에 문의만 주면 이유를 묻지 않고 전액 환불해 줄게. 
        구독 결제는 언제든지 해지할 수 있고, 해지 후에는 더 이상 결제가 이루어지지 않아. 일회성으로 구매한 미사용 크레딧은 
        1년 동안 유효해. 또한 기술적 문제나 서비스 장애가 있는 경우에는 개별 상황을 검토해 환불을 도와드려. 
        자세한 내용은 전체 cancellation policy를 확인하거나, 궁금한 점이 있다면 contact support로 문의해 줘.

Question 42

어떤 써드파티 연동을 제공하나요?

Accepted Answer

Zapier, Make(구 Integromat), 
        Google Sheets, Microsoft Excel, Salesforce, HubSpot 및 다양한 CRM 시스템 등 인기 있는 플랫폼·툴과 연동을 제공해. 우리의 API는 
        REST API나 웹훅을 지원하는 모든 플랫폼과 함께 사용할 수 있어. 주요 플랫폼에 대해서는 바로 사용할 수 있는 커넥터와 자세한 연동 가이드를 제공하고 있어. 
        별도 연동 없이 한 번만 데이터를 처리하고 싶다면 CSV upload feature를 이용할 수도 있어. 
        맞춤 연동이나 특정 플랫폼에 대한 지원이 필요하다면 documentation를 확인하거나 support로 문의해 줘.

자주 묻는 질문