device_key

A phone from an older version trades the account key for a key of its own, once.

A phone signed in with an older version of the app holds the account's master key. The first time the updated app opens, it calls this endpoint once and moves to a key of its own.

01 · The call
POST https://opensolr.com/app/api/device_key

Only while the phone has no key of its own yet; never again after it got one.

A JSON body with the account email and the api_key the phone holds, client_id opensolr-photos, and the phone's device_id, device_label and app_version.

02 · The answer
{"status": true, "msg": {"api_key": "…", "key_kind": "device"}}
  • The app keeps the new key, encrypted, and uses it for every call from then on.
  • The phone's row in Account › Devices turns from Account key to Own key.
  • If the key it sends is refused, the app returns to its sign-in screen. If the server offers no key, the app carries on with the one it has and tries again at the next start.

Every call it makes

Opensolr Photos is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the app itself belong on GitHub.

Opensolr Photos Documentation