# 응답 형식

응용 프로그램 또는 AI 에이전트에 대한 Markdown 콘텐츠에 대한 구조화된 JSON를 선택하십시오. 2개의 우두머리를 가진 응답을 통제하십시오.

Canonical 참고: https://flashdata.dev/ko/docs/guides/response-formats
검토: 2026-11-04 FlashData

<a id="headers"></a>

## 형식 선택

JSON는 원래 결과 필드가 기본값입니다. Accept는 JSON 또는 일반 텍스트를 선택합니다. X-Respond-With: Markdown는 Markdown에 결과를 변환합니다. 귀하의 요청 몸은 JSON를 유지합니다.

| 응답 | Accept | X-Respond-With | 제품 정보 |
| --- | --- | --- | --- |
| JSON | application/json | 오미트 | 코드의 파싱 필드 · default |
| JSON + Markdown | application/json | markdown | Structured metadata와 Agent 컨텍스트 |
| 일반 텍스트 | text/plain | 오미트 | 터미널에서 원래 필드를 읽으십시오 |
| 텍스트 + Markdown | text/plain | markdown | 메타데이터와 Markdown를 함께 읽으십시오 |


<a id="examples"></a>

## 요청 및 응답 예제

이 탭은 각 형식의 동일한 Google Search를 보여줍니다. Bash 및 cURL 7.76+를 FLASHDATA_API_KEY로 설정하여 google_search를 허용하는 키로 설정합니다. 명령을 실행하면 청구 가능한 검색을 제출합니다.

### JSON

기본 정보 결과 배열을 파; 내부의 필드는 소스에 달려 있습니다.

#### 요청 · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 예제 응답 · 설명 값

```json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Example page",
          "link": "https://example.com/article",
          "snippet": "A short source snippet."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-10-22T12:00:00.000Z"
}
```


### JSON + Markdown

Markdown 문자열로 내용을 읽으십시오. 결과를 대체합니다; 소스, 상태 및 사용은 JSON 필드로 사용할 수 있습니다.

#### 요청 · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'X-Respond-With: markdown' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 예제 응답 · 설명 값

```json
{
  "source": "google_search",
  "status": "done",
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-10-22T12:00:00.000Z",
  "content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}
```


### 일반 텍스트

텍스트로 응답을 읽으십시오. JSON 문서가 아닌 indented layout의 원래 필드를 포함합니다.

#### 요청 · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: text/plain' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 예제 응답 · 설명 값

```text
Source: "google_search"
Status: "done"
Results:
  1:
    Organic:
      1:
        Title: "Example page"
        Link: "https://example.com/article"
        Snippet: "A short source snippet."
Usage:
  Credits: 0.01
Created at: "2026-10-22T12:00:00.000Z"
```


### 텍스트 + Markdown

텍스트로 응답을 읽으십시오: 첫째로 메타데이터, Markdown 내용에 따라 따르십시오.

#### 요청 · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: text/plain' \
  --header 'X-Respond-With: markdown' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 예제 응답 · 설명 값

```text
Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"

Markdown Content:
# Google search

## Organic

### 1. Example page

**Link:** <https://example.com/article>

**Snippet:** A short source snippet\.
```


- [API 인증](https://flashdata.dev/ko/docs/guides/headers-and-authentication/reference.md)
- [Google Search 응답 필드](https://flashdata.dev/ko/docs/sources/google_search/reference.md#response)

<a id="supported-endpoints"></a>

## 지원되는 endpoints

동일한 규칙은 Google Search 및 YouTube 쿼리 소스에 적용됩니다. YouTube Download를 위해, 그들은 납품 기록, 영상 또는 오디오 바이트를 포맷합니다. 계정 APIs, Bulk와 NDJSON 부품, 콜백 및 MCP 응답은 자신의 형식을 사용합니다.

| 끝점 | JSON / 일반 텍스트 | Markdown 내용 |
| --- | --- | --- |
| POST /v1/queries/realtime | 지원되는 | 지원되는 |
| GET /v2/jobs/{id}/results | 지원되는 | 지원되는 |
| POST /v1/queries | 제출 영수증 | Ignored - 결과를 읽을 때 그것을 선택하십시오 |
| POST /v1/queries/batch | 제출 영수증 | Ignored - 결과를 읽을 때 그것을 선택하십시오 |
| GET /v2/jobs/{id} | 작업 상태 | Ignored - 결과 내용이 없습니다 |


<a id="completed-results"></a>

## 완료된 작업 결과 형식

결과를 읽을 때 헤더를 설정하면 제출에 설정할 수 있습니다. JOB_ID를 완료한 작업으로 접속할 수 있습니다. 이 GET는 다른 쿼리를 제출하지 않고 기존 결과를 읽습니다.

| 요청된 형식 | 결과 응답 |
| --- | --- |
| 본래 JSON | 302 응답의 Location에 서명된 저장소 URL이 포함됩니다. X-API-Key 없이 해당 URL을 별도로 조회하세요. 저장된 결과는 gzip으로 압축되어 있을 수 있습니다. |
| 일반 텍스트 또는 Markdown 옵션 | 200는 응답에서 직접 배열한 몸으로. |

### JSON 안의 Markdown 가져오기 · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json' \
  --header 'X-Respond-With: markdown'
```

- [원래 JSON · Python 및 cURL를 검색](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#results)

<a id="errors-and-scope"></a>

## 형식 오류

API 오류는 JSON 또는 application/problem+json에 남아있을 때 일반 텍스트를 요청합니다. HTTP 상태를 확인하기 전에 성공 형식을 파싱합니다.

| 상태 / 코드 | 해결 |
| --- | --- |
| 400 · unsupported_representation | X-Respond-With를 사용하십시오: 마침 또는 우두머리를 omit. json 또는 text와 같은 값은 지원되지 않습니다. |
| 406 · not_acceptable | Accept를 사용하십시오: application/json 또는 text/plain. text/markdown와 application/xml는 지원되지 않습니다. |

- [오류와 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md)

<a id="negotiation"></a>

## Accept 헤더 세부 정보

Omit Accept 또는 JSON를 얻기 위하여 */*를 보내십시오. 응답은 UTF-8를 사용합니다. 미디어 범위와 q 무게가 지원됩니다. 지원되지 않은 charset는 다른 허용 범위 일치하지 않는 406를 반환합니다. Content-Type: application/json는 응답이 아닙니다 요구 몸, 설명합니다.

### 프리퍼 텍스트, JSON 허용

```http
Accept: text/plain; charset=utf-8, application/json;q=0.8
```

