もっとモダンなインターフェースになった新 API V2.0 エンドポイントを公開しました

schedule Oct 8, 2019

リクエスト数が多い上級ユーザーの場合は、新しい API V2.0 エンドポイントに切り替えられます。統合 API を使えば、複数の名前を1回のリクエストで照会するときでも、はるかに高速で堅牢なインターフェースを利用できます。

1回のリクエストで最大100件の名前を照会

1回のリクエストで最大100件の名前を照会でき、入力データも自由に組み合わせられます。たとえば、ある名前には国コードを指定し、別の名前には国コードなしで送信するといった使い方も、1つのクエリの中でまとめて行えます。

最大200倍の高速化

この新しいエンドポイントは、速度・安定性・スケーラビリティの要件を満たすために、一部の大口顧客と共同で開発しました。 1件ずつ名前を照会する従来のリクエストと比べて、この API エンドポイントは最大200倍高速に動作します。

さらに安全に

プロジェクトごとに、固有の認証トークンを発行できるようになりました。必要に応じて、いつでもトークンを失効させることもできます。認証トークンはこちらから管理できます。

まずはお試し

この JSON API エンドポイントとのやり取りがどれくらい簡単かをご覧いただくため、codepen.io 上にサンプルを用意しています。

Codepen.io が Gender-API.com アカウントに接続し、入力データの形式と、どのようなレスポンスが返るかの基本的な例を確認できます。

codepen.ioでライブテスト

単一の名前を問い合わせる

{"first_name":"Sandra"}

複数の名前を一括照会

[{"first_name":"Sandra"}, {"first_name":"Mike", "country":"US"}]

簡単でした。2つの名前オブジェクトを角括弧で囲むだけで、API に「結果も配列として返してほしい」と指示できます。 1回の REST API コールで、最大100件の名前を照会できます。

メールアドレスと名前の性別照会を組み合わせて使うこともできます。メールアドレスの性別判定も、ファーストネームの性別判定と同じくらいシンプルです。リクエスト JSON に、first_name フィールドの代わりに email フィールドを追加するだけです。メールアドレスから性別を判定する技術は実際にはずっと複雑ですが、複数の処理アルゴリズムを組み合わせることで、可能な限り最良の結果を返しています。

{"email":"theresa.miller14@gmail.com"}