OpenAPI 3- readOnly属性，但允许在POST/PUT中写入

OpenAPI 3是一种用于描述和定义RESTful API的规范，readOnly属性是OpenAPI规范中的一个属性，用于指示某个字段是否只读。当readOnly属性为true时，表示该字段只能被读取，不能被写入。但是，在某些情况下，我们可能希望在POST或PUT请求中允许写入该字段。

在OpenAPI 3中，我们可以通过以下方式实现readOnly属性，同时允许在POST/PUT中写入：

1. 使用readOnly属性：在API的请求体参数中，将需要设置为readOnly的字段的readOnly属性设置为true。这样，在GET请求中，该字段将只能被读取，而在POST/PUT请求中，该字段可以被写入。例如：

parameters:
  - name: id
    in: path
    description: ID of the object
    required: true
    schema:
      type: integer
      format: int64
      readOnly: true

1. 使用writeOnly属性：在某些情况下，我们可能希望在POST/PUT请求中写入字段，但在GET请求中不返回该字段的值。这时，我们可以使用writeOnly属性。writeOnly属性与readOnly属性相反，表示该字段只能被写入，不能被读取。例如：

parameters:
  - name: password
    in: query
    description: User password
    required: true
    schema:
      type: string
      writeOnly: true

通过使用readOnly属性或writeOnly属性，我们可以灵活地控制API中字段的读写权限，以满足不同的业务需求。

关于OpenAPI 3的更多信息和详细规范，请参考腾讯云的API网关产品，该产品提供了完善的OpenAPI 3支持和解决方案。具体产品介绍和文档可以在腾讯云官网找到：腾讯云API网关。