top | item 37207333

(no title)

nicexe | 2 years ago

They don't have to be static but making them dynamic might not worth the cost.

From a simple static page, now you need an API service, most probably connected to a DB or somehow integrated to the rest of your backend. So markdown suddenly isn't enough and you need some server-side logic.

For random strings, you can do this with client-side logic, which in some cases might be easier than server-side logic. But you are still moving from no-logic (static) to somewhere-logic.

discuss

order

tough|2 years ago

SwaggerUI/OpenAPI support this to add your own users API credentials to the api call examples, if you care to implement.

as a develoer, is just a nice touch that I can copy paste an example of code snippet and since I'm logged in they can give it to me already with a valid api key.

ymmv

They also allow to output examples in as many langugages/sdk's as you need too

nicolaslem|2 years ago

This unfortunately encourages users to hard-code secrets since the example snippet they get literally does it.