인증

FourA API에 대한 모든 request에는 인증이 필요합니다. 이 페이지에서는 API key를 획득, 사용 및 관리하는 방법을 설명합니다.

API Key 발급받기

1. FourA Dashboard에 로그인합니다.
2. API Keys 페이지로 이동합니다.
3. Create Key를 클릭합니다.
4. key를 즉시 복사합니다 (이후에는 전체 key가 다시 표시되지 않습니다)

API key는 다음과 같은 형태입니다: pk_live_a1b2c3d4e5f6...

API Key 사용하기

모든 request의 X-API-Key header에 API key를 포함하세요:

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

Python:

import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)

Node.js:

const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});

API Key 보안

API key는 비밀번호처럼 취급해야 합니다:

• 버전 관리 시스템에 커밋하지 마세요. 대신 환경 변수를 사용하세요.
• 클라이언트 측 코드에 노출하지 마세요. 서버 측 애플리케이션에서만 사용하세요.
• 유출된 경우 교체하세요. Dashboard에서 새 key를 생성하고 기존 key를 비활성화하세요.

환경 변수 사용하기

환경 변수에 key를 저장합니다:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

그런 다음 코드에서 해당 변수를 참조합니다:

import os
api_key = os.environ["FOURA_API_KEY"]

const apiKey = process.env.FOURA_API_KEY;

자주 발생하는 인증 오류

모든 인증 실패는 401 Unauthorized 상태를 반환합니다.

다음 단계

• Quick Start: 첫 번째 request 보내기
• API Endpoints: 전체 endpoint 레퍼런스
• Error Handling: 인증 오류를 매끄럽게 처리하기