Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Status

Current state"WIP/Under Discussion"

...

    * Recover: API related to Recover 

All API access is over HTTPS. All data is sent and received as JSON.
The

The common REST API Pattern will be:

/api/v1/<component>/<action>

 

32. Root endpoint:

/api/v1
GET
Get all the available endpoints

...

Response

Code

...

Description
200

...

successful operation
403

...

Don't have permission

 

 

43. Config:

/api/v1/config/values

GET

Get value of all configured values overridden on local config

Response

Code

...

Description
200

...

successful operation
403

...

Don't have permission

404

...

Configuration not found

...


/api/v1/config/:configName/:configValue

POST
Update

...

configuration

Parameters

Name

...

Type

...

Required

...

Description
configName

...

String

...

Yes

...

Configuration name(key) 
configValue

...

StringYesConfiguration value(value)

Response

Code

...

Description
204

...

successful operation
403

...

Don't have permission

404

...

Configuration not found

 

54. Bookkeeper:

/api/v1/bookkeeper/format_metadata/:force

POST

Format bookkeeper metadata

Parameters

Name

...

Type

...

Required

...

Description
force

...

boolean

...

No

...

whether to force format and delete the old data 

Response

Code

...

Description
204

...

successful operation
403

...

Don't have permission

 

/api/v1/bookkeeper/list_bookies/:type/:hostnames

GET

...

 Get all the available bookies.

Parameters

Name

...

TypeRequiredDescription
type

...

StringYes

 value: rw/ro

...

, list read-write/read-only

...

bookies 

Hostnames

...

Boolean

...

No whether print hostname of bookie  

Response

Code

...

Description
200successful operation
403

Don't have permission

/api/v1/bookkeeper/update_cookie/:idType

POST

Update bookie id in cookie.

Parameters

NameTypeRequiredDescription
idTypeStringYes

 value:  hostname/ip ,  Id by hostname or IP address 

Response

CodeDescription
204successful operation
403

...

Don't have permission

404Not update, for errors

 

/api/v1/bookkeeper/update_cookie/:idType

...