OpenAPI.NET.OData
OpenAPI.NET.OData copied to clipboard
Semantic violation: Certain OData functions have path parameters referenced in query
Certain OData functions have path parameters referenced in query instead of path. This results in generation error since code generators cannot find the specified path parameters.
Current Representation
'/users/{user-id}/joinedTeams/{team-id}/primaryChannel/microsoft.graph.doesUserHaveAccess(userId=''{userId}'',tenantId=''{tenantId}'',userPrincipalName=''{userPrincipalName}'')':
get:
tags:
- users.Functions
summary: Invoke function doesUserHaveAccess
operationId: users.joinedTeams.primaryChannel_doesUserHaveAccess
parameters:
- name: user-id
in: path
description: 'key: id of user'
required: true
schema:
type: string
x-ms-docs-key-type: user
- name: team-id
in: path
description: 'key: id of team'
required: true
schema:
type: string
x-ms-docs-key-type: team
- name: userId
in: query
description: 'Usage: userId=''{userId}'''
schema:
type: string
nullable: true
- name: tenantId
in: query
description: 'Usage: tenantId=''{tenantId}'''
schema:
type: string
nullable: true
- name: userPrincipalName
in: query
description: 'Usage: userPrincipalName=''{userPrincipalName}'''
schema:
type: string
nullable: true
responses:
'200': ...
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
Ideal Representation
'/users/{user-id}/joinedTeams/{team-id}/primaryChannel/microsoft.graph.doesUserHaveAccess(userId=''{userId}'',tenantId=''{tenantId}'',userPrincipalName=''{userPrincipalName}'')':
get:
tags:
- users.Functions
summary: Invoke function doesUserHaveAccess
operationId: users.joinedTeams.primaryChannel_doesUserHaveAccess
parameters:
- name: user-id
in: path
description: 'key: id of user'
required: true
schema:
type: string
x-ms-docs-key-type: user
- name: team-id
in: path
description: 'key: id of team'
required: true
schema:
type: string
x-ms-docs-key-type: team
- name: userId
+ in: path
- in: query
description: 'Usage: userId=''{userId}'''
schema:
type: string
nullable: true
- name: tenantId
+ in: path
- in: query
description: 'Usage: tenantId=''{tenantId}'''
schema:
type: string
nullable: true
- name: userPrincipalName
+ in: path
- in: query
description: 'Usage: userPrincipalName=''{userPrincipalName}'''
schema:
type: string
nullable: true
responses:
'200': ...
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function