API

Dive Seven provides a simple HTTP API that exposes high level aggregate data from your dive logs.

Use this data however you see fit, and be sure to let us know what you do with it! We are working on making some widgets that you can host on your site directly.

Request

Requests should be made as HTTP GETs from a URL resembling:

http://diveseven.com/api/profile-data/1

The integer at the end of the URL represents your Dive Seven user ID.

Response

Here's a sample response:

{
  "success": true,
  "user": {
    "id": 1,
    "name": "Drew Noakes",
    "profileUrl": "http://diveseven.com/user/profile/1/drew-noakes",
    "profileImageUrl": "http://www.gravatar.com/avatar/b84e6292d0f33d04da2d29cb9b5406e1?d=mm",
    "location": "London, United Kingdom",
    "fromRegionIso2": "GB",
    "flagUrl": "http://diveseven.com/f/16/gb.png",
    "logCount": 27,
    "diveSiteCount": 24,
    "cumulativeDepth": {
      "value": 568.8,
      "unit": "m",
      "unitLong": "metres"
    },
    "averageMaxDepth": {
      "value": 21.0666667,
      "unit": "m",
      "unitLong": "metres"
    },
    "totalBottomTimeMinutes": 1493.0,
    "divedInCountries": [
      {
        "name": "Egypt",
        "flagUrl": "http://diveseven.com/f/16/eg.png"
      },
      {
        "name": "Mexico",
        "flagUrl": "http://diveseven.com/f/16/mx.png"
      },
      {
        "name": "Malaysia",
        "flagUrl": "http://diveseven.com/f/16/my.png"
      },
      {
        "name": "Thailand",
        "flagUrl": "http://diveseven.com/f/16/th.png"
      }
    ],
    "extremes": [
      {
        "title": "Deepest Dive",
        "value": 36.0,
        "unit": "metres",
        "logUrl": "http://diveseven.com/dive-log/view/90180",
        "siteName": "El Catedral",
        "regions": [
          "Mexico",
          "Cozumel",
          "Quintana Roo",
          "Caribbean Sea",
          "North America"
        ],
        "flagUrl": "http://diveseven.com/f/16/mx.png"
      },
      {
        "title": "Coldest Dive",
        "value": 22.0,
        "unit": "°C",
        "logUrl": "http://diveseven.com/dive-log/view/89512",
        "siteName": "Triggerfish Bay",
        "regions": [
          "Egypt",
          "Abu Galum",
          "Dahab",
          "South Sinai",
          "Gulf of Aqaba",
          "Red Sea"
        ],
        "flagUrl": "http://diveseven.com/f/16/eg.png"
      },
      {
        "title": "Longest Dive",
        "value": 82.0,
        "unit": "minutes",
        "logUrl": "http://diveseven.com/dive-log/view/90188",
        "siteName": "Plane Wreck",
        "regions": [
          "Mexico",
          "Cozumel",
          "Quintana Roo",
          "Caribbean Sea",
          "North America"
        ],
        "flagUrl": "http://diveseven.com/f/16/mx.png"
      }
    ]
  }
}