You can install the extra-life module via npm or yarn:
npm i extra-life
yarn add extra-lifeThis module is multi-platform and can be used in Node.js scripts or within the browser. The
module has ZERO dependencies and will natively use the https built-in in Node or fetch
in the browser. If you are using this in a browser that doesn't natively incorporate fetch,
you can polyfill.
The interfaces exposed are based off of the DonorDrive Public API spec.
In Node, it is as simple as requiring the module and using it.
const extraLife = require('extra-life');
extraLife.getTeam(45209).then(console.log);There are two ways to use this module in the browser. The first way is to import it into your project that will be transpiled.
import { getTeam } from 'extra-life';
getTeam(45209).then(console.log);The second way is to include the raw extra-life.js file from this package directly in your HTML
and then access the extraLife variable to make your API calls.
<script src="path/to/extra-life.js"></script>
<script>
extraLife.getTeam(45209).then(console.log);
</script>All methods defined below return
ES6 Promises.
You can use simple .then() notation or async/await, depending on your preference.
The payload returned for each method will be in accordance with the
DonorDrive documentation.
The few methods that optionally take a limit and a page will return a response object
with a totalRecords count and the results in a records array:
{
totalRecords: 100,
records: [...]
}Each method here, with the exception of getParticipants, requires a participantId. You can
get a participantId from the results of getParticipant, or from the URL of a participant
on the Extra Life website.
The URL will look like: https://extra-life.org/index.cfm?fuseaction=donordrive.participant&participantID=[PARTICIPANT ID HERE]
Available methods:
- getParticipants
- getParticipant
- getParticipantActivity
- getParticipantBadges
- getParticipantDonations
- getParticipantDonors
Retrieves all participants in the current Extra Life event.
Retrieves information about a given participant.
Retrieves the five most recent activities for a given participant.
Retrieves the badges a given participant has earned.
Retrieves all donataions a given participant has received.
Retrieves all donors whom have donated to a given participant.
Each method here, with the exception of getTeams, requires a teamId. You can get a
teamId from the results of getTeam, or from the URL of a team on the Extra Life
website.
The URL will look like: https://www.extra-life.org/index.cfm?fuseaction=donordrive.team&teamID=[TEAM ID HERE]
Available methods:
Retrieves all teams in the current Extra Life event.
Retrieves information about a given team.
Retrieves the five most recent activities for a given team.
Retrieves the badges a given team has earned.
Retrieves all donataions a given team has received.
Retrieves all donors whom have donated to a given team.
Retrieves all participants who are members of a given team.
Extra Life is an event and charity like no other. I have been participating in Extra Life for over 5 years and really enjoy being able to provide hope to children in need, especially when all they want to do is feel better and be kids!
If you used this module, or are just feeling generous, please consider donating to this amazing cause. Your donations directly benefit Children's Miracle Network Hospitals and are tax deductable.