Zum Hauptinhalt springen
POST
/
v1
/
answers
Antwort erstellen
curl --request POST \
  --url https://api.olostep.com/v1/answers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task": "<string>",
  "json_format": {}
}
'
{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "metadata": {},
  "task": "<string>",
  "result": {
    "json_content": "<string>",
    "json_hosted_url": "<string>"
  }
}

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

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

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

{
  "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:
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”.

Autorisierungen

Authorization
string
header
erforderlich

Bearer-Authentifizierungsheader in der Form Bearer , wobei dein Authentifizierungstoken ist.

Body

application/json
task
string
erforderlich

Die auszuführende Aufgabe.

json_format
object

Das gewünschte Ausgabe-JSON-Objekt mit leeren Werten als Schema, oder beschreibe einfach die Daten, die du als String haben möchtest.

Antwort

Erfolgreiche Antwort mit der Lösung.

id
string
object
string
created
integer
metadata
object
task
string
result
object