APIドキュメント

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: 新規登録（v2）
PURPOSE: 無料アカウントを作成すると、ログイン用パスワードとAPIトークンを受け取れるよ。認証は不要です。

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/sign-up

--- AUTHENTICATION ---
Header: Content-Type: application/json

--- REQUEST PARAMETERS ---

Parameter: email
  Type: string
  Required: REQUIRED
  Description: 登録に使うメールアドレス。名も姓も入力する必要はありません。

Parameter: accept_terms
  Type: bool
  Required: REQUIRED
  Description: true である必要があります。ユーザーは 利用規約 とプライバシーポリシーに同意する必要があります。

Parameter: newsletter
  Type: bool
  Required: OPTIONAL
  Description: ニュースレターを購読する。デフォルトは false。

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: アカウントの言語。「en」「de」「es」のいずれか。指定がない場合は「en」がデフォルトです。

--- REQUEST EXAMPLES ---

Example 1: メールアドレスで登録する
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true
}

Example 2: 登録してニュースレターを購読しよう
Request Body (JSON):
{
    "email": "user@example.com",
    "accept_terms": true,
    "newsletter": true,
    "locale": "en"
}

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "email": "user@example.com",
    "password": "",
    "api_token": "",
    "free_requests_per_month": 100,
    "status": "awaiting_activation",
    "message": "Account created. Ask the user to click the activation link sent to their email address. The API token below activates automatically once the email is confirmed and can then be used as a Bearer token against the API.",
    "docs_url": "https://gender-api.com/skill.md"
}

--- RESPONSE FIELDS ---

Field: email
  Type: string
  Description: 登録済みのメールアドレス。

Field: password
  Type: string
  Description: ウェブダッシュボード用のランダムなログインパスワード。返されるのは1回だけなので、安全な場所に保管してね。あとで「パスワードを忘れた」からリセットできるよ。

Field: api_token
  Type: string
  Description: APIのBearerトークン。「Authorization: Bearer 」として /v2/... リクエストで使ってね。ユーザーがメールアドレスを確認すると利用できるようになるよ。

Field: free_requests_per_month
  Type: int
  Description: 毎月付与される無料リクエスト数。

Field: status
  Type: string
  Description: アカウントのステータス。「awaiting_activation」は、メールアドレスの確認が完了するまで表示されます。

Field: message
  Type: string
  Description: 次のステップ（メールアドレスの確認）についての、わかりやすい案内文。

Field: docs_url
  Type: string
  Description: すぐ使えるAI実装手順（skill.md）へのリンク。

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/sign-up' \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","accept_terms":true}'

--- CREDIT USAGE ---
Required Requests: 0

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: ファーストネームで検索 (v2)
PURPOSE: 名（ファーストネーム）から性別を判定。オプションで国情報を指定して、さらに高精度な結果を得られるよ。

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <your authorization token> 
link

--- REQUEST PARAMETERS ---

Parameter: first_name
  Type: string
  Required: REQUIRED
  Description: 照会する名前

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Country Code link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: ブラウザーのロケール

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: 有効な IPv4 または IPv6 アドレス

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: 最大 50 文字。任意の英数字の値を id として設定できるよ。
            たとえば、データベース内のデータセットに使っている社内の ID をそのまま設定することも可能。
            非同期環境では、この値を使うことで、レスポンスと以前のリクエストをより正確に結びつけられるよ

--- REQUEST EXAMPLES ---

Example 1: ファーストネームのみで検索
Request Body (JSON):
{
    "first_name": "Sandra"
}

Example 2: ファーストネームと国コードで検索
Request Body (JSON):
{
    "first_name": "Sandra",
    "country": "US"
}

Example 3: ファーストネームとブラウザーのロケールで検索
Request Body (JSON):
{
    "first_name": "Sandra",
    "locale": "en_US"
}

Example 4: ファーストネームと IP アドレスを使ってローカライズ検索
Request Body (JSON):
{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

Example 5: 1つのリクエストで複数の名前を照会
Request Body (JSON):
[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: 送信したペイロード

Field: details.credits_used
  Type: int
  Description: このクエリで消費されたリクエスト数

Field: details.samples
  Type: int
  Description: あなたのリクエストに一致して、当社データベース内で見つかったレコード数

Field: details.country
  Type: string
  Description: 判定に使用した国

Field: details.first_name_sanitized
  Type: string
  Description: 当社の正規化処理を適用したあとの名前

Field: details.duration
  Type: string
  Description: リクエストを処理するためにサーバーが必要とした時間

Field: result_found
  Type: bool
  Description: 指定された名前について性別を取得できた場合は true

Field: first_name
  Type: string
  Description: 性別判定に使用したファーストネーム

Field: probability
  Type: float
  Description: この値（0〜1の範囲）は、当社データベースの信頼性を示しているよ。1 の場合、その性別判定結果が 100%% 正確であることを意味するよ。

Field: gender
  Type: string
  Description: 取り得る値: male, female, unknown

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your authorization token> link' \
  -d '{"first_name":"Sandra"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: フルネームで検索 (v2)
PURPOSE: フルネームを自動で分割し、1回の効率的なAPIコールで性別を判定

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <your authorization token> 
link

--- REQUEST PARAMETERS ---

Parameter: full_name
  Type: string
  Required: REQUIRED
  Description: 照会する名前

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Country Code link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: ブラウザーのロケール

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: 有効な IPv4 または IPv6 アドレス

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: 最大 50 文字。任意の英数字の値を id として設定できるよ。
            たとえば、データベース内のデータセットに使っている社内の ID をそのまま設定することも可能。
            非同期環境では、この値を使うことで、レスポンスと以前のリクエストをより正確に結びつけられるよ

--- REQUEST EXAMPLES ---

Example 1: フルネームのみで照会
Request Body (JSON):
{
    "full_name": "Theresa Miller"
}

Example 2: フルネームと国コードで照会
Request Body (JSON):
{
    "full_name": "Theresa Miller",
    "country": "US"
}

Example 3: フルネームとブラウザーのロケールで照会
Request Body (JSON):
{
    "full_name": "Thomas Johnson",
    "locale": "en_US"
}

Example 4: フルネームとIPアドレスを使ってローカライズして照会
Request Body (JSON):
{
    "full_name": "Markus Stefan NonExistingLastName",
    "ip": "54.201.16.177"
}

Example 5: 1つのリクエストで複数の名前を照会
Request Body (JSON):
[
    {
        "full_name": "Theresa Miller"
    },
    {
        "full_name": "Thomas Johnson",
        "country": "US"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: 送信したペイロード

Field: details.credits_used
  Type: int
  Description: このクエリで消費されたリクエスト数

Field: details.samples
  Type: int
  Description: あなたのリクエストに一致して、当社データベース内で見つかったレコード数

Field: details.country
  Type: string
  Description: 判定に使用した国

Field: details.full_name_sanitized
  Type: int
  Description: 当社の正規化処理を適用したあとの名前

Field: details.duration
  Type: string
  Description: リクエストを処理するためにサーバーが必要とした時間

Field: result_found
  Type: bool
  Description: 指定された名前について性別を取得できた場合は true

Field: full_name
  Type: string
  Description: 性別判定に使用したフルネーム

Field: probability
  Type: float
  Description: この値（0〜1の範囲）は、当社データベースの信頼性を示しているよ。1 の場合、その性別判定結果が 100%% 正確であることを意味するよ。

Field: gender
  Type: string
  Description: 取り得る値: male, female, unknown

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your authorization token> link' \
  -d '{"full_name":"Theresa Miller"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: メールアドレスで検索 (v2)
PURPOSE: メールアドレスから名前を抽出し、高度な解析アルゴリズムで性別を判定。

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/gender

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <your authorization token> 
link

--- REQUEST PARAMETERS ---

Parameter: email
  Type: string
  Required: REQUIRED
  Description: 問い合わせるメールアドレス

Parameter: country
  Type: string
  Required: OPTIONAL
  Description: ISO 3166 ALPHA-2 Country Code link

Parameter: locale
  Type: string
  Required: OPTIONAL
  Description: ブラウザーのロケール

Parameter: ip
  Type: string
  Required: OPTIONAL
  Description: 有効な IPv4 または IPv6 アドレス

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: 最大 50 文字。任意の英数字の値を id として設定できるよ。
            たとえば、データベース内のデータセットに使っている社内の ID をそのまま設定することも可能。
            非同期環境では、この値を使うことで、レスポンスと以前のリクエストをより正確に結びつけられるよ

--- REQUEST EXAMPLES ---

Example 1: メールアドレスだけで問い合わせる
Request Body (JSON):
{
    "email": "theresa.miller14@gmail.com"
}

Example 2: メールアドレスと国コードで問い合わせる
Request Body (JSON):
{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

Example 3: メールアドレスとブラウザーのロケールで問い合わせる
Request Body (JSON):
{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

Example 4: メールアドレスで照会し、IPアドレスを使ってローカライズする
Request Body (JSON):
{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

Example 5: 1つのリクエストで複数の名前を照会
Request Body (JSON):
[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: 送信したペイロード

Field: details.credits_used
  Type: int
  Description: このクエリで消費されたリクエスト数

Field: details.samples
  Type: int
  Description: あなたのリクエストに一致して、当社データベース内で見つかったレコード数

Field: details.country
  Type: string
  Description: 判定に使用した国

Field: details.email_sanitized
  Type: int
  Description: 当社の正規化処理を適用したあとの名前

Field: details.duration
  Type: string
  Description: リクエストを処理するためにサーバーが必要とした時間

Field: result_found
  Type: bool
  Description: 指定された名前について性別を取得できた場合は true

Field: email
  Type: string
  Description: 性別推定に使用したメールアドレス

Field: probability
  Type: float
  Description: この値（0〜1の範囲）は、当社データベースの信頼性を示しているよ。1 の場合、その性別判定結果が 100%% 正確であることを意味するよ。

Field: gender
  Type: string
  Description: 取り得る値: male, female, unknown

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/gender' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your authorization token> link' \
  -d '{"email":"theresa.miller14@gmail.com"}'

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: 出身国を取得 (v2)
PURPOSE: 名前にもとづいて、考えられる出身国や民族的ルーツを推定。

--- API DETAILS ---
Method: POST
URL: https://gender-api.com/v2/country-of-origin

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <your authorization token> 
link

--- REQUEST PARAMETERS ---

Parameter: first_name
  Type: string
  Required: REQUIRED
  Description: 照会する名前（名）

Parameter: full_name
  Type: string
  Required: OPTIONAL
  Description: 照会するフルネーム。first_name フィールドの代わりに指定できます

Parameter: email
  Type: string
  Required: OPTIONAL
  Description: 照会に使うメールアドレス。first_name フィールドの代わりに指定できます

Parameter: id
  Type: string
  Required: OPTIONAL
  Description: 最大 50 文字。任意の英数字の値を id として設定できるよ。
            たとえば、データベース内のデータセットに使っている社内の ID をそのまま設定することも可能。
            非同期環境では、この値を使うことで、レスポンスと以前のリクエストをより正確に結びつけられるよ

--- REQUEST EXAMPLES ---

Example 1: ファーストネームで検索
Request Body (JSON):
{
    "first_name": "Johann"
}

Example 2: フルネームで照会
Request Body (JSON):
{
    "full_name": "Theresa Miller"
}

Example 3: メールアドレスで問い合わせる
Request Body (JSON):
{
    "full_name": "sophia5342@gmail.com"
}

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "input": {
        "first_name": "Johann",
        "id": 12
    },
    "details": {
        "credits_used": 2,
        "duration": "414ms",
        "samples": 890,
        "country": null,
        "first_name_sanitized": "johann"
    },
    "result_found": true,
    "country_of_origin": [
        {
            "country_name": "Germany",
            "country": "DE",
            "probability": 0.52,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        },
        {
            "country_name": "Austria",
            "country": "AT",
            "probability": 0.48,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        }
    ],
    "first_name": "Johann",
    "probability": 0.9,
    "gender": "male",
    "language_of_origin": "Germanic",
    "meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
    "ethnicity": {
        "id": "GERMANIC",
        "name": "Germanic (German, Austrian, Swiss)",
        "distribution": [
            {
                "id": "GERMANIC",
                "name": "Germanic (German, Austrian, Swiss)",
                "percentage": 90
            },
            {
                "id": "DUTCH",
                "name": "Dutch",
                "percentage": 5
            },
            {
                "id": "FRENCH",
                "name": "French",
                "percentage": 5
            }
        ]
    }
 }

--- RESPONSE FIELDS ---

Field: input
  Type: object
  Description: 送信したペイロード

Field: details.credits_used
  Type: int
  Description: このクエリで消費されたリクエスト数

Field: details.samples
  Type: int
  Description: あなたのリクエストに一致して、当社データベース内で見つかったレコード数

Field: details.country
  Type: string
  Description: 判定に使用した国

Field: details.first_name_sanitized
  Type: string
  Description: 当社の正規化処理を適用したあとの名前

Field: details.duration
  Type: string
  Description: リクエストを処理するためにサーバーが必要とした時間

Field: result_found
  Type: bool
  Description: 指定された名前について性別を取得できた場合は true

Field: country_of_origin_map_url
  Type: string
  Description: この名前に関するインタラクティブマップへのURL

Field: first_name
  Type: string
  Description: 性別判定に使用したファーストネーム

Field: probability
  Type: float
  Description: この値（0〜1の間）は、当社データベースの信頼性を示します。値が1の場合、この名前の性別判定結果は100%%正確であることを意味します

Field: gender
  Type: string
  Description: 取り得る値: male, female, unknown

Field: country_of_origin
  Type: object
  Description: 出身国トップ25件。「Complete List Of Possible Countries」で、サポートされている国の一覧を確認できます。各レコードには country_name、country、probability、continental_region、statistical_region フィールドが含まれます

Field: language_of_origin
  Type: string
  Description: この名前の由来となる言語

Field: meaning
  Type: string
  Description: この名前の意味についての短い説明

Field: ethnicity
  Type: object
  Description: ethnicity フィールドには、その名前に主に関連する主要な民族グループと、さまざまな民族グループ間での名前の分布に関する詳細が含まれます

Field: ethnicity.id
  Type: string
  Description: id フィールドには、判定された主要民族グループの識別子が含まれます。利用可能な民族グループの完全な一覧は「Complete List Of Possible Ethnic Groups」を参照してください

Field: ethnicity.name
  Type: string
  Description: name フィールドには、判定された主要民族グループの名称が含まれます。利用可能な民族グループの完全な一覧は「Complete List Of Possible Ethnic Groups」を参照してください

Field: ethnicity.distribution
  Type: array
  Description: Distribution フィールドには、各民族グループにおけるその名前の割合に関する情報が含まれます。各配列エントリには id（string）、name（string）、percentage（float）フィールドが含まれます。取りうる値の完全な一覧は「Complete List Of Possible Ethnic Groups」を参照してください

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X POST \
  'https://gender-api.com/v2/country-of-origin' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your authorization token> link' \
  -d '{"first_name":"Johann"}'

--- CREDIT USAGE ---
Required Requests: 2

=== END OF INSTRUCTIONS ===

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: 統計情報を取得 (v2)
PURPOSE: アカウントの詳細な利用統計と、残りのリクエストクレジットを取得しよう。

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/v2/statistic

--- AUTHENTICATION ---
Header: Content-Type: application/json
Header: Authorization: Bearer <your authorization token> 
link

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "is_limit_reached": false,
    "remaining_credits": 24999,
    "details": {
        "credits_used": 0,
        "duration": "83ms"
    },
    "usage_last_month": {
        "date": "2018-03",
        "credits_used": 25
    }
}

--- RESPONSE FIELDS ---

Field: is_limit_reached
  Type: bool
  Description: リクエストの残り回数がない場合に true を返します

Field: remaining_credits
  Type: int
  Description: 残りのリクエスト数

Field: details.credits_used
  Type: int
  Description: このクエリで消費されたリクエスト数

Field: details.duration
  Type: string
  Description: リクエストを処理するためにサーバーが必要とした時間

Field: usage_last_month.date
  Type: string
  Description: 前月の日付

Field: usage_last_month.credits_used
  Type: int
  Description: 過去1か月間に使用したリクエスト数

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/v2/statistic' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your authorization token> link' \

=== END OF INSTRUCTIONS ===