Instagram Cartridge - Configuration Guidelines
Register an application endpoint
Use Instagram's developer interface to register a new client endpoint.
The settings required for this are:
- Application Name: whatever you like ("my Sponger instance")
- Description: optional, free-form
- Website: set this to the base of your Virtuoso installation, e.g. http://localhost:8890/
- OAuth redirect_uri: adjusting localhost and port number to your installation, put http://localhost:8890/sponger/instagram_oauth in here (note no trailing slash)
Once the client is created, it should give you a paragraph of its options including a client id and a client_secret.
Cartridge Options
In the Virtuoso Conductor (eg http://localhost:8890/conductor), select the menu item Linked Data -> Sponger -> Extractor Cartridges.
In the list of cartridges, ensure `Instagr.am Photos' is enabled (hit `Apply' at the bottom if need be), then click on the name "Instagr.am Photos" to show its options:
The API Key should be the Client_ID parameter from Instagram.
The client_secret option is currently unused, but may be set against future updates.
The oauth-fallback cartridge option is a default username to use for authenticated requests. Currently, this is only used in order to list a user's media; if an access token for the user being sponged is not found, this will be used in its place - so you get a view from this user's perspective.
View the Retrieved data
The cartridge will trigger on URLs matching either ^https?://(www.)?instagr.am/.* or ^https?://(www.)?instagram.com/.*; this caters for both old and new (after July-2012) patterns.