diff options
author | Frédéric Guillot <fred@kanboard.net> | 2018-04-06 10:54:58 -0700 |
---|---|---|
committer | Frédéric Guillot <fred@kanboard.net> | 2018-04-06 10:54:58 -0700 |
commit | 0b306fa60ad84ea077111e0ff7b59208ba7bc8a3 (patch) | |
tree | 5d8941b5950ede2db8ca3fba0213792db0f07a50 /doc/en_US/api-json-rpc.markdown | |
parent | ac11220a1aa7ae30b8827d9bbf221888d3edd0a7 (diff) |
Move documentation to https://docs.kanboard.org/
Diffstat (limited to 'doc/en_US/api-json-rpc.markdown')
-rw-r--r-- | doc/en_US/api-json-rpc.markdown | 73 |
1 files changed, 0 insertions, 73 deletions
diff --git a/doc/en_US/api-json-rpc.markdown b/doc/en_US/api-json-rpc.markdown deleted file mode 100644 index fad19466..00000000 --- a/doc/en_US/api-json-rpc.markdown +++ /dev/null @@ -1,73 +0,0 @@ -Json-RPC API -============ - -User and application API ------------------------- - -There are two types of API access: - -### Application API - -- Access to the API with the user "jsonrpc" and the token available on the settings page -- Access to all procedures -- No permission checked -- There is no user session on the server -- No access to procedures that starts with "My..." (example: "getMe" or "getMyProjects") -- Example of possible clients: tools to migrate/import data, create tasks from another system, etc... - -### User API - -- Access to the API with the user credentials (username and password) -- You can also generate a personal access token instead of your password -- Application role and project permissions are checked for each procedure -- A user session is created on the server -- Example of possible clients: native mobile/desktop application, command line utility, etc... - -Security --------- - -- Always use HTTPS with a valid certificate (avoid clear text communication) -- If you make a mobile application, it's your responsability to store securely the user credentials on the device -- After 3 authentication failure on the user api, the end-user have to unlock his account by using the login form -- Two factor authentication is not yet available through the API - -Protocol --------- - -Kanboard use the protocol Json-RPC to interact with external programs. - -JSON-RPC is a remote procedure call protocol encoded in JSON. -Almost the same thing as XML-RPC but with the JSON format. - -We use the [version 2 of the protocol](http://www.jsonrpc.org/specification). -You must call the API with a `POST` HTTP request. - -Kanboard support batch requests, so you can make multiple API calls in a single HTTP request. It's particularly useful for mobile clients with higher network latency. - -Usage ------ - -- [Authentication](api-authentication.markdown) -- [Examples](api-examples.markdown) -- [Application](api-application-procedures.markdown) -- [Projects](api-project-procedures.markdown) -- [Project Permissions](api-project-permission-procedures.markdown) -- [Boards](api-board-procedures.markdown) -- [Columns](api-column-procedures.markdown) -- [Swimlanes](api-swimlane-procedures.markdown) -- [Categories](api-category-procedures.markdown) -- [Automatic Actions](api-action-procedures.markdown) -- [Tasks](api-task-procedures.markdown) -- [Subtasks](api-subtask-procedures.markdown) -- [Subtask Time Tracking](api-subtask-time-tracking-procedures.markdown) -- [Task Files](api-task-file-procedures.markdown) -- [Project Files](api-project-file-procedures.markdown) -- [Links](api-link-procedures.markdown) -- [Tags](api-tags-procedures.markdown) -- [Internal Task Links](api-internal-task-link-procedures.markdown) -- [External Task Links](api-external-task-link-procedures.markdown) -- [Comments](api-comment-procedures.markdown) -- [Users](api-user-procedures.markdown) -- [Groups](api-group-procedures.markdown) -- [Group Members](api-group-member-procedures.markdown) -- [Me](api-me-procedures.markdown) |