Altinn / Altinn/app-lib-dotnet

Simplify swagger generated by apps

Open
#140 0 comments 1 reaction 0 assignees View on GitHub
kind/feature-request
Dominant language
C#
Stars
8
Forks
27
Avg merge
1h 21m
Merged PRs (30d)
7

Description

## Is your feature request related to a problem? Please describe

Currently org and app are params in the swagger for each app, even though these values are constant for a given app.
Is it possible to avoid this?

![image](https://user-images.githubusercontent.com/6088624/121477166-cd998f80-c9c7-11eb-8a0a-7618aede2da6.png)

## Describe the solution you'd like
Org and app as part of the URL, not params on each API.

Contributor guide

Open the contributing guide

Research direction

Start by locating the Swagger/OpenAPI generation entry point for app APIs and inspect how org and app are added to each operation. Done means those values are represented in the URL structure rather than repeated as parameters, with the generated documentation reflecting that consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp, openapi
Domain
api, backend-api-design
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.