1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-22 19:07:54 +01:00
unleash.unleash/website/docs/api/index.md
Thomas Heartman 9448461aaa
docs: prep to add OpenAPI spec to Unleash docs (#1907)
* Docs: start experimenting with OpenAPI and docusaurus

* Docs: add docusaurus-theme-openapi-docs pkg

* Wip: current status

* Docs: Add 'docusaurus-plugin-api-docs'

* Move openapi into own sidebar; generate from localhost

* Chore: Update docusaurus plugin for OpenAPI

* Add website/yarn.lock to git

* Fix: fix CSS warning by using flex-end instead of end

* docs: make openapi generated code work again

* docs: make tags work properly with openapi sidebar

* Docs/chore: update OpenAPI tag scheme.

Add a whole bunch of new tags to make it easier to understand
available tags in OpenAPI.

* docs: point to new openapi docs from old api docs

* docs: typo

* Docs:  link restructure

* docs: add operation indicators to openapi docs

* docs: change badge color for operations

* docs: update openapi-docs package

It now sorts tags the same as the schema

* docs: pluralize APIs in slug

* docs: update links to generated api docs

* docs: update openapi snapshot tests with new tags

* docs: conditionally load spec from localhost or from file

* docs: Remove changes relating to immediate switchover

* refactor: rename types; extract into separate file

* docs: fix api doc links
2022-08-12 11:37:57 +02:00

43 lines
1.3 KiB
Markdown

---
id: index
title: API Documentation
slug: /api
---
## Client API {#client-api}
This describes the API provided to unleash-clients.
Since v4.0.0 all operations require an [API token](/user_guide/api-token) with `Client` level access.
With versions earlier than v4.0.0 and `insecure` authentication no authentication is required.
- [Feature Toggles API](/api/client/features)
- [Register API](/api/client/register)
- [Metrics API](/api/client/metrics)
## Admin API (internal) {#admin-api-internal}
The internal API used by the Admin UI (unleash-frontend). Since v4.0.0 all operations require an [API token](/user_guide/api-token) with `Admin` level access:
With versions earlier than v4.0.0 and `insecure` authentication Basic Auth (with curl `-u myemail@test.com:`) is enough.
- [Events API](/api/admin/events-api.md)
- [Feature Toggles API](/api/admin/feature-toggles-api.md)
- [Metrics API](/api/admin/metrics-api.md)
- [Project API](/api/admin/project.md)
- [Strategies API](/api/admin/strategies-api.md)
- [Tags API](/api/admin/tags-api.md)
## System API's {#system-apis}
- [Internal Backstage API](/api/internal/internal)
### Content-Type {#contenttype}
All endpoints require `application/json` as content type, so if you're using curl remember to add
```bash
-H "Content-Type: application/json"
```