Witam, Zwracam się do was o pomoc z taką prośbą:
Możecie polecić jakieś dobre materiały do nauki pisania API w .NET, lub ogólnie API?
Chodzi mi bardziej o to aby były opisane dobre praktyki i wymagania jakie powinny takowe interfejsy spełniać.
Mogą to być książki, lub jakieś serwisy(blogi) internetowe które poruszają te kwestie.
allegro ma to ładnie opisane, wprawdzie w oderwaniu od jakiejkolwiek technologii, ale i tak warto przeczytać:
https://allegro-restapi-guideline.readthedocs.io/en/latest/
moje ulubione fragmenty:
We are providing you with Allegro REST API, while we try to deliver truly RESTful API interface with positive developer experience (DX).
https://allegro-restapi-guideline.readthedocs.io/en/latest/DesignGuidelines/#allegro-rest-api-design-guidelines
trochę definicji :
Hypermedia as the engine of application state (HATEOAS)
(..)
If a service violates any of the required constraints, it cannot be considered RESTful.
https://allegro-restapi-guideline.readthedocs.io/en/latest/DesignGuidelines/#allegro-rest-api-design-guidelines
i na samym końcu:
TL;DR We do not use HATEOAS and do not support it
https://allegro-restapi-guideline.readthedocs.io/en/latest/Hateoas/