Share GPX

[alisa911]

No description provided.

[alisa911]

https://github.com/osmandapp/OsmAnd-Issues/issues/2527

[alisa911]

API list

• generate url - /generate-shared-url
• get gpx by url - /gpx/share/{token}
• get users with access - /accessed-users
• create blacklist - /create-file-blacklist
• get backlist - /get-blacklist

[alisa911]

shared_info
{"blacklist": {"users": [9, 15]}, "whitelist": {"permissions": {"13": {"permissionType": "READ"}}}, "accessedUsers": {"users": [19]}}
shared_code
7e3ebd26-5a2f-49a1-b9ba-9f0e80447cdd

[alisa911]

API list

/file-share - create and save code, return url
/share/gpx/{code} - get file by url
/share/accessed-users - get users with access
/share/edit-blacklist
/share/edit-whitelist
/share/get-blacklist

[vshcherb]

API Editor

• /share/generate-link?file=&filetype=&type= - create and save code, return url
• /share/edit-blacklist -
• /share/edit-whitelist -
• /share/get-shared-info - (full json from db with integer replaced by users)

Link
https://osmand.net/map/?share=UNIQUE_CODE.

API Get access:

• /share/check-access?share=UNIQUE_CODE. - returns how access could be and whether you have access or not (if logged in)
• /share/get?share=UNIQUE_CODE.

/share/get-gpx

[alisa911]

API

• generate-link
  /share/generate-link?fileName=2022_11_11_09.49.41_Dag.gpx&fileType=GPX&type=publicByLogin

  {
      "url": "/share/get?code=cb5f0208-2022_11_g.gpx"
  }

• /share/get
  /share/get?code=cb5f0208-2022_11_g.gpx
  Result: File (binary)

• get-shared-info
  /share/get-shared-info?name=2022_11_11_09.49.41_Dag.gpx&type=GPX

  {
      "whitelist": {
          "permissions": {
              "13": {
                  "permissionType": "READ"
              }
          }
      },
      "blacklist": {
          "users": [
              9,
              15
          ]
      },
      "accessedUsers": {
          "users": {
              "19": 1732804100607
          }
      },
      "sharingType": "PUBLIC_BY_LOGIN",
      "groupActions": []
  }

• /share/edit-blacklist
  /share/edit-blacklist?name=2022_11_11_09.49.41_Dag.gpx&type=GPX

• /share/edit-whitelist
  /share/edit-whitelist?name=2022_11_11_09.49.41_Dag.gpx&type=GPX

• check-access
  /share/check-access?code=cb5f0208-2022_11_g.gpx

  {
      "groupActions": [],
      "type": "PUBLIC_BY_LOGIN",
      "hasAccess": true
  }

[RZR-UA]

/share/generate-link?fileName=2022_11_11_09.49.41_Dag.gpx&fileType=GPX&type=publicByLogin

1. It is possible that using fileId would be better than using fileName/tileType

2. Anyway, what will happen with the generated link when:

• file is deleted
• file is moved/renamed
• file is replaced with the fresher one

[RZR-UA]

It's better to use VARCHAR not UUID. Some day we might decide to use some shorter code such as set of [a-zA-Z0-9]. VARCHAR would be OK for both UUID and String.