https://github.com/devigned/bond-openapi-annotation-sample

https://github.com/devigned/bond-openapi-annotation-sample

Last synced: 12 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/devigned/bond-openapi-annotation-sample
• Owner: devigned
• License: mit
• Created: 2016-11-01T17:32:27.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2016-11-08T16:08:30.000Z (over 9 years ago)
• Last Synced: 2025-02-06T12:13:37.978Z (about 1 year ago)
• Language: JavaScript
• Size: 5.86 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Bond / Swagger (OpenAPI) Attribute Sample

This sample shows a snippet of Bond IDL which expresses data annotations converted to

a sample OpenAPI document. The OpenAPI document is then validated against both JSON

Draft 4 schema and OpenAPI 2.0 schema.

The extension to JSON schema is based on [section 5.6 of JSON Schema Draft 4](http://json-schema.org/latest/json-schema-core.html#anchor20)

> 5.6.  Extending JSON Schema

> Implementations MAY choose to define additional keywords to JSON Schema. Save for explicit agreement, schema authors SHALL NOT expect these additional keywords to be supported by peer implementations. Implementations SHOULD ignore keywords they do not support.

## [Bond Sample IDL](./sample/bond/sample.bond)

Bond IDL expressing a data annotation.

```

namespace Examples

struct QoSEventPartC

{

    [DataClass("EII")]

    10: required string UserEmailAddress;

    20: optional string UserPUID;

};

```

## [OpenAPI Sample](./sample/swagger/sample.json)

Swagger document specifying both an endpoint as well as `the data schema for QoSEventPartC. See the JSON schema excerpt below:

```json

...

"definitions": {

        "QoSEventPartC": {

            "type": "object",

            "required": [

                "UserEmailAddress"

            ],

            "properties": {

                "UserEmailAddress": {

                    "type": "string",

                    "format": "email",

                    "x-ms-attributes": {

                        "Microsoft.Azure.DataClass": "EII"

                    }

                },

                "UserPUID": {

                    "type": "string"

                }

            }

        }

    }

```

## [JSON Payload Representing the Schema Above](./sample/example-payload.json)

Sample JSON document which represents the JSON schema above which corresponds to the Bond IDL

```json

{

  "UserEmailAddress": "blah@foo.com",

  "UserPUID":  "foo"

}

```