Files
probot/docs/http.md
Brandon Keepers 2efa0b24b7 chore: Rename robot to app (#542)
This replaces all internal references to "robot" with "app" or
"Application". There should be no functional change in public APIs, but
may cause some issues for anyone using internal APIs.
2018-06-01 17:45:23 -05:00

29 lines
987 B
Markdown

---
next: docs/simulating-webhooks.md
---
# HTTP Routes
Calling `app.route('/my-app')` will return an [express](http://expressjs.com/) router that you can use to expose HTTP endpoints from your app.
```js
module.exports = app => {
// Get an express router to expose new HTTP endpoints
const router = app.route('/my-app')
// Use any middleware
router.use(require('express').static('public'))
// Add a new route
router.get('/hello-world', (req, res) => {
res.end('Hello World')
})
}
```
Visit https://localhost:3000/my-app/hello-world to access the endpoint.
It is strongly encouraged to use the name of your package as the prefix so none of your routes or middleware conflict with other apps. For example, if [`probot/owners`](https://github.com/probot/owners) exposed an endpoint, the app would call `app.route('/owners')` to prefix all endpoints with `/owners`.
See the [express documentation](http://expressjs.com/en/guide/routing.html) for more information.