---
title: Beispiele für Anfragen und Antworten
description: Erfahren Sie, wie Sie APIs mit RequestExample- und ResponseExample-Komponenten anhand eines praktischen Acme-Support-Ticket-Workflows dokumentieren.
api: GET /tickets/{ticket_id}
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Verwenden Sie `RequestExample` und `ResponseExample`, um die praktische API-Nutzung zusammen mit Ihrer Endpoint-Dokumentation zu zeigen. Die Komponenten unterstützen mehrere Programmiersprachen, Antwortstatus und Inline-Erklärungen.

## Beispiel: Support-Ticket abrufen

Dieses Beispiel dokumentiert einen einfachen `GET /tickets/{ticket_id}`-Endpoint für die Acme Support API.

### Anfrage

Verwenden Sie Parameterfelder, um zu beschreiben, was der Endpoint erwartet. Das Codebeispiel befindet sich in der rechten Seitenleiste.

<ParamField path="ticket_id" type="string" required>
  Eindeutige Ticket-ID, die bei der Erstellung des Tickets zurückgegeben wurde.
</ParamField>

<RequestExample>
```bash cURL
curl -X GET https://api.acme.com/v1/tickets/tkt_9S8L2 \
  -H "Authorization: Bearer $ACME_TOKEN"
```

```python Python
import requests

response = requests.get(
    "https://api.acme.com/v1/tickets/tkt_9S8L2",
    headers={"Authorization": f"Bearer {ACME_TOKEN}"}
)

ticket = response.json()
print(ticket["id"])
```

```javascript JavaScript
const response = await fetch("https://api.acme.com/v1/tickets/tkt_9S8L2", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.ACME_TOKEN}`,
  }
});

const ticket = await response.json();
console.log(ticket.id);
```

```go Go
package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.acme.com/v1/tickets/tkt_9S8L2", nil)
  req.Header.Set("Authorization", "Bearer ACME_TOKEN")

  resp, _ := (&http.Client{}).Do(req)
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}
```

```ruby Ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI("https://api.acme.com/v1/tickets/tkt_9S8L2")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer ACME_TOKEN"

response = http.request(request)
puts JSON.parse(response.body)
```

```csharp C#
using System.Net.Http;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer ACME_TOKEN");

var response = await client.GetAsync("https://api.acme.com/v1/tickets/tkt_9S8L2");
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
```

```java Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.acme.com/v1/tickets/tkt_9S8L2"))
    .header("Authorization", "Bearer ACME_TOKEN")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

```rust Rust
#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
    let client = reqwest::Client::new();

    let response = client
        .get("https://api.acme.com/v1/tickets/tkt_9S8L2")
        .header("Authorization", "Bearer ACME_TOKEN")
        .send()
        .await?;

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}
```

```php PHP
<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.acme.com/v1/tickets/tkt_9S8L2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ACME_TOKEN']);

$response = curl_exec($ch); curl_close($ch);

echo $response;
```
</RequestExample>

### Antwort

Verwenden Sie Antwortfelder, um die wichtigsten von der API zurückgegebenen Attribute zu dokumentieren.

<ResponseField name="id" type="string" required>
  Eindeutige Ticket-ID.
</ResponseField>

<ResponseField name="status" type="string">
  Aktueller Ticketstatus (`open`, `pending` oder `resolved`).
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO-8601-Zeitstempel der Ticketerstellung.
</ResponseField>

<ResponseExample>
```json 200: OK
{
  "id": "tkt_9S8L2",
  "customer_id": "cus_2X9W8",
  "subject": "Export stuck on step 3",
  "priority": "high",
  "status": "open",
  "created_at": "2026-02-04T16:12:00Z"
}
```

```json 404: Not found
{
  "code": "not_found",
  "message": "ticket_id does not exist"
}
```
</ResponseExample>

## Tipps

- Fügen Sie mindestens eine erfolgreiche Antwort und eine Fehlerantwort hinzu.
- Verwenden Sie realistische IDs und Zeitstempel, damit die Beispiele realistisch wirken.
- Halten Sie Payloads minimal, damit Leser sie schnell überfliegen können.

## Verwandte Seiten

<Columns cols={2}>
  <Card title="API Playground" icon="flask-vial" href="/de/api-reference/playground">
    Aktivieren Sie interaktive API-Tests auf Ihren Endpoint-Seiten
  </Card>
  <Card title="OpenAPI Example" icon="plug" href="/de/api-reference/openapi-example">
    Sehen Sie eine automatisch generierte Endpoint-Seite
  </Card>
</Columns>

<Columns cols={2}>
  <Card title="Examples Component" icon="code" href="/de/components/examples">
    Erfahren Sie mehr über die Component-Props und Formatierungsregeln
  </Card>
  <Card title="Fields Component" icon="list-check" href="/de/components/fields">
    Dokumentieren Sie Anfrage- und Antwortschemas
  </Card>
</Columns>

---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://jamdesk-docs.jamdesk.app/api-specs.zip