# Yanıt biçimleri

Uygulamanız veya Markdown içeriğiniz için yapılandırılmış JSON'u bir AI ajanı için seçin. Yanıtı iki başlıkla kontrol edin.

Canonical referans: https://flashdata.dev/tr/docs/guides/response-formats
İnceleme: 2026-11-04 Tarafından FlashData

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

## Bir format seçin

JSON orijinal sonuç alanları ile varsayılandır. Accept, JSON veya düz metin seçer; X-Respond-With: işaretlenme sonucu içeriği Markdown'ye dönüştürür. İstek vücudunuz JSON'u kalır.

| Yanıt | Accept | X-Respond-With | Kullanım için kullanım |
| --- | --- | --- | --- |
| JSON | application/json | Omit | Koddaki alanların belirlenmesi · varsayılan |
| JSON + Markdown | application/json | markdown | yapılandırılmış metadata ile Agent context with configured metadatata |
| Düz metin çevirisi | text/plain | Omit | Bir terminalde orijinal alanları okumak |
| Text + Markdown | text/plain | markdown | Metadata ve Markdown ile birlikte okumak |


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

## İstek ve yanıt örnekleri

Bu sekmeler her formatta aynı Google Search'u gösteriyor. Bash ve cURL 7.76+ ile FLASHDATA_API_KEY, google_search'ye izin veren bir anahtara işaret ediyor. Bir komutla çalıştırılabilir bir arama gönderir.

### JSON

Varsayılan olarak. Sonuçlar dizisini özetler; içindeki alanlar kaynağa bağlıdır.

#### İstek · 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"}'
```

#### Örnek yanıt · illüstrasyonel değerler

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

Bir Markdown dizesi olarak içeriği okuyun. Sonuçları değiştirir; kaynak, durum ve kullanım JSON alanları olarak kullanılabilir.

#### İstek · 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"}'
```

#### Örnek yanıt · illüstrasyonel değerler

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


### Düz metin çevirisi

Yanıtı metin olarak okuyun. Orijinal alanları bir indented düzende içeriyor, bir JSON belgesi değil.

#### İstek · 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"}'
```

#### Örnek yanıt · illüstrasyonel değerler

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


### Text + Markdown

Yanıtı metin olarak okuyun: metadata ilk olarak, Markdown içerik tarafından takip edildi.

#### İstek · 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"}'
```

#### Örnek yanıt · illüstrasyonel değerler

```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 doğrulama](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)
- [Google Search yanıt alanları](https://flashdata.dev/tr/docs/sources/google_search/reference.md#response)

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

## Desteklenen uç noktaları

Aynı kurallar Google Search ve YouTube sorgu kaynaklarına uygulanır. YouTube Download için, teslimat rekorunu formatlıyorlar, video veya ses totes değil. Hesap API'leri, Bulk ve NDJSON parçalar, çağrılar ve MCP yanıtları kendi formatlarını kullanır.

| Endpoint | JSON / düz metin | Markdown content |
| --- | --- | --- |
| POST /v1/queries/realtime | Desteklendi Desteklendi | Desteklendi Desteklendi |
| GET /v2/jobs/{id}/results | Desteklendi Desteklendi | Desteklendi Desteklendi |
| POST /v1/queries | Submission mak | Ignored – sonuçları okurken onu seçin |
| POST /v1/queries/batch | Submission mak | Ignored – sonuçları okurken onu seçin |
| GET /v2/jobs/{id} | İş durumu | Ignored - burada içerik yok |


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

## Tamamlanan bir iş sonucu

Sonuç okuduğunuz zaman kafaları ayarlayın, hatta onları teslim etmeye ayarlarsanız. JOB_ID'u erişebileceğiniz tamamlanmış bir iş için ayarlayın. Bu GET, başka bir sorgu sunmadan mevcut sonuçları okur.

| İstekli format | Son yanıt |
| --- | --- |
| Orijinal JSON | 302 İmzalanan bir depolama ile URL Konum olarak. URL'un X-API-Key olmadan ayrı olduğunu. Mağazalı sonuçlar gzip-comed olabilir. |
| Plain text veya Markdown seçeneği | 200, doğrudan yanıtda biçimlenen bedenle. |

### Markdown içinde 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'
```

- [Orijinal JSON · Python ve cURL](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)

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

## Biçim hataları

API hataları JSON veya application/problem+json, düz metin talep ettiğinizde bile kalır. Başarı biçimini reddetmeden önce HTTP statüsünü kontrol edin.

| Durum / kod | Fix Fix |
| --- | --- |
| 400 · unsupported_representation | X-Respond-With'u kullanın: işaret ya da başlığı omit. json veya metin gibi değerler desteklenmez. |
| 406 · not_acceptable | Accept: application/json veya text/plain. text/markdown ve application/xml desteklenmez. |

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md)

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

## Accept başlık detayları

Omit Accept veya * JSON'u almak için gönder. Yanıtlar UTF-8'u kullanır. Medya aralıkları ve q ağırlıkları destekleniyor; desteklenmeyen bir karset, başka bir kabul edilebilir aralık maçları olmadıkça 406'yu geri döndürür. Content-Type: application/json, istek cesedini tarif eder, cevap vermez.

### Yazıyı tercih edin, JSON

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

