Nutella Pancake Machine

    23andme

    1.1.0 • Public • Published

    23andme NPM version

    JavaScript wrapper for the 23andMe API.

    Installation

    Install the package with NPM:

    $ npm install 23andme

    Usage

    Minimal example:

    import API from "23andme";
     
    let clientId = "fake_client_id";
    let clientSecret = "fake_client_secret";
    let redirectUri = "http://localhost:9000/receive_code";
    let scope = ["ancestry"];
    let api = new API(clientId, clientSecret, redirectUri, scope);
     
    function receiveCode(code) {
      api.auth(code)
      .then(() => api.ancestry())
      .then(ancestry => console.log(ancestry))
      .catch(err => console.error(err));
    }

    As can be seen, the package exposes an API wrapper class that can be instantiated. This class has the following methods:

    • constructor(clientId, clientSecret, redirectUri, scope)
      • Creates an instance of the class.
    • auth(code)
      • Authenticates with the 23andMe API by exchanging an authorization code for an authorization token.
      • Returns a Promise of the authorization token.
      • Call this method first before you make any API requests!
    • user()
      • Retrieves data from the API's /user endpoint.
      • Returns a Promise of the endpoint's response data.
    • names()
      • Retrieves data from the API's /names endpoint.
      • Returns a Promise of the endpoint's response data.
    • haplogroups()
      • Retrieves data from the API's /haplogroups endpoint.
      • Returns a Promise of the endpoint's response data.
    • ancestry()
      • Retrieves data from the API's /ancestry endpoint.
      • Returns a Promise of the endpoint's response data.
    • familyMembers()
      • Retrieves data from the API's /family_members endpoint.
      • Returns a Promise of the endpoint's response data.
    • relatives()
      • Retrieves data from the API's /relatives endpoint.
      • Returns a Promise of the endpoint's response data.

    And the following properties:

    • authUri
      • The URI to redirect the user's Web browser to in order for them to login to 23andMe and be granted an authorization code. (When 23andMe sends the authorization code to your server, pass it to the auth() method!)
    • baseUri
      • The base URI of the 23andMe API.
    • token
      • The authorization token granted when auth() was called.

    Disclaimer

    The package is not officially affiliated with 23andMe in any way. Use at own risk.

    Install

    npm i 23andme

    DownloadsWeekly Downloads

    13

    Version

    1.1.0

    License

    MIT

    Last publish

    Collaborators

    • lukehorvat