From a2ab5798fe73b213774ecd344579a73d971cf87f Mon Sep 17 00:00:00 2001
From: Willy Kloucek <34452982+wkloucek@users.noreply.github.com>
Date: Thu, 18 Aug 2022 09:51:57 +0000
Subject: [PATCH] commit a3f77683a6e8c48ccd38951e3125e9c9fb9fa84b Merge:
 c271c9ab8 771e7e8e3 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
---
 grpc_apis/ocis/messages/search/v0/grpc.md     |  2 +-
 grpc_apis/ocis/messages/settings/v0/grpc.md   |  2 +-
 grpc_apis/ocis/messages/store/v0/grpc.md      |  2 +-
 grpc_apis/ocis/messages/thumbnails/v0/grpc.md |  2 +-
 grpc_apis/ocis/services/search/v0/grpc.md     |  2 +-
 grpc_apis/ocis/services/settings/v0/grpc.md   |  2 +-
 grpc_apis/ocis/services/store/v0/grpc.md      |  2 +-
 grpc_apis/ocis/services/thumbnails/v0/grpc.md |  2 +-
 services/app-registry/apps.md                 | 20 +++++++++++++++++++
 9 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/grpc_apis/ocis/messages/search/v0/grpc.md b/grpc_apis/ocis/messages/search/v0/grpc.md
index 9614fdb493f..164248e9015 100644
--- 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
index bf81497974a..04378e29ba4 100644
--- 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
index c6e026f766e..b3f4ef30872 100644
--- 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
index cf429132156..2273c228091 100644
--- 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
index 219970630aa..1864957aeb7 100644
--- 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
index 0fd0be1d83d..bacb2dac846 100644
--- 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
index 2e8dd705867..b890ffdd518 100644
--- 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
index d04f3cb2c50..72b0a128cc7 100644
--- 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
index e9726849cb7..457e2294fb1 100644
--- 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`