33
CRUK HACKATHON JustGiving’s APIs @jghackers

JustGiving API presentation for CRUK Hackathon

Embed Size (px)

Citation preview

CRUK HACKATHON

JustGiving’s APIs

@jghackers

Over 15m

users

Over9,000

charitiesover

£1bnraised

50m APIhits in2013

Innovating together

Recent Examples

POWERED

BY

Justgiving

APIS

Working with CRUK

On JustGiving you can…

• Create a fundraising page and donate to it

• Make a direct donation to a charity (one off or recurring)

• You can donate in multiple currencies

• You can donate via SMS (JustTextGiving)

• You can join in a team of fundraisers

NEW! Crowdfunding

NEW! Crowdfunding

1. Register Fundraising Page

https://api.justgiving.com/docs/resources/v1/Fundraising/RegisterFundraisingPage

• Used to create fundraising pages for users

• Generates 250k+ pages per year on Race For Life

• Can PUT certain content (images, story, videos etc) to the fundraising page

• Page types include Event based, In Memory, Birthdays etc

2. Get Page Details

https://api.justgiving.com/docs/resources/v1/Fundraising/GetFundraisingPageDetails

• GET data from any given fundraising page (totals, donation comments, media etc)

• Used to pull display data in the Race For Life Android App

3. Get Donations For User

https://api.justgiving.com/docs/resources/v1/Account/GetDonationsForUser

• GET donation history (amount, charity, date etc) for any given user (requires Auth)

4. Account Registration

https://api.justgiving.com/docs/resources/v1/Account/Register

• Create a normal consumer account for a new user based upon a unique email address.

• Used to create new accounts for Dryathlon users signing up via the Facebook App

Simple Donation Integration (SDI)

No - we don’t have a donation API

• SDI is a redirect based integration technique

• Allows you to send users to JustGiving to make a donation (optimised for mobile)

• Users are returned to your site afterwards with some query string magic

• You then use the API to verify the donation

• Simple stuff

Sandbox

API = https://api-sandbox.justgiving.com Platform = www.v3-sandbox.justgiving.com

Key to the Kingdom

1. Set yourself up with a developer key at

https://apimanagement.justgiving.com/signup

2. Create an application https://apimanagement.justgiving.com/admin/applications

3. Point to sandbox

4. Away you go!

Test Cards for Donations

Useful stuff to know…

CRUK Charity ID = 2357

Test Card Details =

- Master Card

- 5105105105105100

- Any valid looking expiry date / start date / CV2 code

- Auth Code = 12345

Help, I’m stuck?!

Help is on hand!

1.Come grab us in person!

2.Google Support Group at https://groups.google.com/forum/?fromgroups#!forum/justgiving-api

3.Tweet us at @jghackers

Useful Links & Documents• GitHub repository with open source SDKs

https://github.com/JustGiving/JustGiving.Api.Sdk

• Sign up for an API account and create API keys

http://apimanagement.justgiving.com

• Documentation and usage information

https://api.justgiving.com/docs

• Developer portal

http://www.justgiving.com/developer

• Simple Donation Integration guide

http://www.justgiving.com/developer/simple-donation-integration

• Some hack-tastic examples in a few languages

https://github.com/JustGiving/JustGiving.Api.Sdk/wiki

• Logos & Assets

https://justgiving-charity-support.zendesk.com/entries/210512

The Growth of mobile on JustGiving

Percentage of mobile & tablet visits to JustGiving

A *marathon* amount of mobile traffic

Growth of mobile Facebook

Mobile Facebook has overtaken desktop Facebook

Our mobile journey

Jan 2011 July 2012 October 2012

New mobile social sharing

Mobile users share more

Social begets social

Shared donations that result in another donation

Shared donations that result in another share

Slacktivism is a myth