gistfile1.txt

{
    "apiVersion": "v1",
    "swaggerVersion": "1.2",
    "basePath": "https://{{subdomain}}.apigee.net",
    "resourcePath": "/v1/sms/messages",
    "consumes": [
        "application/json"
    ],
    "produces": [
        "application/json"
    ],
    "authorizations": {
        "oauth2": {
            "type": "oauth2",
            "scopes": [
                "SMS"
            ],
            "grantTypes": {
                "authorization_code": {
                    "tokenEndpoint": {
                        "url": "https://{{subdomain}}.apigee.net/v1/oauth/token",
                        "clientIdName": "client_id",
                        "clientSecretName": "client_secret",
                        "tokenName": "access_token"
                    }
                }
            }
        }
    },
    "apis": [
        {
            "path": "/",
            "description": "Send SMS",
            "operations": [
                {
                    "method": "POST",
                    "summary": "Send a SMS",
                    "responseMessages": [{
                        "code" : 201,
                        "message" : "Created"
                    }],
                    "parameters": [
                        {
                            "name": "to",
                            "description": "to whom",
                            "paramType": "body",
                            "required": true,
                            "allowMultiple": false,
                            "type": "string"
                        },
                        {
                            "name": "body",
                            "description": "sms text",
                            "paramType": "body",
                            "required": true,
                            "allowMultiple": false,
                            "type": "string"
                        }
                    ]
                }
            ]
        },
        {
            "path": "/{messageid}",
            "description": "Get SMS",
            "operations": [
                {
                    "method": "GET",
                    "summary": "Get a SMS",
                    "responseMessages": [{
                        "code" : 200,
                        "message" : "OK"
                    }],
                    "parameters": [
                        {
                            "name": "messageid",
                            "description": "messageid",
                            "paramType": "path",
                            "required": true,
                            "allowMultiple": false,
                            "type": "string"
                        }
                    ]
                }
            ]
        },
        {
            "path": "/{messageid}/response",
            "description": "Get SMS Response",
            "operations": [
                {
                    "method": "GET",
                    "summary": "Get a SMS Response",
                    "responseMessages": [{
                        "code" : 200,
                        "message" : "OK"
                    }],
                    "parameters": [
                        {
                            "name": "messageid",
                            "description": "messageid",
                            "paramType": "path",
                            "required": true,
                            "allowMultiple": false,
                            "type": "string"
                        }
                    ]
                }
            ]
        }
    ]
}