Forum Discussion

prathamat's avatar
prathamat
New Contributor
4 years ago

Should be an absolute uri

I get the error  "should be an absolute uri"   in the YAML produced.  
HKosova's avatar
HKosova
SmartBear Alumni (Retired)
4 years ago

This error means that the authorizationUrl cannot be an empty string. It must specify the authorization URL of the OAuth 2.0 identity provider used by the API.

 

Other errors ("declared path parameter <..> needs to be defined ...") mean that endpoints that have path parameters must also define them in the parameters section, like so:

 

paths:
  /v1/devices/{document_id}:
    patch:
      parameters:
        - in: path
          name: document_id
          required: true
          type: integer      # or 'string' or whatever the type is

        # Other parameters
        - ...

 

Note that path parameters must have required: true because they are always required.

  • prathamat's avatar
    prathamat
    New Contributor
    4 years ago

    Thanks for your quick reply HKosova .

     

    The way we are doing it in our project is by using Python Flask.Before every API definition, we are defining it and also providing a brief description.So, changes made in the code directly reflect in theYAML.

     

    How do I fix that?Also, there are several warnings in the project and I haven't found anything on the net to remove them.