# Định dạng phản hồi

Chọn cấu trúc JSON cho ứng dụng của bạn hay Markdown Thỏa mãn cho một tác nhân AI. Kiểm soát phản ứng bằng hai đầu đạn.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/response-formats
Xem lại: 2026-11-04 by FlashData

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

## Chọn một định dạng

JSON với trường kết quả ban đầu là mặc định. Accept lựa chọn JSON hoặc chỉ đơn giản văn bản; X-Respond-With: Đánh dấu sẽ chuyển đổi nội dung kết quả thành Markdown. Yêu cầu của bạn cơ thể ở lại JSON.

| Phản hồi | Accept | X-Respond-With | Dùng cho |
| --- | --- | --- | --- |
| JSON | application/json | Omit | Phân tích trường trong mã· default |
| JSON + Markdown | application/json | markdown | Comment |
| Văn bản thường | text/plain | Omit | Đọc trường gốc trong thiết bị cuối |
| Văn bản + Markdown | text/plain | markdown | Đang đọc siêu dữ liệu và Markdown cùng nhau |


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

## Ví dụ về việc yêu cầu và đáp ứng

Những thẻ tab này cũng hiển thị như vậy Google Search trong mỗi hình thức. Dùng Bash và cURL 7.76+ với FLASHDATA_API_KEY đặt thành một khóa cho phép google_search. Đang chạy một lệnh đệ trình tìm kiếm có thể tính được.

### JSON

Mặc định. Phân tích các kết quả; các lĩnh vực bên trong nó phụ thuộc vào nguồn.

#### Yêu cầu · 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"}'
```

#### Name

```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

Đọc nội dung như một chuỗi Markdown. Nó thay thế kết quả; nguồn, trạng thái và sử dụng vẫn còn sẵn có như JSON Cánh đồng.

#### Yêu cầu · 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"}'
```

#### Name

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


### Văn bản thường

Hãy đọc câu trả lời trong phần Kinh Thánh. Nó chứa các trường gốc trong một bố trí đã nhận diện, không phải tài liệu JSON.

#### Yêu cầu · 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"}'
```

#### Name

```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"
```


### Văn bản + Markdown

Đọc câu trả lời là văn bản: Siêu dữ liệu trước, tiếp theo là nội dung của Markdown.

#### Yêu cầu · 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"}'
```

#### Name

```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 Xác thực](https://flashdata.dev/vi/docs/guides/headers-and-authentication/reference.md)
- [Google Search Trường đáp ứng](https://flashdata.dev/vi/docs/sources/google_search/reference.md#response)

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

## Đã hỗ trợ điểm kết thúc

Luật tương tự cũng áp dụng cho Google Search và YouTube Nguồn truy vấn. Đối với YouTube Download, họ định dạng kỷ lục giao hàng, không phải video hoặc âm thanh byte. Tài khoản APIs, Bulk Bản kê khai và NDJSON phần, cuộc gọi lại và MCP Phản hồi sử dụng định dạng riêng của họ.

| Điểm kết thúc | JSON / plain text | Markdown Nội dung |
| --- | --- | --- |
| POST /v1/queries/realtime | Đã hỗ trợ | Đã hỗ trợ |
| GET /v2/jobs/{id}/results | Đã hỗ trợ | Đã hỗ trợ |
| POST /v1/queries | Hóa đơn phục tùng | Bỏ qua — chọn khi đọc kết quả |
| POST /v1/queries/batch | Hóa đơn phục tùng | Bỏ qua — chọn khi đọc kết quả |
| GET /v2/jobs/{id} | Trạng thái công việc | Bỏ qua — không có nội dung ở đây |


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

## Định dạng kết quả công việc hoàn tất

Khi đọc kết quả, hãy chọn người dẫn đầu, ngay cả khi bạn quy định họ phải vâng phục. Đặt JOB_ID thành một công việc hoàn tất bạn có thể truy cập. Cái này GET đọc kết quả đã có mà không gửi một yêu cầu khác.

| Định dạng đã yêu cầu | Phản ứng kết quả |
| --- | --- |
| gốc JSON | 302 với một kho lưu trữ có chữ ký URL ở địa điểm. Hãy phân chia URL, mà không cần X-API-Key. Kết quả đã lưu có thể bị gzip-compress. |
| Văn bản thường hoặc không Markdown tùy chọn | 200 với thông tin cơ thể trực tiếp trả lời. |

### Lấy lại Markdown bên trong JSON · 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'
```

- [Lấy lại gốc JSON · Python và cURL](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#results)

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

## Lỗi định dạng

API lỗi còn lại JSON hay application/problem+json, ngay cả khi bạn yêu cầu văn bản đơn giản. Kiểm tra trạng thái HTTP trước khi phân tích định dạng thành công.

| Trạng thái / mã | Sửa |
| --- | --- |
| 400 · unsupported_representation | Dùng X-Respond-With: đánh dấu xuống hoặc loại bỏ đầu trang. Không hỗ trợ giá trị như json hoặc văn bản. |
| 406 · not_acceptable | Dùng Accept: application/json hay text/plain. text/markdown và application/xml không được hỗ trợ. |

- [Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md)

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

## Accept chi tiết đầu trang

Omit Accept hoặc gửi ** để nhận JSON. Đáp ứng được dùng UTF-8. Phạm vi phương tiện và cân Q được hỗ trợ; một bộ ký tự không được hỗ trợ 406 Trừ khi có một phạm vi có thể chấp nhận được. Content-Type: application/json miêu tả cơ thể yêu cầu, chứ không phải phản ứng.

### Thích văn bản, cho phép JSON

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

