# Antwoordformaten

Kies gestructureerde JSON voor uw toepassing of Markdown-inhoud voor een AI-agent. Controleer de reactie met twee headers.

Canonische referentie: https://flashdata.dev/nl/docs/guides/response-formats
Beoordeeld: 2026-11-04 door FlashData

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

## Kies een formaat

JSON met originele resultaatvelden is de standaard. Accept selecteert JSON of platte tekst; X-Respond-With: markdown converteert het resultaat naar Markdown. Uw aanvraag lichaam blijft JSON.

| Antwoord | Accept | X-Respond-With | Gebruik voor |
| --- | --- | --- | --- |
| JSON | application/json | Omit | Velden ontleden in code · standaard |
| JSON + Markdown | application/json | markdown | Agent context met gestructureerde metadata |
| Gewone tekst | text/plain | Omit | Originele velden in een terminal lezen |
| Tekst + Markdown | text/plain | markdown | Metadata en Markdown samen lezen |


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

## Vraag- en antwoordvoorbeelden

Deze tabbladen tonen dezelfde Google Search in elk formaat. Gebruik Bash en cURL 7.76+ met FLASHDATA_API_KEY ingesteld op een sleutel waarmee google_search. Het uitvoeren van een commando dient een factureerbare zoekopdracht in.

### JSON

Standaard. Ontleden van de resultaten array; de velden in het afhankelijk van de bron.

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

#### Voorbeeld respons · illustratieve waarden

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

Lees inhoud als een Markdown string. Het vervangt resultaten; bron, status en gebruik blijven beschikbaar als JSON velden.

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

#### Voorbeeld respons · illustratieve waarden

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


### Gewone tekst

Lees het antwoord als tekst. Het bevat de originele velden in een ingespringde lay-out, geen JSON document.

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

#### Voorbeeld respons · illustratieve waarden

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


### Tekst + Markdown

Lees het antwoord als tekst: metadata eerst, gevolgd door Markdown inhoud.

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

#### Voorbeeld respons · illustratieve waarden

```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-authenticatie](https://flashdata.dev/nl/docs/guides/headers-and-authentication/reference.md)
- [Google Search-responsvelden](https://flashdata.dev/nl/docs/sources/google_search/reference.md#response)

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

## Ondersteunde eindpunten

Dezelfde regels gelden voor Google Search en YouTube query sources. Voor YouTube Download formatteren ze de leveringsrecord, niet de video of audio bytes. Account API's, Bulk manifesten en NDJSON delen, callbacks en MCP antwoorden gebruiken hun eigen formaten.

| Eindpunt | JSON / platte tekst | Markdown-inhoud |
| --- | --- | --- |
| POST /v1/queries/realtime | Ondersteund | Ondersteund |
| GET /v2/jobs/{id}/results | Ondersteund | Ondersteund |
| POST /v1/queries | Ontvangst van de indiening | Negeer het bij het lezen van de resultaten |
| POST /v1/queries/batch | Ontvangst van de indiening | Negeer het bij het lezen van de resultaten |
| GET /v2/jobs/{id} | Functiestatus | Negeer hier geen inhoud van het resultaat |


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

## Formatteer een voltooid taakresultaat

Stel de headers in bij het lezen van het resultaat, zelfs als je ze bij het indienen van de headers instelt. Stel JOB_ID in op een voltooide baan waar u toegang tot kunt krijgen. Deze GET leest bestaande resultaten zonder een andere query in te dienen.

| Aangevraagd formaat | Resultaatrespons |
| --- | --- |
| Originele JSON | 302 met een ondertekende opslag URL in Locatie. Haal die URL apart op, zonder X-API-Key. De opgeslagen resultaten kunnen gzip-gecomprimeerd zijn. |
| Gewone tekst of een Markdown-optie | 200 met de geformatteerde body direct in het antwoord. |

### Markdown ophalen binnen 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'
```

- [Originele JSON · Python en cURL ophalen](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#results)

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

## Formaatfouten

API-fouten blijven JSON of application/problem+json, zelfs wanneer u om platte tekst verzoekt. Controleer de HTTP-status voordat u het succesformaat ontleedt.

| Status / code | Repareren |
| --- | --- |
| 400 · unsupported_representation | Gebruik X-Respond-With: markeer of laat de header weg. Waarden zoals json of tekst worden niet ondersteund. |
| 406 · not_acceptable | Gebruik Accept: application/json of text/plain. text/markdown en application/xml worden niet ondersteund. |

- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md)

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

## Accept header details

Accept of stuur */* om JSON te krijgen. Antwoorden gebruiken UTF-8. Mediabereiken en q-gewichten worden ondersteund; een niet-ondersteunde tekenset geeft 406 terug, tenzij een ander aanvaardbaar bereik overeenkomt. Content-Type: application/json beschrijft het verzoek, niet het antwoord.

### Voorkeur voor tekst, laat JSON

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

