Merge pull request #3182 from vitormattos/import-from-trello

appinfo/info.xml

@@ -44,6 +44,7 @@
     </background-jobs>
     <commands>
         <command>OCA\Deck\Command\UserExport</command>
+        <command>OCA\Deck\Command\BoardImport</command>
     </commands>
     <activity>
         <settings>

appinfo/routes.php

@@ -90,6 +90,10 @@
 		['name' => 'board_api#deleteAcl', 'url' => '/api/v{apiVersion}/boards/{boardId}/acl/{aclId}', 'verb' => 'DELETE'],
 		['name' => 'board_api#updateAcl', 'url' => '/api/v{apiVersion}/boards/{boardId}/acl/{aclId}', 'verb' => 'PUT'],
 
+		['name' => 'board_import_api#getAllowedSystems', 'url' => '/api/v{apiVersion}/boards/import/getSystems','verb' => 'GET'],
+		['name' => 'board_import_api#getConfigSchema', 'url' => '/api/v{apiVersion}/boards/import/config/schema/{name}','verb' => 'GET'],
+		['name' => 'board_import_api#import', 'url' => '/api/v{apiVersion}/boards/import','verb' => 'POST'],
+
 
 		['name' => 'stack_api#index', 'url' => '/api/v{apiVersion}/boards/{boardId}/stacks', 'verb' => 'GET'],
 		['name' => 'stack_api#getArchived', 'url' => '/api/v{apiVersion}/boards/{boardId}/stacks/archived', 'verb' => 'GET'],

composer.json

@@ -9,7 +9,8 @@
 		}
 	],
 	"require": {
-		"cogpowered/finediff": "0.3.*"
+		"cogpowered/finediff": "0.3.*",
+		"justinrainbow/json-schema": "^5.2"
 	},
 	"require-dev": {
 		"roave/security-advisories": "dev-master",

docs/API.md

@@ -988,6 +988,49 @@ For now only `deck_file` is supported as an attachment type.
 
 ##### 200 Success
 
+### GET /boards/import/getSystems - Import a board
+
+#### Request parameters
+
+| Parameter    | Type    | Description                                   |
+| ------------ | ------- | --------------------------------------------- |
+| system       | Integer | The system name. Example: trello              |
+
+#### Response
+
+Make a request to see the json schema of system
+
+```json
+{
+}
+```
+
+### GET /boards/import/config/system/{schema} - Import a board
+
+#### Request parameters
+
+#### Response
+
+```json
+[
+  "trello"
+]
+```
+
+### POST /boards/import - Import a board
+
+#### Request parameters
+
+| Parameter    | Type    | Description                                   |
+| ------------ | ------- | --------------------------------------------- |
+| system       | string  | The allowed name of system to import from     |
+| config       | Object  | The config object  (JSON)                     |
+| data         | Object  | The data object to import (JSON)              |
+
+#### Response
+
+##### 200 Success
+
 # OCS API
 
 The following endpoints are available through the Nextcloud OCS endpoint, which is available at `/ocs/v2.php/apps/deck/api/v1.0/`.