# 헤더 및 인증

올바른 호스트와 자격 증명을 사용하고 무료 요청 한 번으로 접근을 확인합니다.

Canonical 참고: https://flashdata.dev/ko/docs/guides/headers-and-authentication
검토: 2026-11-04 FlashData

<a id="requests"></a>

## 기본적인 URLs

| 제품정보 | 기본적인 URL | 인증 |
| --- | --- | --- |
| 데이터 쿼리 및 작업 | https://data.flashdata.dev/v1 | X-API-Key |
| Identity, 균형, 가격, 한계 및 사용법 | https://api.flashdata.dev/v2 | X-API-Key |
| 원격 MCP | https://data.flashdata.dev/mcp | OAuth 또는 X-API-Key를 관리 |


<a id="choose"></a>

## 인증 헤드러

REST 요청은 X-API-Key를 사용하여 시험 또는 소유자 키입니다. Content-Type를 가진 JSON 몸을 보내십시오: application/json. CLI 프로필, SDK 환경 및 MCP 연결 매장 자격.

### REST/API 열쇠

#### 관련 상품

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

MCP 호스트를 얻고, 저장하고 로그인을 통해이 토큰을 새로 고침하십시오. MCP 엔드포인트에서만 사용하십시오. 대신 API 키를 사용하여 호스트는 X-API-Key를 보냅니다.

#### MCP 호스트에 의해 관리되는 헤더

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [API 키 받기](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md)
- [MCP를 통해 연결](https://flashdata.dev/ko/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## 당신의 열쇠를 확인

당신의 맨끝에서 이것을 실행하십시오. 정체성 엔드포인트는 신용을 사용하지 않고 액세스 할 수 있습니다. FLASHDATA_API_KEY가 이미 설정되면 키 프롬프트를 건너 뛸 수 있습니다.

### Bash / cURL

Bash와 cURL 7.76+를 요구하십시오. 환경이 이미 FLASHDATA_API_KEY를 공급하는 경우 숨겨진 키 프롬프트를 건너 뛸 수 있습니다. 같은 터미널에서 읽기 명령을 실행합니다.

#### key를 설정하고, 이미 설정한 경우 건너뛰기

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### 계정 읽기 JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

FLASHDATA_API_KEY가 이미 설정되면 숨겨진 키 프롬프트를 건너 뛰십시오. 같은 터미널에서 읽기 명령을 실행합니다.

#### key를 설정하고, 이미 설정한 경우 건너뛰기

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### 계정 읽기 JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="result"></a>

### 예상된 응답

HTTP 200를 기대합니다. 예정된 계정을 확인, access: ready 및 범위의 소스. 임시 열쇠에는 accountType: temporary가 있습니다; 재순환 주인 일은 recurringAllowed: true를 요구합니다.

#### Owner identity · 설명 응답 발췌

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [첫 API 호출 실행](https://flashdata.dev/ko/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## 표시된 저장 URLs

결과 및 업로드 URLs는 자신의 허가를 포함합니다. X-API-Key, OAuth 토큰 또는 브라우저 쿠키가없는 URL를 반환하십시오.


<a id="errors"></a>

## Troubleshooting 인증

| 응답 | 다음 단계 |
| --- | --- |
| 401 | 이 환경에서의 열쇠를 확인하고, 그것의 expiry 및 재발견. 현재 API 키를 사용하여 MCP 토큰 또는 Bearer 접두사가 아닙니다. |
| 403 / 소스 누락 | 이 키에 필요한 소스를 부여하는 소유자에게 문의하십시오. |
| 503 이 무료 읽기 | 나중에 읽습니다. 계정 상태는 확인되지 않았습니다; 유료 쿼리가 준비되어 있지 않다. |

