commit a3f7768

Merge: c271c9a 771e7e8 Author: Willy Kloucek <34452982+wkloucek@users.noreply.github.com> Date: Thu Aug 18 11:49:23 2022 +0200 Merge pull request #4399 from wkloucek/language-selection-for-app-provider add language selection for app provider
owncloud · Aug 18, 2022 · a2ab579 · a2ab579
1 parent 9e8c03e
commit a2ab579
Show file tree

Hide file tree

Showing 9 changed files with 28 additions and 8 deletions.
diff --git a/grpc_apis/ocis/messages/search/v0/grpc.md b/grpc_apis/ocis/messages/search/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.messages.search.v0"
 url: /grpc_apis/ocis_messages_search_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/messages/settings/v0/grpc.md b/grpc_apis/ocis/messages/settings/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.messages.settings.v0"
 url: /grpc_apis/ocis_messages_settings_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/messages/store/v0/grpc.md b/grpc_apis/ocis/messages/store/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.messages.store.v0"
 url: /grpc_apis/ocis_messages_store_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/messages/thumbnails/v0/grpc.md b/grpc_apis/ocis/messages/thumbnails/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.messages.thumbnails.v0"
 url: /grpc_apis/ocis_messages_thumbnails_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/services/search/v0/grpc.md b/grpc_apis/ocis/services/search/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.services.search.v0"
 url: /grpc_apis/ocis_services_search_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/services/settings/v0/grpc.md b/grpc_apis/ocis/services/settings/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.services.settings.v0"
 url: /grpc_apis/ocis_services_settings_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/services/store/v0/grpc.md b/grpc_apis/ocis/services/store/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.services.store.v0"
 url: /grpc_apis/ocis_services_store_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:03Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/grpc_apis/ocis/services/thumbnails/v0/grpc.md b/grpc_apis/ocis/services/thumbnails/v0/grpc.md
@@ -1,7 +1,7 @@
 ---
 title: "ocis.services.thumbnails.v0"
 url: /grpc_apis/ocis_services_thumbnails_v0
-date: 2022-08-18T09:25:10Z
+date: 2022-08-18T09:51:02Z
 weight: 50
 geekdocRepo: https://github.com/owncloud/ocis
 ---

diff --git a/services/app-registry/apps.md b/services/app-registry/apps.md
@@ -245,12 +245,21 @@ See error cases for [Open a file with the app provider](#open-a-file-with-the-ap
  - `write`: user can edit and download in the opening app
  - `read`: user can view and download from the opening app
  - `view`: user can view in the opening app (download is not possible)
+- `lang` (optional)
+ - default (not given): default language of the application (which might maybe use the browser language)
+ - possible value is any ISO 639-1 language code. Examples:
+ - de
+ - en
+ - es
+ - ...
 
 **Request examples**:
 
 ```bash
 curl -X POST 'https://ocis.test/app/open?file_id=ZmlsZTppZAo='
 
+curl -X POST 'https://ocis.test/app/open?file_id=ZmlsZTppZAo=&lang=de'
+
 curl -X POST 'https://ocis.test/app/open?file_id=ZmlsZTppZAo=&app_name=Collabora'
 
 curl -X POST 'https://ocis.test/app/open?file_id=ZmlsZTppZAo=&view_mode=read'
@@ -362,6 +371,17 @@ HTTP status code: 200
  }
  ```
 
+- invalid language code
+
+ HTTP status code: 400
+
+ ```json
+ {
+ "code": "INVALID_PARAMETER",
+ "message": "lang parameter does not contain a valid ISO 639-1 language code"
+ }
+ ```
+
 ### Creating a file with the app provider
 
 **Endpoint**: specified in the capabilities in `new_file_url`, currently `/app/new`