Skip to contents

Retrieving permissions

Source: R/osmapi_miscellaneous.R
osm_permissions.Rd

Returns the permissions granted to the current API connection.

Usage

osm_permissions(format = c("R", "xml", "json"))

Arguments

format

Format of the output. Can be "R" (default), "xml", or "json".

Value

If the API client is not authorized, an empty list of permissions will be returned. Otherwise, the list will be based on the granted scopes of the logged user.

Details

Currently the following permissions can appear in the result, corresponding directly to the ones used in the OAuth 1.0a application definition:

  • allow_read_prefs (read user preferences)

  • allow_write_prefs (modify user preferences)

  • allow_write_diary (create diary entries, comments and make friends)

  • allow_write_api (modify the map)

  • allow_write_redactions (redact element versions)

  • allow_read_gpx (read private GPS traces)

  • allow_write_gpx (upload GPS traces)

  • allow_write_notes (modify notes)

Note

For compatibility reasons, all OAuth 2.0 scopes will be prefixed by "allow_", e.g. scope "read_prefs" will be shown as permission "allow_read_prefs".

See also

Other API functions: authenticate_osmapi(), osm_api_versions(), osm_capabilities(), set_osmapi_connection()

Examples

if (FALSE) { # \dontrun{
perms <- osm_permissions()
perms
} # }