Documentation needs to mention writing server-side code in GS(S)P props earlier

Lots of users miss that they can write server side code in getStaticProps and getServerSideProps.

We also see numerous issues about people trying to fetch API routes. We need to fix this in the documentation by making this one of the first things we have in the docs.

[adriancooney]

Throwing my opinion down here - I don’t think this is fixed. I found this issue via blame’ing the note in the docs because it confused me even further. Why can we not fetch API routes? This has broken my mental model of how Next.js used to work (i.e. fetch from API during SSR).

Two notes on the content of the fix:

Instead, directly import the API route and call its function yourself.

How do we call the function itself? How do we access the data? Do you mean repeat the data fetching (i.e. DB calls) in the API route in the getServerSideProps method? I think I’m misunderstanding something here.

You may need to slightly refactor your code for this approach.

Without any indication how to approach this refactor or what the refactor entails makes for a pretty frustrating read. I think pointing to an example here of an app using API routes in SSR would be really useful. I’m currently lost and regretting my decision to use API routes because of the complexity and hidden constraints.

[agarwalrounak]

I will take this up.