2019-12-01 08:21:20 +00:00
# API
2019-12-02 00:08:53 +00:00
The systems API is defined in here. The RPC maps directly to the API defined here using the [JSON RPC package ](https://github.com/filecoin-project/lotus/tree/master/lib/jsonrpc ).
2019-12-01 08:21:20 +00:00
## Overview
By default `127.0.0.1:1234` - daemon stores the api endpoint multiaddr in `~/.lotus/api`
- `http://[api:port]/rpc/v0` - JsonRPC http endpoint
- `ws://[api:port]/rpc/v0` - JsonRPC websocket endpoint
- `PUT http://[api:port]/rest/v0/import` - import file to the node repo, it requires write permission.
2019-12-02 00:08:53 +00:00
For JsonRPC interface definition see [api/api.go ](https://github.com/filecoin-project/lotus/blob/master/api/api_full.go ). Required permissions are
defined in [api/struct.go ](https://github.com/filecoin-project/lotus/blob/master/api/struct.go )
2019-12-01 08:21:20 +00:00
## Auth
JWT in the `Authorization: Bearer <token>` http header
Permissions
- `read` - Read node state, no private data
- `write` - Write to local store / chain, read private data
- `sign` - Use private keys stored in wallet for signing
- `admin` - Manage permissions
Payload
```json
{
"Allow": ["read", "write", ...]
}
```
Admin token is stored in `~/.lotus/token`
