alexxnica / coggle-opml-importer

Example Coggle API application, providing OPML import.

Coggle OPML Importer

What is it?

Coggle OPML importer is a node.js demo application for the Coggle API that imports OPML outline markup files into Coggle.

The user is authenticated to the Coggle API using OAuth. The passport-coggle-oauth2 module is used to authorize users, and retrieve an access token that can be sent along with requests to prove that the application is allowed create Coggles for the logged-in user.

Try It Here!

Get the Code!

First install node.js, then:

git clone [email protected]:Coggle/coggle-opml-importer.git
cd coggle-opml-importer
npm install

Running Coggle OPML Importer

To use the Coggle API you need a Client ID, and a Client Secret – which Coggle uses to identify requests to the applications that made them.

A new Client ID and Client Secret can be created at http://coggle.it/developer, where you can also configure the authentication redirect URL, which should be the domain (and optionally port) where you will host the application followed by /auth/coggle/callback, which is the Coggle oauth authentication callback route of the app. For example, to run the app locally you would set it to this:

localhost:5000/auth/coggle/callback

The Client ID and Client Secret both need to be provided as environment variables when you run the app. If they are missing the app will refuse to start. If they are incorrect, requests made by the app will fail. For example, to start the app in development mode run:

COGGLE_CLIENT_ID=aaaaaaaaaaaaaaaaaaaaaaaa \
COGGLE_CLIENT_SECRET=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb \
npm devstart

License

The MIT License