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 ドキュメント をご覧ください

Question 3

データはどのように集めているのですか？

Accepted Answer

可能な限り高い精度を実現するために、Gender-API.com では複数のデータソースを組み合わせています。新しい名前の主な情報源は、公開されているデータ、各国政府のデータ、そして手動での追加や修正です。
新しい名前の情報源によっては、当社のリストに追加する前に、別の情報源で再確認する必要があります。
たとえば、公開データから名前を追加する場合は、人の目による確認など、2回目の検証を行ってから最終的にデータベースに登録しています。

対応している国の一覧は こちら でご確認いただけます。

Question 4

名前データはどのくらいの頻度で更新していますか？

Accepted Answer

当社は、各国の状況や公開データの入手状況に応じて、データを定期的に更新しています。
多くの欧米諸国については、年に一度のペースで更新を行っています。
また、名前の男女比は時代とともに変化することがあります。
たとえば、1970年代には女性だけに使われていた名前が、数十年後には主に男性に使われるようになる、といったケースもあります。

そのため、アメリカなど一部の国では出生データも活用し、結果をより充実させています。
当社のモデルは、こうした要素をできるだけ幅広く考慮するよう設計されています。

返却される精度（accuracy）の値も、実際の人口における名前の使われ方をより正確に反映するよう、定期的に調整しています。
この値は、過去数十年分のデータに基づいた妥当な評価を提供することを目的としており、その中には一定の変動の可能性も含まれます。
当社はおおよそ過去40年分のデータを参照しています。

同じ名前で今日クエリを実行し、1年後にもう一度まったく同じクエリを実行した場合、結果が異なることがあります。
これは、古いデータが削除され、新しいデータが追加される可能性があるためです。

新しいデータが追加されるたびに、必ずインテグレーションテストと呼ばれる検証を実施しています。
このプロセスでは、あらかじめ検証済みのデータセットに対して API をテストし、品質を確認します。
この検証用データセットは、可能な限り広いカバレッジを実現するために、名前やテストケースを継続的に追加しながら拡張しています。

Question 5

AI はどのように活用しているのですか？

Accepted Answer

人工知能（AI）は、当社のデータベースと API 結果の品質を日々向上させるために活用されています。AI の力によって、新しい名前データを効率的かつ正確に追加できるため、常に最新で信頼できる情報を提供できるようになっています。

さらに、AI は API 結果そのものの精度向上にも重要な役割を果たしています。機械学習アルゴリズムを活用することで、データをより深く分析し、パターンを見つけ出し、ご利用のみなさまに、これまで以上に正確で関連性の高い結果を返すことができます。

Question 6

API の実装を手伝ってもらえますか？

Accepted Answer

はい、すべてのお客様にメールサポートを提供しています。contact gender-api.com までメールでお問い合わせください。できるだけ早く返信します。コード例は こちら にも掲載しています。

ただし、すべてのプログラミング言語やユースケースを個別にサポートすることはできない点にご注意ください。多くの場合、アプリ内で標準的な REST クライアントを使って、当社の API にリクエストを送信できます。

また、多くのライブラリは OpenAPI 定義ファイルのインポートにも対応しています。当社の openapi.yml 定義ファイルは こちら からダウンロードできます。

Question 7

高い精度が必要な場合はどうすればよいですか？

Accepted Answer

言語や名前は、時代とともに常に変化していきます。また、お客様ごとに、データセットの品質・範囲・出どころも大きく異なります。
そのため、当社の API から返されるすべての結果が、常に 100% 正確で、お客様のデータプールと完全に一致することを保証することはできません。

ですが、当社は常に可能な限り最良の結果をお届けすることをお約束します。アルゴリズムは定期的に改善・アップデートしており、新しいデータも継続的に追加しています。
最新のアップデートについては、こちら で詳しくご紹介しています。 万が一、サービス内容がご期待に沿わなかった場合でも、シンプルな 14日間返金保証 をご用意しています。
もちろん、サービスは完全無料でお試しいただけます。こちら から登録すると、100 件のリクエストを 毎月 無料でご利用いただけます。

名前を問い合わせると、ご利用中の API バージョンに応じて、レスポンスには accuracy（精度）または probability（確率）のいずれかの値が返ります。
accuracy パラメータは、その名前が男性名か女性名かについて、どのくらいの確度で判定できているかを示す指標です。
この値は、当社データベース内の該当レコード数に基づいて計算されます。

ユースケースは大きく異なるため、どの精度レベルを採用すべきかについて、当社から一律の推奨値は出していません。
どの結果や精度レベルを受け入れるかは、お客様のユースケースに合わせてご判断ください。

accuracy が 99% 以上であっても、結果が誤っている可能性はゼロではありません。
とはいえ、95% を超える値であれば、一般的には多くのユースケースに十分な精度といえます。

Question 8

データベースにはどれくらいの名前が登録されていますか？

Accepted Answer

私たちのデータベースには、6,084,389 件の検証済みの名前が 191 か国分登録されています。世界全体では、6,471,712 種類のユニークな名前を保存しています。
平均して、結果の品質を向上させるために毎月約 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。
サポート対象国の一覧は こちら からご確認いただけます

Question 11

1回のリクエストで複数の名前を問い合わせできますか？

Accepted Answer

はい、可能です。1回のリクエストで最大100件まで名前を問い合わせできます。
詳しくは API ドキュメント をご覧ください。

Question 12

メール API について聞きました。具体的には何ができるのですか？

Accepted Answer

メール API は、メールアドレスから名前を抽出し、そのアドレスに対応する性別を判定できます。
これを使うと、メール配信で相手に合った敬称をつけて、よりパーソナライズされたコミュニケーションができます。
たとえば「marie.johnson@gmail.com」というメールアドレスから、API は名前「Marie」を抽出し、正しい性別である「female」を判定します。
詳しくは API ドキュメント をご覧ください。

Question 13

大量のデータがあります。CSV ファイルを一括アップロードできますか？

Accepted Answer

登録ユーザーであれば、ファーストネームの列を含む任意の CSV ファイルをアップロードできます。
より正確に判定するために、オプションで国の列を追加することもできます。
列名を特別に決めておく必要はなく、どの列にどの情報（ファーストネームや国名など）が入っているかは、アップロード時にアシスタントが案内するので選ぶだけです。
この機能は お客様のアカウント の中にあります。
処理されたレコードは通常のリクエストと同じように課金されるため、毎月 100 件までの CSV データを無料でアップロードして処理できます。
CSV 一括アップロード を利用するには Gender-API.com のアカウントが必要です。
データ保護の観点から、アップロードされたファイルは1年後に自動的に削除されます。

Question 14

CSV ファイルはどのような形式にすればよいですか？

Accepted Answer

Windows、MacOS、Linux で作成された CSV ファイルに対応しています。
さらに、区切り文字が「;」「,」またはタブのファイルも使えます。囲み文字は「"」である必要があります。

複数行を含む CSV ファイルもアップロードでき、最大行数は 10,000,000 行、サイズは最大 301MB までです。
できるだけ良い結果を得るために、区切り文字にセミコロンを使った UTF-8 形式の CSV ファイルをおすすめします。

それ以外の場合でも、CSV ファイルには任意の追加列を含めることができ、それらも出力ファイルにそのまま含まれます。

ファイルには、ファーストネームだけが入った列が少なくとも1つ、またはフルネームが入った列が1つ必要です。

サンプルファイルは こちら からダウンロードできます。
CSV ファイルをアップロードするには、Gender-API.com のアカウント を作成してください。

Question 15

Excelファイルをアップロードできますか？

Accepted Answer

最大 300,000 行までの Excel ファイルをアップロードできます。より大きなデータセットの場合は、CSV ファイルでのアップロードをご利用ください。
1つのシートを含む .xlsx ファイルに対応しています。複数シートのファイルをアップロードした場合は、最初のシートだけが処理されます。
シートの1行目には必ず列名を入れてください。ファイルには少なくとも1つ、ファーストネームの列が必要です。国名の列は任意です。
データ保護の観点から、アップロードされたファイルは1年後に自動的に削除されます。サンプルファイルをここからダウンロード。例:

Question 16

バグを見つけました。どうすればよいですか？

Accepted Answer

ご協力ありがとうございます。contact gender-api.com までメールをお送りいただければ、できるだけ早くこのバグを修正します。

Question 17

Gender-APIは一般データ保護規則（GDPR）に準拠していますか？

Accepted Answer

Gender-API.com のすべてのサービスは、GDPR を完全に順守しています。
GDPR 上の義務を満たすためのデータ処理契約（DPA）もご用意しています。
この契約書はアカウント内の こちら からリクエストできます。サンプル契約書は こちら からダウンロードできます。
また、データ保護の取り組みについての詳細は こちら でご確認いただけます。

Question 18

プログラミング言語向けのライブラリはありますか？

Accepted Answer

当社の API はとてもシンプルなため、jQuery プラグイン以外のプログラミング言語向けライブラリは提供していません。ほとんどの言語では標準で JSON パーサーが利用でき、その他の言語でもすでに使える外部ライブラリが多数あります。
API の使い方をすぐにつかみたい場合は、まず当社のコードサンプルをご覧ください

Question 19

リクエストはどのようにカウントされますか？

Accepted Answer

毎月1日の時点で残りのリクエスト数がこの数を下回っている場合、すべてのアカウントは 100 リクエストまで自動的にリチャージされます。
結果が見つかった場合にのみ、リクエストとしてカウントされます。1件の名前照会は1リクエストとしてカウントされます。
1回のクエリで複数の名前をリクエストした場合は、それぞれの名前が1リクエストとしてカウントされます。

Question 20

APIキーはどこで確認・管理できますか？

Accepted Answer

Gender-API.com のアカウントに登録すると、最初の API キーが自動的に発行されます。
この API キーは、アカウント概要ページの一番下に表示されます。

このキーを無効にしたいときは、「Revoke and Regenerate」ボタンをクリックしてください。
そうすると、現在の API キーは使えなくなり、新しいキーが発行されます。
古いトークンを使っているアプリケーションは、新しい API キーに差し替えるまで、Gender-API.com の API にアクセスできなくなるためご注意ください。
[apiKeyImage]

API キーは複数作成することもできます。
たとえば、複数のアプリケーションで Gender-API の機能を使いたい場合などに便利です。 キーごとのリクエスト数の区別はありません。すべてのリクエストは合算してカウントされます。複数の API キーを管理・作成するには、アカウントメニューの「Settings」ボタンをクリックし、その後 "API Keys" をクリックしてください。
[multipleKeysImage] 「Create New Key」ボタンをクリックすると、新しい API キーを発行できます。各トークンには任意の名前をつけられるので、このキーがどこで使われているか、あとから簡単に見分けられます。この名前はいつでも変更できます。さらに、一部のウィジェットはここで自動的にキーを生成します。たとえば、アカウント内で「Quick Lookup Widget」を使うと、システムがあらかじめキーを作成し、このウィジェットはそのトークンを使って API に問い合わせを行います。
また、サードパーティアプリも接続されると、ここにキーを作成します。各トークンは「x」をクリックするだけで、いつでも失効させることができます。一度失効させると、そのアプリケーションは当社の API へアクセスできなくなります。

Question 21

アカウントを複数人で共有してもいいですか？

Accepted Answer

1つのアカウントを、同じプロジェクトに関わる最大50人までの同僚やパートナーと共有できます。チームを管理するには、まずアカウントにログインし、アカウントメニューから「Settings」=> "Manage Your Team" をクリックしてください。
このページで「Invite a new member」ボタンをクリックすると、メールでチームメンバーを招待できます。

メンバーを招待する際には、2種類のアカウントタイプから選べます。

A) ユーザー：
API キーの閲覧・作成・更新・削除、CSV・Excel ファイルのアップロードと性別判定、すべての API エンドポイントへのアクセス、リクエストの購入、サードパーティアプリとの連携ができます。

B) 管理者：
ユーザーができることに加えて、アカウント設定と請求先住所の更新、データ処理契約の作成・閲覧、チームメンバーの招待・更新・削除ができます。

Question 22

2段階認証を有効にしてアカウントを保護できますか？

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

パスキーは、パスワードを使わない最新の認証方法で、従来のパスワードよりも強力なセキュリティを提供します。
パスワードを入力する代わりに、Face ID、Touch ID、Windows Hello、または PIN など、デバイスに搭載されたセキュリティ機能でサインインできます。
パスキーは WebAuthn 標準に基づいており、特定のウェブサイトと暗号技術で結び付けられているため、フィッシングに強いのが特長です。
秘密鍵はデバイスの外に出ないため、パスキーはパスワードより安全です。Gender-API.com のアカウントにパスキーを設定しておけば、タッチやひと目でサインインが完了し、パスワードは不要になります。
パスキーはデバイス間でも使え、iCloud キーチェーン、Google パスワード マネージャーなどのサービスで同期することもできます。

Question 25

アカウントにパスキーを設定するにはどうすればよいですか？

Accepted Answer

パスキーの設定は、ログインの流れの中で自動的に行われます。メールアドレスとパスワードでサインインすると、次回以降のログインを速くするためにパスキーを作成するよう案内が表示されます。あとはデバイスの表示に沿って進めるだけです。ブラウザが Face ID、Touch ID、Windows Hello、またはデバイスの PIN を使って本人確認を求めます。確認が完了すると、パスキーは自動的にデバイスに保存され、すぐ使える状態になります。

次に Gender-API.com を訪れたときは、パスワードを入力しなくても、パスキーだけですぐにサインインできます。

パスワードでの利用を続けたい場合は、パスキーの設定をスキップしてもかまいません。

ご注意：パスキーの利用には、対応ブラウザ（Chrome、Safari、Edge、Firefox）と対応 OS が必要です。

Question 26

パスキーは2段階認証（2FA）とどう違うのですか？

Accepted Answer

どちらもセキュリティを強化しますが、仕組みは異なります。2段階認証（2FA）は、パスワードを入力したあとに第2の要素を追加する方法で、認証アプリで生成されるコードを使うのが一般的です。
一方パスキーは、パスワードそのものを置き換える仕組みで、「持っているもの（端末）」と「本人であること（生体認証）」または「知っているもの（端末の PIN）」を組み合わせて、1ステップで多要素のセキュリティを実現します。

パスキーのほうがより安全とされる理由は、次のとおりです。
- フィッシングに強い（正規のサイトでしか動作しない）
- パスワードのデータベース流出の影響を受けない
- 推測されたり解析（クラック）されたりしない

パスキーと 2FA の両方を有効にしている場合でも、パスキーでサインインすると 2FA の確認はスキップされます。パスキー自体が、同等またはそれ以上のセキュリティをすでに提供しているためです。

Question 27

パスキーを保存しているデバイスをなくしたらどうなりますか？

Accepted Answer

パスキーを保存したデバイスをなくしてしまっても、心配はいりません。アカウントは引き続き安全で、アクセスできます。
いつでもパスワード（有効にしていれば 2FA も）でサインインできます。パスキーを iCloud キーチェーンや Google パスワード マネージャーで同期している場合は、同じアカウントにサインインしている他のデバイスでも自動的に使えます。
より安全にお使いいただくために、複数のデバイスでパスキーを設定すること、パスワードをバックアップとして保持すること、そして追加のセキュリティ層として 2FA を有効にすることをおすすめします。
また、アカウント設定から パスキーを管理 して、紛失したデバイスのパスキーを削除し、不正アクセスの可能性を防ぐこともできます。

Question 28

有料アカウントと無料アカウントの違いは何ですか？

Accepted Answer

どちらのアカウントタイプでも、利用できる機能は同じです。すべての API エンドポイントは両方のアカウントタイプで使え、返ってくる結果もまったく同じです。

無料アカウントには、1か月あたりのリクエスト数に上限があります。サインアップすると、すぐに無料で 100 件のリクエストが使えるようになります。毎月1日になると、このカウントはリセットされ、無料リクエスト数がまた復活します。

アカウントは1人につき1つだけ作成してください。もっと多くのリクエストが必要な場合は、いつでも こちら から有料プランのいずれかにアップグレードできます。

Question 29

すべてのデバイスからログアウトするにはどうすればいいですか？

Accepted Answer

アカウントでログアウトボタンをクリックした場合、ログアウトされるのは現在お使いのデバイスだけです。
アカウントとデータを安全に保つため、必要に応じてすべてのデバイスからログアウトすることが大切です。以下の手順に従って、当社の API プラットフォームから全デバイスのログアウトを行ってください。

ログイン中に、すべてのデバイスからログアウトするには こちら をクリックしてください。
また、パスワードを変更したり、2要素認証（2FA）の設定を変更した場合、現在の IP アドレスと一致しないすべてのデバイスからは自動的にログアウトされます。これにより、アカウントにさらに強固なセキュリティ層が追加されます。
安全性を高め、チームでのコラボレーションをしやすくするために、チームメンバーごとに 個別のアカウント を作成することをおすすめします。

さらにアカウントの安全性を高めるため、2要素認証（2FA）の有効化を強くおすすめします。
この追加の保護レイヤーにより、ログイン時にもう一段階の確認ステップが加わるので、第三者が不正にアクセスすることがぐっと難しくなります。

Question 30

サブスクリプションと都度払いは、どう違いますか？

Accepted Answer

パッケージを購入する際は、都度払いとサブスクリプション（定期購入）のどちらかを選べます。
サービスを継続的に使う予定があるなら、サブスクリプションがおすすめです。常に十分なリクエスト数がアカウントに残っているようにできます。

サブスクリプションで購入したリクエストは、1か月のあいだ利用できます。サブスクリプションが有効なあいだは、1か月ごとに選択したリクエスト数まで自動的に補充されます。
たとえば、25,000 リクエストのパッケージを契約していて、そのうち 21,500 リクエストを使用した場合、1か月後にアカウントの残高が再び 25,000 リクエストまで補充されます。

都度払いのパッケージは、特定の用途のために購入でき、有効期限は1年間です。
たとえば、Excel や CSV ファイルを一度だけ処理したい場合には、都度払いをおすすめします。
都度払いは自動更新されないため、リクエストが足りなくならないようご自身で管理してください。

どちらのタイプのパッケージにも、購入ページ からいつでも切り替えられます。

[difference]
サポートチームに事前に相談するか、自分がよく理解している場合を除き、この2種類の購入方法を同時に利用しないでください。定期購入プランに加入している状態で都度購入パッケージを追加購入すると、サブスクリプションでのリクエスト自動補充が正しく行われない場合があります。たとえば、サブスクリプションで補充される予定のリクエスト数よりも、都度購入のリクエストが多く残っているケースなどです。

Question 31

居住証明書が必要です。発行してもらえますか？

Accepted Answer

当社の居住証明書が必要な場合は、サポート までお問い合わせください。
居住証明書は、企業ごとに個別に発行依頼を行う必要があります。ご依頼の際には、御社の正式な住所、居住国、可能であれば税番号を記載してください。
居住証明書は当社の税務当局による署名が必要です。署名済みの書類が発行されるまで通常 2～3 週間ほどかかり、その後、スキャンデータとしてお渡しします。

[certificate-of-residence]

Question 32

パッケージ / 追加リクエストはどうやって購入できますか？

Accepted Answer

サブスクリプションプランと都度払いプランのどちらかを、こちら から選べます。
一度に大きな CSV ファイルを処理したい場合や、不定期にしかリクエストを使わない場合は、都度払いプランがおすすめです。

必要なリクエスト数だけ、いつでもアカウントにチャージできます。
都度払いで購入したリクエストは、1年間有効です。

サブスクリプションプランを選ぶと、毎月自動的にアカウントのリクエスト数が、選んだ数まで補充されます。
サブスクリプションは、いつでも変更・解約できます。

Question 33

定期購入はどうやって解約できますか？

Accepted Answer

いつでも こちら からプランの変更や解約ができます。継続課金を止めたい場合は、「Cancel this subscription」ボタンをクリックしてください。

Question 34

一般的なAPIのレスポンス時間はどのくらいですか？

Accepted Answer

当社の API は高いパフォーマンスを前提に設計されており、通常は 10〜200 ミリ秒以内にレスポンスを返します。
地理的な場所やネットワーク状況、クエリの複雑さによって、レスポンス時間は多少変動することがあります。
複数の名前を含むバッチリクエストの場合、レスポンス時間は件数に比例して伸びます。
世界中で低レイテンシーを実現するため、グローバル CDN と最適化されたインフラを利用しています。
継続的にレスポンスが遅い場合は、サポートチーム までお問い合わせください。

Question 35

レート制限やリクエスト数の制限はありますか？

Accepted Answer

すべてのユーザーに最適なサービスを提供するため、公平なレート制限を設けています。
無料アカウントでは、1か月あたり最大 100 リクエストまで利用できます。
有料アカウントでは上限が大幅に緩和され、1分あたり 1500 リクエストまで送信でき、クレジットが残っている限り1日の上限はありません。
より高いレート制限が必要なユースケースがある場合は、カスタムプランについて お問い合わせ ください。
バッチリクエスト（1リクエストにつき最大100件の名前）は、名前ごとに個別のリクエストとしてカウントされますが、より効率的に処理できます。

Question 36

API の稼働率保証はどうなっていますか？

Accepted Answer

すべての有料プランで、API の稼働率 99.9% を保証しています。当社のインフラはエンタープライズ向けのサーバー上で稼働し、自動フェイルオーバーとロードバランシングに対応しています。システムは24時間365日監視しており、問題が発生した際には自動アラートが通知されます。
さらに、エンタープライズ向けにはサービス品質保証契約（SLA）も提供しています。まれに長時間のダウンタイムが発生した場合でも、有料のお客様には SLA の条件に基づいて自動的にサービスクレジットが付与されます。

Question 37

API レスポンスはどのような形式ですか？

Accepted Answer

API レスポンスは標準で JSON 形式で返されます。JSON は、ほぼすべてのモダンなプログラミング言語で広くサポートされている形式です。各レスポンスには、リクエストされた名前、判定された性別、精度／確率の値、それに追加のメタデータが含まれます。例：{"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}。
詳しいレスポンススキーマは API ドキュメント でご確認いただけます。クライアントを自動生成するための OpenAPI 仕様もダウンロードできます。

Question 38

API エラーはどのように処理すればよいですか？

Accepted Answer

当社の API は、成功か失敗かを示すために標準的な HTTP ステータスコードを使用します。
200 は成功、401 は API キーが無効、429 はレート制限超過、500 はサーバーエラーを意味します。
各エラーレスポンスには、分かりやすい説明メッセージとエラーコードが含まれるため、デバッグも簡単です。
レート制限エラーに対しては指数バックオフの実装をおすすめします。また、可能な限り成功したレスポンスをキャッシュすることも推奨しています。
エラーが継続する場合は、API ドキュメント を確認するか、サポート までお問い合わせください。
すべてのエラーは、トラブルシューティングのためにログに記録されています。

Question 39

API のバージョン管理はどのようにしているのですか？

Accepted Answer

現在、Gender-API では V1 と V2 の 2つの API バージョンを提供しています。V2 は最新バージョンで、確率値の返却、対応国の拡大、精度向上など、さらに強化された機能が含まれます。V1 は後方互換性のために引き続き利用できますが、新しい連携には V2 への移行をおすすめします。

すべての API エンドポイントには、URL パス内にバージョンが含まれます（例：/v2/name）。古い API バージョンについても、引き続き動作し続けることを保証しています。移行ガイドは API ドキュメント に用意しています。互換性を壊すような変更がある場合は、必ず事前に十分な余裕をもってお知らせします。

Question 40

名前のバリエーションやニックネームはどう扱っていますか？

Accepted Answer

当社のデータベースには、一般的な名前のバリエーション、短縮形、ニックネームも含まれています。たとえば「Bob」は「Robert」のバリエーションとして、「Liz」は「Elizabeth」のバリエーションとして認識されます。
ただし、もっとも正確な結果を得るためには、可能なかぎりフルのファーストネームで照会することをおすすめします。

当社の AI システムは、自社のデータセットから常に新しい名前のバリエーションを学習しています。
認識されないニックネームを見つけた場合は、お知らせください。データベースに追加します。

「Juan」と「John」のような地域ごとの違いも、国別データセットを通じて適切に処理しています。

Question 41

API は特殊文字やアクセント付きの名前にも対応していますか？

Accepted Answer

はい。当社の API は、アクセント付き文字（é、ñ、ü）、ウムラウト、ダイアクリティカルマーク、さらにアラビア語・キリル文字・中国語などの非ラテン文字も含む Unicode 文字に完全対応しています。
API リクエスト内の名前は UTF-8 でエンコードしてください。たとえば「François」「José」「Müller」「Søren」なども、すべて正しく処理されます。

URL エンコードはほとんどの HTTP クライアントで自動的に行われますが、特殊文字については正しくエンコードされているかご確認ください。
当社のデータベースには、191 か国から集めた名前が登録されており、主要な文字体系をほぼすべてカバーしています。詳しくは API ドキュメント をご覧ください。

Question 42

どのようなデータソースを使っているのですか？

Accepted Answer

当社は信頼性の高い複数のデータソースを組み合わせて、できる限り正確な判定を実現しています。主なデータソースは次のとおりです。

- 各国の政府による国勢調査データや出生記録
- 公開されている名前データベース
- ソーシャルメディアやビジネス系ネットワーク（匿名化され、GDPR に準拠）
- 歴史的な名前記録
- データチームによる手作業での確認

すべてのデータソースは厳密にチェックされ、相互に照合されています。利用可能な場合は、公的機関が提供する公式データを最優先で採用しています。

さらに、AI モデルを活用してパターンを見つけ出し、各データソース間の一貫性も検証しています。サポートしている国の完全なリストは こちら からご確認いただけます。

新しい公式データが公開され次第、データベースを継続的にアップデートしています。

Question 43

プライバシーとデータ保護はどのように確保しているのですか？

Accepted Answer

当社はプライバシーを何よりも重視し、GDPR、CCPA をはじめとする各種国際的なデータ保護規制に準拠しています。
サービス運用に必要なログを除き、照会された名前を保存することはありません。
すべての API 通信は HTTPS/TLS で暗号化されています。エンタープライズ向けには データ処理契約 もご用意しています。

アップロードされた CSV／Excel ファイルは、1 年後に自動的に削除されます。
お客様のデータを第三者に販売したり、共有したりすることは一切ありません。
サーバーは、ヨーロッパの安全なデータセンターに設置されています。
詳しくは、当社の プライバシーポリシー をご覧ください。
また、定期的なセキュリティ監査により、常にコンプライアンスを維持しています。

Question 44

支払いの請求書や領収書は発行できますか？

Accepted Answer

はい、すべての購入に対して請求書が自動で発行され、アカウントダッシュボード から確認できます。PDF 請求書はいつでもダウンロードでき、登録済みのメールアドレスにも送信されます。
請求書には、必要に応じて VAT 情報を含む、会計処理に必要なすべての内容が記載されています。
請求書に正しい内容が反映されるよう、請求先情報や会社情報はいつでも更新できます。
過去の請求書が必要な場合や特別な形式の請求書が必要な場合は、サポートへお問い合わせ ください。

Question 45

返金ポリシーはどうなっていますか？

Accepted Answer

初回購入には、シンプルな14日間の返金保証があります。
サービスにご満足いただけない場合、最初の14日以内であれば理由を問わず全額返金します。
サブスクリプション料金については、いつでも解約でき、今後の請求を停止できます。
都度払いによる未使用クレジットは、1年間有効です。
技術的な問題やサービス上の不具合があった場合は、状況に応じて返金にも対応しています。
詳細については、キャンセルポリシー の全文をご確認いただくか、不明点があれば サポートへお問い合わせ ください。

Question 46

どんなサードパーティ連携が利用できますか？

Accepted Answer

当社は、Zapier、Make（旧 Integromat）、Google Sheets、Microsoft Excel、Salesforce、HubSpot、多くの CRM システムなど、人気のプラットフォームやツールとの連携に対応しています。
当社 API は、REST API または Webhook に対応しているあらゆるプラットフォームで利用できます。
主要なプラットフォーム向けに、すぐに使えるコネクタと、詳しい連携ガイドも用意しています。
連携なしで一度きりのデータ処理を行いたい場合は、CSV アップロード機能 もご利用いただけます。
カスタム連携や特定プラットフォームへの対応については、ドキュメント を確認するか、サポート までお問い合わせください。

よくある質問