Git Product home page Git Product logo

nango's Introduction

+ Looking for Pizzly? You are in the right place. Pizzly has been renamed Nango. Using Pizzly v0.2.x? Check out: https://docs.nango.dev/migration +

Get OAuth tokens for APIs. Fast & secure.

Pre-built OAuth flows & secure token management for 40+ APIs. 100% open source.


Explore the docs »

All supported APIs · Docs · Website · Contribute an API · Report Bug · Slack Community

⭐ Nango at a glance

Nango is a service that contains everything you need to work with APIs that use OAuth.

It contains:

  • a full OAuth dance for 40+ APIs
  • a frontend SDK to trigger new OAuth flows
  • a backend SDK & REST API to retrieve fresh access tokens for your API calls

Nango is easy to try in 5 minutes and can be deployed in 15:

  • 1-liner to start a new OAuth flow in your frontend:
let result = await nango.auth('github', '<user-id>');
  • 1-liner to retrieve a token (with our SDK or REST API):
let token = await nango.getToken('github', '<user-id>');

👾 Out of the box support for 40+ APIs

40+ APIs are preconfigured to work out-of-the-box. Including:

  • CRM: Front, Hubspot, Salesforce, etc.
  • Accounting: Xero, Sellsy, Zoho Books, etc.
  • Developer tools: GitHub, GitLab, Linear, Jira etc.
  • Communication: Gmail, Microsoft Teams, Slack, Zoom etc.
  • Productivity: Asana, Airtable, Google Drive, Google Calendar, Trello, Google sheets, ClickUp etc.
  • Social: Twitter, LinkedIn, Reddit, Facebook etc.
  • and more...

If your favorite API is missing open a GitHub issue or contribute it right away: The API configurations are just simple entries in a YAML file.

🛡️ Small, self-contained & ready for production

Nango is purposely small, focused on its one task and easy to deploy in production:

  • Runs as a single docker container
  • Updates easily (docker pull)
  • Secured with an API key
  • Managed with a CLI
  • Cloud hosting available

Nango's community continuously maintains & expands API templates.

🚀 Quickstart

In <5mins, learn how to access & manage OAuth tokens for any API, using Github as an example. Ready? Go! ⏰

First, clone and start Nango:

git clone https://github.com/NangoHQ/quickstart.git && cd quickstart
docker compose up # Keep the tab open

In a new tab, add any Github OAuth App to Nango (optionally register your own Github OAuth App):

npx nango config:create github-dev github 57876b21174fed02b905 e43242c9a67fa06141e8d219c2364283d14f9ad1 "user,public_repo"

Authorize Github on this example page. Nango will securely retrieve, store and refresh OAuth credentials. Now try:

npx nango token:get 1 github-dev

Congrats 🥳 You have a fresh token to access the Github API! Let's make sure it works (❗️replace TOKEN):

curl -XGET -G "https://api.github.com/users/bastienbeurier/repos" \
    -H "Authorization: Bearer TOKEN"

(In practice, you should use our backend SDK or REST API to fetch tokens from your codebase.)

Wanna go live? Go through the more detailed Step-By-Step Guide. You can self-host Nango or use Nango Cloud.

🔍 Where to learn more

🐻 History

Pizzly (the original name of this project) was initially developed by the team at Bearer with contributions of more than 40 individuals. Over time the focus of Bearer shifted and they could no longer maintain Pizzly. In late 2022 the team at Nango adopted the project and has since maintained and evolved it together with the growing Nango community.

nango's People

Contributors

frenchcooc avatar bastienbeurier avatar cfabianski avatar rguldener avatar markmichon avatar tanguyantoine avatar hagbarth avatar dependabot[bot] avatar listopadiya avatar matt-aitken avatar codewithtim avatar omnone avatar serkanozer avatar eykamp avatar kernelcode avatar rawkode avatar gailuron1964 avatar eteckq avatar fastmind-inc avatar nabilfreeman avatar grvsood avatar dopecodez avatar gmontard avatar iiqbal2000 avatar jackfischer avatar jeffsawatzky avatar lgo avatar kelnishi avatar lukas-mertens avatar mikamboo avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.