From Wiki

Revision as of 21:14, 9 February 2010 (view source) Shmuelakam (Talk | contribs) ← Older edit		Revision as of 21:49, 9 February 2010 (view source) Scott (Talk | contribs) (Added events and locations to profiles.) Newer edit →
Line 46:		Line 46:
	<li>Last Name</li>		<li>Last Name</li>
	<li>Display Name</li>		<li>Display Name</li>
		+	<li>Birth Event Id</li>
	<li>Birth Date</li>		<li>Birth Date</li>
		+	<li>Birth Location<sup>1</sup></li>
		+	<li>Death Event Id</li>
	<li>Death Date</li>		<li>Death Date</li>
-	<li>Location, Location, Location! pretty much ANY interface that will enable combining Geni info with Google Maps.</li>	+	<li>Death Location<sup>1</sup></li>
		+	<li>Residence Event Ids</li>
		+	<li>Current Location/Place of Burial<sup>1</sup></li>
	<li>TBD (feel free to add desired fields here)</li>		<li>TBD (feel free to add desired fields here)</li>
	</ul>		</ul>
		+
		+	<h3>Notes</h3>
		+	<sup>1</sup>Not sure if I should add location to profile.  I don't want to return too much data with every profile.  It's a choice between that and forcing another request to get the event data.  I'm leaning toward adding flags to indicate what extra fields you want returned.
	<h1>Tree Access</h1>		<h1>Tree Access</h1>

---

Revision as of 21:49, 9 February 2010

Contents 1 API Notes 2 Parameters 3 Profile Access 3.1 Fields: 3.1.1 Notes 4 Tree Access 4.1 Fields: 5 Event Access 6 Media Access

API Notes

• OAuth authentication.
• Can also make calls using web browser once you're logged in
• First pass will be read-only

Parameters

Formats:

• json
• ged (GEDCOM 5.5)
• xml (not-GEDCOM 6)

Walks:

• ancestors
• blood_tree
• descendants
• forest
• immediate_family

Profile Access

geni.com/api/v1/profiles/<id>.<format>	other
geni.com/api/v1/profiles.<format>	your immediate family
geni.com/api/v1/profiles.<format>?ids=<id,id,...>	up to 50 other profiles

Fields:

Permission required for some.

• First Name
• Middle Name
• Last Name
• Display Name
• Birth Event Id
• Birth Date
• Birth Location¹
• Death Event Id
• Death Date
• Death Location¹
• Residence Event Ids
• Current Location/Place of Burial¹
• TBD (feel free to add desired fields here)

Notes

¹Not sure if I should add location to profile. I don't want to return too much data with every profile. It's a choice between that and forcing another request to get the event data. I'm leaning toward adding flags to indicate what extra fields you want returned.

Tree Access

geni.com/api/v1/trees/<walk</<id>.<format>	walk starting with other profile

Fields:

• Marriage id
• Partner ids
• Children ids

Event Access

TBD

Media Access

Photos, Videos, Documents, Links, ... TBD