开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

社区首页 >问答首页 >或身体属性和多个示例

问或身体属性和多个示例
EN

Stack Overflow用户

提问于 2019-11-01 10:42:08

回答 1查看 314关注 0票数 0

我是RAML的新手，最近继承了一个我需要更新以反映新规范的项目。

这是一个相当简单的RAML文档，我所做的就是添加一个新的body属性，我想展示多个示例。

以前，有一个"codeType1“属性，这是该职位所需的。

现在，有一个新的"codeType2“属性，其中一个是必需的。因此，无论是codeType1还是codeType2，都必须在post主体中。我不知道怎么用RAML来表达这个要求。

另外，我希望有两个例子，为每一种情况。

我能够添加新的codeType，但我不知道如何表达验证规则。

这就是我目前的情况：

#%RAML 1.0
title: Auth Service
version: v1
protocols: [HTTPS]
mediaType: application/json

/auth:
    post:
      description: Authenticate a client to the API.
      body:
        application/json:
          properties:
            {
            "codeType1": {
                type: string,
                required: true
              },
            "codeType2":{
                type: string,
                required: true
              },
            "userId":{
                type: string,
                required: true
              },
            "password":{
                type: string,
                required: true
              },
            }
          example:
            {
              "codeType1":"994056",
              "codeType2":"##0023",
              "userId":"name@email.com",
              "password":"Abc123!",
            }
      responses:
        200:
          description: Successful authentication.
          body:
            application/json:
              example:
                {
                  "status": "success",
                  "message": "Authentication success",
                  "data": {
                    "token": "SDKFHDSLFDJSFDKJFDHSFLJKFHLSKFSFLKFLSDFJHSLHFSDF"
                  }
                }

EN

回答 1

Stack Overflow用户

回答已采纳

发布于 2019-11-10 13:41:57

试试这个：

#%RAML 1.0
title: Auth Service
version: v1
protocols: [HTTPS]
mediaType: application/json

types:
  UserCred:
    properties:
      userId:
      password:
  Type1:
    type: UserCred
    properties:
      codeType1:
  Type2:
    type: UserCred
    properties:
      codeType2:

/auth:
    post:
      description: Authenticate a client to the API.
      body:
        application/json:
          type: Type1 | Type2
          examples:
            ex1: 
              codeType1: "994056"
              userId: "name@email.com"
              password : "Abc123!"
            ex2:
              codeType2: "12345"
              userId: "anothername@email.com"
              password: "ZYX098"

我只是复制了我换过的部分。

下面是我在上面使用的RAML 1.0规范中的几个引用：

联合类型
下面是一个为queryString设置互斥类型的示例适用于您试图完成的任务。

票数 0

EN

页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持

原文链接：

https://stackoverflow.com/questions/58664277

复制

相关文章

Django批量更新多个属性

数据库 model 数据

有时候我们需要同时（一次性）更新某个用户的多条属性。 1. 用户model如下： class User(models.Model): UID = models.CharField('员工uid', max_length=200,) name = models.CharField('员工名字', max_length=200,) mobile = models.CharField('手机号', max_length=200,) mail = models.EmailField(u'邮箱', max_lengt

BigYoung小站

2020/05/04

2.1K0

@keyframes 属性——动画示例

identifier percentage 动画语法

用途 @keyframes 动画可以根据帧定制不同的动画效果语法 @keyframes <identifier> { [ [ from | to | <百分比> ] [, from | to | <百分比> ]* block ]* } 值值描述 identifier 帧列表的名称。名称必须符合 CSS 语法中对标识符的定义。 from 起始时间，等效0%。 to 结束时间，等效100%。 <percentage> 动画序列中，触发关键帧的时间点，使用百分值来表示。例子 /*

Html5知典

2019/11/26

7540

第61天：json遍历和封装运动框架（多个属性）

var json = {width:200,height:300,left:50} console.log(json.width); for(var k in json) { console.log(k); // k 遍历的是json 可以得到的是属性 console.log(json[k]); // json[k] 得到是属性的值 }

半指温柔乐

2018/09/11

6320

第61天：json遍历和封装运动框架（多个属性）

JS示例05-style行间样式和class属性样式

1、行间样式优先级高于class属性样式（设置过行间样式后，再设置属性样式则无效） 2、对同一个元素只采用一种属性控制方式（要不是行间样式，要不是class样式），不要混用

专注APP开发

2019/11/07

9.9K0

JS示例05-style行间样式和class属性样式

tomcat不能运行或共存多个项目

我在Tomcat下部署了两个项目,但是一个可以运行,另一个不可以,第一感觉是内存问题,给tomcat多分配了内存.但是没有作用. 原因是少了webAppRootKey这个参数，需要在各自的web.xml下添加 <context-param> <param-name>webAppRootKey</param-name> <param-value>socialmedia</param-value> </context-param> 但是我添加后，只能运行一个，其他两个运行不了。原

冷冷

2018/02/08

9920

transition-property 属性 ——动画示例

用途 transition-property 规定应用过渡效果的 CSS 属性的名称。（当规定的 CSS 属性改变时，过渡效果将开始）。

Html5知典

2019/11/26

4270

animation-duration 属性——动画示例

animation duration time 动画语法

animation-duration 规定动画完成一个周期所花费的秒或毫秒。默认是 0。

Html5知典

2019/11/26

5340

animation-direction 属性——动画示例

animation reverse 动画

animation-direction 规定动画是否在下一周期逆向地播放。默认是 “normal”。

Html5知典

2019/11/26

4350

transition-delay 属性——动画示例

delay time transition 动画语法

transition-delay 规定动画在过渡效果开始等待的时间。值以秒（s）或毫秒（ms）为单位，表明动画过渡效果将在何时开始。取值为正时会延迟一段时间来响应过渡效果；取值为负时会导致过渡立即开始。

Html5知典

2019/11/26

6370

transition-duration 属性——动画示例

duration time transition 动画语法

transition-duration 属性以秒或毫秒为单位规定过渡动画所需的时间。默认值为 0s ，表示不出现过渡动画。

Html5知典

2019/11/26

6800

animation-name 属性——动画示例

animation identifier 动画语法

用途 animation-name 规定 @keyframes 动画的名称语法 animation-name: none; animation-name: identifier; 值值描述 none 特殊关键字，表示无关键帧。 identifier 动画名称。名称必须符合CSS语法中标识的定义。例子 /* HTML */ <div class="stage"> <figure class="ball"></figure> </div> /* CSS */ @keyfra

Html5知典

2019/11/26

3850

animation-delay 属性——动画示例

animation delay time 动画语法

animation-delay 规定动画何时开始。默认是 0。即从动画应用在元素上到动画开始的这段时间的长度。

Html5知典

2019/11/26

6940

实现一个启动多个jar或多个服务的脚本

jar html https shell ubuntu

在一开始，我选择了参考网上所说的定义一个rc.local文件，修改/etc/rc.local,但发现这种方法可以实现自启动脚本，但是通常只能启动一个服务，然后后面的服务就不能启动了。这个是因为自己做了实验发现的。

路行的亚洲

2021/08/20

4.5K0

XML创建或改变某个新属性

通常情况下，xml都是和数据库一起使用。今天在修改bug的时候，发现需要新增几个属性。翻了下w3c，找到setAttribute. 定义和用法： setAttribute() 方法创建或改变某个新属性。语法：elementNode.setAttribute(name,value) 参数： name value 描述： name 必需，规定要设置的属性名；value 必需，规定要设置的属性值。说明: 该方法把指定的属性设置为指定的值。如果不存在具有指定名称的属性，该方法将创建一个新属性。例如：

Vicsh

2018/05/16

1K0

transition-timing-function 属性——动画示例

bezier function timing transition 语法

transition-timing-function 规定过渡效果的速度曲线。

Html5知典

2019/11/26

5150

replaceAll()如何同时替换多个不同的字符串（或多个符号）

正好我遇到过这个情况，就跟她分享了一下心得，解决问题后的她开心的像刚充完气儿一样。

陈哈哈

2020/07/03

5.7K0

[异常专栏]多个module打包异常提示BuildConfig属性重复

因为项目需要，有个业务需求需要一个app，改改主题，图片等将一个app打包三个，于是我就通过类似批量多渠道的方式将不同项目的资源放于多个不同的module中，打包时gradler中加了判断，打包出不同app。但是无独有偶，打包正式包的时候出现了如下错误，但是debug包运行无恙，找度娘半天各种解决的方法也有，都说是重复依赖包，于是检查了一遍每一个依赖，排除了这个原因后还是无法打包，问题依旧是这个，终于找到一个老哥的解决方法受到启发解决Program type already present: com.baidu.idl.facesdk.BuildConfig 是不是我的清单文件多个中也是，package这个配置出了重复呢？全局搜索检查，还真是，打包运行ok...

木溪bo

2020/06/18

2.4K0

[异常专栏]多个module打包异常提示BuildConfig属性重复

Python异或运算符示例

我们在异或运算的过程中根据异或门的逻辑来看，因为数都是成对的，那么成对的数在异或过程中都会被消耗掉，只有单独存在的一个数不会被配对消耗掉，故而可以留存到最后。

红目香薰

2022/11/30

6900

点击加载更多

相似问题

中心身体和多个图像？

10

对象属性swagger的多个示例

117

如何获取身体长度或任何身体数据？

11

“球”对象没有属性“身体”

11

Winsockets身体之前和/或之后的奇怪字符

19

添加站长进交流群

领取专属 10元无门槛券

AI混元助手 在线答疑

关注 腾讯云开发者公众号

洞察 腾讯核心技术

剖析业界实践案例