⚡ 통합 API v2.0 고급 기능

API 문서

대량 요청에도 거뜬한 고성능 통합 API를 경험해 봐. 여러 이름을 한 번에 조회하고, 번개처럼 빠른 응답 속도를 누려봐.

이름으로 조회하기

이름으로 성별을 조회하는 가장 간단한 방법입니다. 각 응답은 JSON 형식으로 인코딩됩니다:

POST https://gender-api.com/v2/gender

info Required Requests: 1

http Headers

Content-Type: application/json

Authorization: Bearer <your authorization token>

link

data_object JSON Payload

필드	유형	필수 여부	설명
`first_name`	string	예	조회할 이름
`country`	string	아니요	ISO 3166 ALPHA-2 Country Code link
`locale`	string	아니요	브라우저 로케일
`ip`	string	아니요	유효한 IPv4 또는 IPv6 주소
`id`	string	아니요	최대 50자. 이 ID는 네가 원하는 아무 알파벳·숫자 값으로 설정할 수 있어. 예를 들어, 이 ID를 데이터베이스에 있는 해당 데이터셋의 내부 ID로 지정할 수 있어. 비동기 환경에서는 이전 요청과 응답을 더 쉽게 연결하는 데 도움이 돼

code 요청 예시

arrow_forward 이름만으로 조회

play_arrow Codepen.io에서 실시간으로 테스트해 보기

{
    "first_name": "Sandra"
}

arrow_forward 이름과 국가 코드를 함께 조회

play_arrow Codepen.io에서 실시간으로 테스트해 보기

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward 이름과 브라우저 로케일로 조회하기

play_arrow Codepen.io에서 실시간으로 테스트해 보기

{
    "first_name": "Sandra",
    "locale": "en_US"
}

arrow_forward 이름과 IP 주소를 사용해 지역 기반 조회

play_arrow Codepen.io에서 실시간으로 테스트해 보기

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

arrow_forward 한 번의 요청으로 여러 이름 조회

play_arrow Codepen.io에서 실시간으로 테스트해 보기

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

check_circle 응답

{
    "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"
}

list 응답 필드

필드	유형	설명
`input`	object	전송된 페이로드
`details.credits_used`	int	이 요청으로 사용된 요청 수
`details.samples`	int	너의 요청과 일치하는 레코드가 우리 데이터베이스에서 몇 개 발견되었는지
`details.country`	string	우리가 찾은 국가
`details.first_name_sanitized`	string	정규화기를 적용한 후의 이름
`details.duration`	string	서버가 요청을 처리하는 데 걸린 시간
`result_found`	bool	주어진 이름에 대해 성별 정보를 조회하는 데 성공했다면 true
`first_name`	string	성별 판단에 사용한 이름
`probability`	float	이 값(0과 1 사이)은 우리 데이터베이스 신뢰도를 나타내. 값이 1이면, 네 성별 요청 결과가 100%% 정확하다는 뜻이야.
`gender`	string	가능한 값: male, female, unknown