kibana/style_guides/api_style_guide.md
CJ Cenizal 81fb346a8c Update API and HTML style guides.
- 80-character line limit in HTML.
2016-06-09 15:32:03 -07:00

683 B

API Style Guide

Paths

API routes must start with the /api/ path segment, and should be followed by the plugin id if applicable:

Right: /api/marvel/nodes Wrong: /marvel/api/nodes

Versions

Kibana won't be supporting multiple API versions, so API's should not define a version.

Right: /api/kibana/index_patterns Wrong: /api/kibana/v1/index_patterns

snake_case

Kibana uses snake_case for the entire API, just like Elasticsearch. All urls, paths, query string parameters, values, and bodies should be snake_case formatted.

Right:

POST /api/kibana/index_patterns
{
  "id": "...",
  "time_field_name": "...",
  "fields": [
    ...
  ]
}