Nuxt/docs/content/3.server/2.api.md
Daniel Roe f2672ac230
docs: server updates/introduction (#205)
Co-authored-by: Pooya Parsa <pyapar@gmail.com>
2021-06-14 21:12:00 +02:00

39 lines
804 B
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# API Routes
Nuxt will automatically read in any files in the `~/server/api` directory to create API endpoints.
Each file should export a default function that handles api requests. It can return a promise or JSON data directly (or use `res.end()`).
## Examples
### Hello world
```js [server/api/hello.ts]
export default (req, res) => 'Hello World'
```
See result on http://localhost:3000/api/hello
### Async function
```js [server/api/async.ts]
export default async (req, res) => {
await someAsyncFunction()
return {
someData: true
}
}
```
**Example:** Using Node.js style
```ts [server/api/node.ts]
import type { IncomingMessage, ServerResponse } from 'http'
export default async (req: IncomingMessage, res: ServerResponse) => {
res.statusCode = 200
res.end('Works!')
}
```