OAuth Providers
Obtain access tokens to Socrata accounts with Handshake.

How it works

With your instance deployed, simply redirect users to:


Where HANDLER_ID is either socrata or the value passed to the optional id argument of the Socrata() factory. (See Usage below.)

Handshake will take the user through the Socrata OAuth flow and redirect them back to the URL specified by the callback_uri query parameter.


Modify your app/options.ts file to include the Socrata() handler like so:

import { Socrata, HandshakeOptions } from "handshake";
const config: HandshakeOptions = {
  handlers: [
      clientId: string,
      clientSecret: string,
      subdomain: string,
// ...

Consult the reference to learn about HandshakeOptions.


Having an issue making Socrata work? Open an issue in our Github repo to get help from our team.