mirror of https://gitee.com/bigwinds/arangodb
43 lines
1003 B
Markdown
43 lines
1003 B
Markdown
---
|
|
layout: default
|
|
description: Arbitrary HTTP routes
|
|
---
|
|
|
|
# Arbitrary HTTP routes
|
|
|
|
## database.route
|
|
|
|
`database.route([path,] [headers]): Route`
|
|
|
|
Returns a new _Route_ instance for the given path (relative to the database)
|
|
that can be used to perform arbitrary HTTP requests.
|
|
|
|
**Arguments**
|
|
|
|
* **path**: `string` (optional)
|
|
|
|
The database-relative URL of the route.
|
|
|
|
* **headers**: `Object` (optional)
|
|
|
|
Default headers that should be sent with each request to the route.
|
|
|
|
If _path_ is missing, the route will refer to the base URL of the database.
|
|
|
|
For more information on _Route_ instances see the
|
|
[_Route API_ below](js-reference-route.html).
|
|
|
|
**Examples**
|
|
|
|
```js
|
|
const db = new Database();
|
|
const myFoxxService = db.route('my-foxx-service');
|
|
const response = await myFoxxService.post('users', {
|
|
username: 'admin',
|
|
password: 'hunter2'
|
|
});
|
|
// response.body is the result of
|
|
// POST /_db/_system/my-foxx-service/users
|
|
// with JSON request body '{"username": "admin", "password": "hunter2"}'
|
|
```
|