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여야 해. 사용자는 Terms and Conditions 및 개인정보 처리방침에 동의해야 해.

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: 웹 대시보드에 로그인할 때 쓰는 임의의 비밀번호야. 이 비밀번호는 한 번만 반환되니까 안전하게 저장해줘. 나중에 “비밀번호를 잊으셨나요?” 절차를 통해 다시 설정할 수 있어.

Field: api_token
  Type: string
  Description: API 베어러 토큰이야. /v2/... 요청에서는 "Authorization: Bearer " 형태로 사용해. 사용자가 이메일을 확인(인증)하면 바로 작동하기 시작해.

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: 이름(First Name)으로 조회 (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를 데이터베이스에 있는 해당 데이터셋의 내부 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: 한 번의 요청으로 여러 이름 조회
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: 전체 이름을 자동으로 분리하고, 한 번의 효율적인 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를 데이터베이스에 있는 해당 데이터셋의 내부 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: 한 번의 요청으로 여러 이름 조회
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를 데이터베이스에 있는 해당 데이터셋의 내부 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: 한 번의 요청으로 여러 이름 조회
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를 데이터베이스에 있는 해당 데이터셋의 내부 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이면 요청한 gender 결과가 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: 지난 한 달 동안 사용한 요청 수

--- 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 ===