GenderAPI 인증 | API 키와 Bearer 토큰

인증 개요

API 키 전송 방식 선택하기

인증이 필요한 모든 요청에는 유효한 GenderAPI 키가 필요합니다. 접근 자격 증명을 요청 데이터와 분리할 수 있는 Authorization 헤더 방식을 기본으로 권장합니다.

Bearer 토큰

Authorization 헤더에 키를 전송합니다.

JSON 본문

서버의 POST 필드로 키를 전송합니다.

권장 방식

Authorization 헤더

Bearer 토큰

Authorization: Bearer YOUR_API_KEY를 설정하고 JSON 본문에는 입력 매개변수만 전송합니다.

AuthorizationBearer YOUR_API_KEY

cURL

curl -X POST "https://api.genderapi.io/api" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name":"Jiwon"}'

JavaScript

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({ name: "Jiwon" })
});

대안 방식

JSON 본문에 API 키 추가

POST 본문

요청 데이터와 함께 key 속성으로 API 키를 추가합니다. 신뢰할 수 있는 서버 측 코드에서만 이 방식을 사용하세요.

cURL

curl -X POST "https://api.genderapi.io/api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jiwon","key":"YOUR_API_KEY"}'

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  json={
    "name": "Jiwon",
    "key": "YOUR_API_KEY"
  }
)
print(response.json())

자격 증명 보안

API 키 보호하기

API 키는 서버 환경 변수나 시크릿 관리 서비스에 저장하세요.
버전 관리 시스템에 키를 추가하거나 브라우저 JavaScript에 노출하지 마세요.
애플리케이션, 프록시 및 분석 로그에서 자격 증명을 제거하세요.
모든 요청에 HTTPS를 사용하고 키 유출이 의심되면 즉시 교체하세요.

빠른 비교

어떤 인증 방식을 사용해야 하나요?

방식	권장 사용 환경	자격 증명 위치
Bearer 토큰권장	대부분의 서버 연동	`Authorization` 헤더
JSON 본문	기존 POST 연동	`key` 속성

POST 콘텐츠 유형: JSON 본문을 전송할 때는 Content-Type: application/json을 설정하세요.

다음 가이드

단일 이름 요청 보내기

이름으로 성별 예측단일 요청의 매개변수와 응답 →클라이언트 라이브러리공식 SDK로 돌아가기 →