> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Antwort erstellen

> Die KI wird Aktionen wie das Suchen und Durchsuchen von Webseiten ausführen, um die Antwort auf die gestellte Aufgabe zu finden. Die Ausführungszeit beträgt 3-30 Sekunden, abhängig von der Komplexität.  Für längere Aufgaben verwende stattdessen den Agenten-Endpunkt. Siehe [Agenten-Funktion](/features/agents). Siehe [Antworten-Funktion](/features/answers).

## Antwort erstellen

Mit dem Endpunkt `POST /v1/answers` kannst du eine neue Antwort in deinem System erstellen. Dieser Endpunkt erwartet ein JSON-Objekt mit den erforderlichen Details der Antwort.

### Anfrage

* **Methode**: `POST`
* **URL**: `/v1/answers`
* **Header**:
  * `Content-Type`: `application/json`
  * `Authorization`: `Bearer <your-token>`

#### Anfragekörper

```json theme={null}
{
  "question_id": "string",
  "content": "string",
  "author": "string"
}
```

* `question_id`: Die ID der Frage, auf die du antwortest.
* `content`: Der Inhalt der Antwort.
* `author`: Der Name des Autors der Antwort.

### Antwort

Bei erfolgreicher Erstellung einer Antwort erhältst du eine Antwort mit dem HTTP-Statuscode `201 Created` und den Details der neu erstellten Antwort.

#### Erfolgreiche Antwort

```json theme={null}
{
  "id": "string",
  "question_id": "string",
  "content": "string",
  "author": "string",
  "created_at": "string"
}
```

* `id`: Die eindeutige ID der Antwort.
* `created_at`: Das Datum und die Uhrzeit, zu der die Antwort erstellt wurde.

### Fehler

Falls ein Fehler auftritt, erhältst du eine Antwort mit einem entsprechenden HTTP-Statuscode und einer Fehlermeldung.

#### Fehlerantwort

```json theme={null}
{
  "error": "string",
  "message": "string"
}
```

* `error`: Der Fehlercode.
* `message`: Eine Beschreibung des Fehlers.

### Beispiel

Hier ist ein Beispiel, wie du eine Antwort mit `curl` erstellen kannst:

```bash theme={null}
curl -X POST https://api.olostep.com/v1/answers \
-H "Authorization: Bearer <your-token>" \
-H "Content-Type: application/json" \
-d '{
  "question_id": "12345",
  "content": "Das ist eine Beispielantwort.",
  "author": "Max Mustermann"
}'
```

Dieses Beispiel zeigt, wie du eine Antwort für die Frage mit der ID `12345` erstellst, mit dem Inhalt "Das ist eine Beispielantwort." und dem Autor "Max Mustermann".


## OpenAPI

````yaml de/openapi/answers.json POST /v1/answers
openapi: 3.0.3
info:
  title: Antworten-API
  version: 1.0.0
servers:
  - url: https://api.olostep.com
security: []
paths:
  /v1/answers:
    post:
      summary: Antwort erstellen
      description: >-
        Die KI wird Aktionen wie das Suchen und Durchsuchen von Webseiten
        ausführen, um die Antwort auf die gestellte Aufgabe zu finden. Die
        Ausführungszeit beträgt 3-30 Sekunden, abhängig von der Komplexität. 
        Für längere Aufgaben verwende stattdessen den Agenten-Endpunkt. Siehe
        [Agenten-Funktion](/features/agents). Siehe
        [Antworten-Funktion](/features/answers).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                task:
                  type: string
                  description: Die auszuführende Aufgabe.
                json_format:
                  type: object
                  description: >-
                    Das gewünschte Ausgabe-JSON-Objekt mit leeren Werten als
                    Schema, oder beschreibe einfach die Daten, die du als String
                    haben möchtest.
              required:
                - task
      responses:
        '200':
          description: Erfolgreiche Antwort mit der Antwort.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  object:
                    type: string
                  created:
                    type: integer
                  metadata:
                    type: object
                  task:
                    type: string
                  result:
                    type: object
                    properties:
                      json_content:
                        type: string
                      json_hosted_url:
                        type: string
        '400':
          description: Ungültige Anfrage (Fehlende Aufgabe)
        '402':
          description: Ungültiger API-Schlüssel
        '500':
          description: Interner Serverfehler
      security:
        - Authorization: []
components:
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: >-
        Bearer-Authentifizierungsheader in der Form Bearer <token>, wobei
        <token> dein Authentifizierungstoken ist.

````