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/2

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

Response

Here's a sample response:

{
  "success": true,
  "user": {
    "id": 2,
    "name": "Rick Hartley",
    "profileUrl": "http://diveseven.com/user/profile/2/rick-hartley",
    "profileImageUrl": "http://www.gravatar.com/avatar/b7b75889709c2c45f0d2be7c2f6326c1?d=mm",
    "location": "Miami, Florida",
    "fromRegionIso2": "US",
    "flagUrl": "http://diveseven.com/f/16/us.png",
    "logCount": 169,
    "diveSiteCount": 90,
    "cumulativeDepth": {
      "value": 2907.6,
      "unit": "m",
      "unitLong": "metres"
    },
    "averageMaxDepth": {
      "value": 19.0039216,
      "unit": "m",
      "unitLong": "metres"
    },
    "totalBottomTimeMinutes": 7562.0,
    "divedInCountries": [
      {
        "name": "Australia",
        "flagUrl": "http://diveseven.com/f/16/au.png"
      },
      {
        "name": "Egypt",
        "flagUrl": "http://diveseven.com/f/16/eg.png"
      },
      {
        "name": "France",
        "flagUrl": "http://diveseven.com/f/16/fr.png"
      },
      {
        "name": "Mexico",
        "flagUrl": "http://diveseven.com/f/16/mx.png"
      },
      {
        "name": "Malaysia",
        "flagUrl": "http://diveseven.com/f/16/my.png"
      },
      {
        "name": "Philippines",
        "flagUrl": "http://diveseven.com/f/16/ph.png"
      },
      {
        "name": "Thailand",
        "flagUrl": "http://diveseven.com/f/16/th.png"
      },
      {
        "name": "United States",
        "flagUrl": "http://diveseven.com/f/16/us.png"
      },
      {
        "name": "U.S. Virgin Islands",
        "flagUrl": "http://diveseven.com/f/16/vi.png"
      }
    ],
    "extremes": [
      {
        "title": "Deepest Dive",
        "value": 40.2,
        "unit": "metres",
        "logUrl": "http://diveseven.com/dive-log/view/89513",
        "siteName": "El Shugarat",
        "regions": [
          "Egypt",
          "Dahab",
          "South Sinai",
          "Gulf of Aqaba",
          "Red Sea"
        ],
        "flagUrl": "http://diveseven.com/f/16/eg.png"
      },
      {
        "title": "Coldest Dive",
        "value": 14.0,
        "unit": "°C",
        "logUrl": "http://diveseven.com/dive-log/view/89830",
        "siteName": "Fairy Bower",
        "regions": [
          "Australia",
          "Sydney",
          "New South Wales",
          "Tasman Sea"
        ],
        "flagUrl": "http://diveseven.com/f/16/au.png"
      },
      {
        "title": "Longest Dive",
        "value": 84.0,
        "unit": "minutes",
        "logUrl": "http://diveseven.com/dive-log/view/89553",
        "siteName": "Wall Street",
        "regions": [
          "Philippines",
          "Tubbataha",
          "North Atoll",
          "Palawan",
          "Sulu Sea",
          "Asia"
        ],
        "flagUrl": "http://diveseven.com/f/16/ph.png"
      }
    ]
  }
}