Форма сообщения Anypoint Studio Raml

У меня есть файл RAML, который я использую для создания рабочего процесса для APIkit. Я хочу создать «пользователя» с помощью метода «/ users» с использованием Http Method POST, но я могу заставить работать только параметр запроса, я хочу сделать это с помощью параметров формы. Может ли кто-нибудь показать, как сделать почтовую форму с помощью RAML 1.0?

Ниже приведен мой файл RAML:

    #%RAML 1.0
---
title: User Resource API
version: 1.0.development
baseUri: http://localhost:8080/jaxrs-example/api/userResource
protocols: [HTTP]
mediaType: application/json
documentation:   
  - title: Home
    content: |
      This is the UserResource manager API docucumentation.  This api allows you
      to add, update and perform other operations on the User API.
types:
  User:
    type: object
    properties:
      firstname: string
      lastname: string
      id: integer
  Firstname:
    type: string
  Lastname:
    type: string  
/users:
  get:
    description: get all users in a collection
    responses: 
      200:
        body:
          application/json: 
            type: User[]
  post:
    description: add user to collection
    body:           
    queryParameters: 
      firstname: string
      lastname: string

person Sonam    schedule 27.05.2016    source источник


Ответы (1)


formParameters больше не существует в RAML 1

Просто укажите тип сообщения в теле сообщения, например:

...
post:
  body:
    type: User
...
person Pedro    schedule 30.05.2016
comment
Я использую консоли APIKit для тестирования. Я получаю текстовое поле для ввода текста. Я ожидал нескольких форм ввода для имени и фамилии. Знаете ли вы, есть ли хороший учебник / демонстрация, показывающая, как это сделать с помощью APIKit, используя RAML 1.0? - person Sonam; 31.05.2016
comment
Извините, я не знаком с APIKit, думаю, он ожидает объект JSON: {firstname: John, lastname: foo, id: 1} - person Pedro; 31.05.2016