Rinstapkg (version 0.1.0)

ig_auth: Log in to Instagram

Description

Log in using Basic (Username-Password) or OAuth 2.0 authenticaion. OAuth does not require sharing passwords, but will require authorizing Rinstapkg as a connected app to view and manage your account. You will be directed to a web browser, asked to sign in to your Instagram account, and to grant Rinstapkg permission to operate on your behalf. By default, these user credentials are cached in a file named .httr-oauth-Rinstapkg in the current working directory.

Usage

ig_auth(username = NULL, password = NULL, token = NULL,
  client_id = getOption("Rinstapkg.client_id"),
  client_secret = getOption("Rinstapkg.client_secret"),
  callback_url = getOption("Rinstapkg.callback_url"),
  cache = getOption("Rinstapkg.httr_oauth_cache"), verbose = FALSE)

Arguments

username

Instagram username, use the handle without the "@" sign or an email

password

Instagram password

token

optional; an actual token object or the path to a valid token stored as an .rds file

client_id, client_secret, callback_url

the "Client Id","Client Secret", and "Callback URL" when using a connected app. The Rinstapkg does not have a default App so you must specify these if using the OAuth2.0 protocol

cache

logical or character; TRUE means to cache using the default cache file .httr-oauth-Rinstapkg, FALSE means don't cache. A string means use the specified path as the cache file.

verbose

logical; do you want informative messages?

Examples

# NOT RUN {
# log in using basic authentication (username-password)
ig_auth(username = "[e-mail]", 
        password = "test_password")

# log in using OAuth 2.0
# Via brower or refresh of .httr-oauth-Rinstapkg
options(Rinstapkg.client_id = "012345678901-99thisisatest99")
options(Rinstapkg.client_secret = "Th1s1sMyC1ientS3cr3t")
ig_auth()

# Save token and log in using it
saveRDS(.state$token, "token.rds")
ig_auth(token = "token.rds")
# }