Forum Discussion

Yesman77's avatar
Yesman77
Occasional Visitor
5 years ago
Solved

Failed to execute 'fetch' on 'Window': Invalid name

I'm facing a problem with using a colon ':' in Swagger as a name for a parameter. 

I need to use a colon as if it was changed then current clients will have a problem with our API. When I use the parameter below I get an error called: TypeError: Failed to execute 'fetch' on 'Window': Invalid name

 

parameters: 

  - in: header
  name: "Authorization: Token "
  schema:
      type: string
      format: byte
  required: true

 

Any help/advice will be appreciated

 

  • MisterB's avatar
    MisterB
    3 years ago

    I have no knowledge of the limitations but you can contact SmartBear support here for a definitive answer

  • MisterB's avatar
    MisterB
    3 years ago

    I just tried and as you can see, I can create at least 11 subfolders - I stopped at 11.  I'm using the Cloud version:

     

     

1 Reply

Sort By
  • HKosova's avatar
    HKosova
    Icon for Alumni rankAlumni
    5 years ago
    Copy LinkReport

    Hi Yesman77,

     

    Colons aren't allowed in HTTP header names because they separate the header name and value.

     

    Moreover, since you're using OpenAPI 3.0, the Authorization header must be defined as a security scheme instead of a header parameter. (If defined as a parameter, it will be ignored.)

     

    You need to change your definition as follows. When testing the requests in SwaggerHub, click the "Authorize" button and enter the authorization token there.

    components:
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: Authorization
      description: Specify the token with the `Token` prefix, for example, `Token abcde12345`.

# Require the "Authorization" header globally...
security:
  - Authorization: []

paths:
  /something:
    get:
      # ... or with individual operations
      security:
        - Authorization: []