Files
probot/docs/http.md
2017-09-12 07:01:18 -07:00

29 lines
986 B
Markdown

---
next: docs/simulating-webhooks.md
---
# HTTP Routes
Calling `robot.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 = robot => {
// Get an express router to expose new HTTP endpoints
const app = robot.route('/my-app')
// Use any middleware
app.use(require('express').static('public'))
// Add a new route
app.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 `robot.route('/owners')` to prefix all endpoints with `/owners`.
See the [express documentation](http://expressjs.com/en/guide/routing.html) for more information.