Eine deterministische version der JSON-schema-Objekt
Ich versuche, mit der Swagger-Editor erstellen Sie eine benutzerdefinierte JSON/YAML für meine API. Grundsätzlich möchte ich beschreiben, eine POST-Anforderung an einen Endpunkt mit Accept
und Content-Type
- Header und POST-Daten in form von JSON wie in der folgenden Vorlage {"document": "Some text paragraph", "documentType": "text/plain"}
.
Dies ist mein swagger.yml-Datei
swagger: '2.0'
info:
title: Random title
description: Blah blah
version: 1.2.3
host: endpoint.com
schemes:
- https
securityDefinitions:
basicAuth:
type: basic
description: HTTP Basic Authentication.
basePath: /v1
paths:
'/{pipelineID}':
parameters:
- $ref: '#/parameters/pipelineID'
post:
summary: Hello world
description: World hello
security:
- basicAuth: []
consumes:
- application/json
produces:
- application/json
tags:
- TextAnnotation
parameters:
- name: body
in: body
description: JSON
required: true
schema:
- $ref: "#/definitions/json"
- name: Accept
in: header
required: true
- name: Content-Type
in: header
required: true
responses:
'200':
description: OK
'400':
description: Bad request
'401':
description: Unauthorized
'500':
description: Internal Server Error
parameters:
pipelineID:
name: pipelineID
description: Pipeline ID
in: path
type: string
required: true
definitions:
json:
- type: ServiceRequest
properties:
- "document":
- type: string
"documentType":
- type: string
Swagger-editor Fehler:
Swagger Error
A deterministic version of a JSON Schema object.
Jump to line 59
Zeile 59 ist, wo die Definitionen beginnen, genauer gesagt json
Was mache ich falsch?
Du musst angemeldet sein, um einen Kommentar abzugeben.
Ich gefunden habe, der Kerl in diesem. Hier ist die absolut gültige und funktionierende JSON -
hervorbringt, die richtige curl Anfrage.
required
Feld, das ist, warum der editor einen Fehler gab