Charity Hack 2012

JustGiving’s APIs

@jghackers

Over 15m

users

Over8,000

charitiesover

£1bnraised

24m APIhits in2012

In short…

• We’re a pretty large fundraising platform

• We enable charities and fundraisers to collect money online

• We enable Gift Aid collection quickly and efficiently

• We have developed APIs to enable much of the above

Most people…

• Create & validate JustGiving accounts

• Create & retrieve fundraising pages/data

• Funnel donations to charity using the JustGiving SDI*

Simple Donation Integration

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

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

• You can then use the API to verify the donation (if you want)

• Really really simple (i.e. I can build it!)

APIs available

We’ve got API access to quite a lot of our data now, and we’re aiming for more coverage over time

• Account data, creation and management• Charity data (name, logo, description, charity commission #)• Donation data (donor, amount, status)• Event data and creation• Fundraising page data, creation and management• Charity search• Team data, creation and management

Libraries

• C# SDK

• PHP SDK

• Code Samples on GitHub

Lets Make A Page - Request

Lets Make A Page - Response

Bingo

Page Data

• Event• Total raised• Total SMS donations• Target• Charity• Charity Image• Charity Reg #…and much more

Donation Data

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!

Sandbox

API = https://api-sandbox.justgiving.com

Platform = www.v3-sandbox.justgiving.com

Team JG – here to help!

Help, I’m stuck?!

Help, I’m stuck?!

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

2.Facebook Group at https://www.facebook.com/groups/charityhack2012/

3.Come grab us in person!

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

Eyes on the Prize

• £250 Apple vouchers• Chance to polish app with JustGiving team