{"_id":"564d1afa4567342100ad96b3","category":{"_id":"564d1af94567342100ad96ab","__v":1,"project":"551375e1d04af219007ddc52","pages":["564d1afa4567342100ad96b3","564d1afa4567342100ad96b4","564d1afa4567342100ad96b5","564d1afa4567342100ad96b6"],"version":"564d1af84567342100ad96aa","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-29T17:23:57.281Z","from_sync":false,"order":0,"slug":"human-api-overview","title":"Human API Overview"},"project":"551375e1d04af219007ddc52","__v":4,"user":"5539912a0074c80d00621b14","version":{"_id":"564d1af84567342100ad96aa","project":"551375e1d04af219007ddc52","__v":1,"createdAt":"2015-11-19T00:42:32.705Z","releaseDate":"2015-11-19T00:42:32.705Z","categories":["564d1af94567342100ad96ab","564d1af94567342100ad96ac","564d1af94567342100ad96ad","564d1af94567342100ad96ae","564d1af94567342100ad96af","564d1af94567342100ad96b0","564d1af94567342100ad96b1","564d1af94567342100ad96b2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"updates":["554b732f6b448d0d00646dca"],"next":{"pages":[],"description":""},"createdAt":"2015-04-29T17:24:19.424Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Human API is a platform that allows users to securely share their health data with developers of health applications and systems. Our data network includes activity data recorded by pedometers, blood pressure measurements captured by digital cuffs, medical records from hospitals, and more.\n\n\nHuman API takes care of the data synchronizations with third party data sources, user management for your user identities across all data sources, and processes and normalizes the data over a secure, HIPAA compliant, RESTful API.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Core Components\"\n}\n[/block]\n- [A fast growing list of data sources](doc:data-network) to retrieve data from\n\n- [Human Connect](doc:overview-of-human-connect), a single sign-on to authenticate users' health data from all sources\n\n- [The Data API](doc:data-overview), a unified, normalized API to manage users' health data\n\n- [The Developer Portal](https://developer.humanapi.co/) to easily manage all users, data, and connections\n\nLets examine each in detail and how they work together:\n\n\n\n#Ecosystem of Wellness and Medical Data Sources\nHuman API partners and works with a wide variety of data sources, from electronic medical records, activity trackers, blood glucose monitors, apps, and more. This ecosystem of data sources provides the building blocks of data on which Human API developers can build their applications. More information on data types can be found [here](doc:data-types).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/lgG1bTPQVCeG0mHKYcvO_WellnessIcons.png\",\n        \"WellnessIcons.png\",\n        \"684\",\n        \"224\",\n        \"#ef6636\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n\n\n#Human Connect Single Sign-on\nHuman API provides a simple way for you to authenticate your users' health data from anywhere within our data source network. When you integrate our authentication process into your web or mobile application, your users will be prompted with a popup to grant your application access to their health data. The process of integrating Human Connect is straightforward and fast.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8zee9XDQRKf5pVQDEXOK_wellnessKannectChrome.png\",\n        \"wellnessKannectChrome.png\",\n        \"691\",\n        \"360\",\n        \"#3e7bd9\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#A Normalized API\nHuman API pulls in, cleans up, structures, and normalizes all of this health data and provides a unified API for your backend to query. We give you a single access token for a user's records, which you can use like a key to query whatever data they have provided you with. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/BTfmYCKESdOsez2CN0Yy_Screen%20Shot%202016-05-31%20at%204.29.24%20PM.png\",\n        \"Screen Shot 2016-05-31 at 4.29.24 PM.png\",\n        \"1392\",\n        \"821\",\n        \"#659fda\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n#Developer and Data Management Portal\nHuman API provides a Developer Portal, which is the hub of your Human API experience. In this portal, you will be able to set up and configure your applications and backend, select which data sources you want to retrieve data from, invite team members to collaborate on your app, create and authenticate users, and manage their respective access tokens and data.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ow42RXgWSxCdrwNjYmy8_Screen%20Shot%202016-05-31%20at%204.28.01%20PM.png\",\n        \"Screen Shot 2016-05-31 at 4.28.01 PM.png\",\n        \"1392\",\n        \"821\",\n        \"#5992d1\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nFor more information on Human API, please see the pages below:\n- [Architecture](doc:architecture) \n- [Security](doc:security) \n- [Data Types](doc:data-types) \n\nOr, [Start Here](doc:start-here) to get right to coding!","excerpt":"This section covers the components of Human API and how it works.","slug":"overview","type":"basic","title":"What is Human API?"}

What is Human API?

This section covers the components of Human API and how it works.

Human API is a platform that allows users to securely share their health data with developers of health applications and systems. Our data network includes activity data recorded by pedometers, blood pressure measurements captured by digital cuffs, medical records from hospitals, and more. Human API takes care of the data synchronizations with third party data sources, user management for your user identities across all data sources, and processes and normalizes the data over a secure, HIPAA compliant, RESTful API. [block:api-header] { "type": "basic", "title": "Core Components" } [/block] - [A fast growing list of data sources](doc:data-network) to retrieve data from - [Human Connect](doc:overview-of-human-connect), a single sign-on to authenticate users' health data from all sources - [The Data API](doc:data-overview), a unified, normalized API to manage users' health data - [The Developer Portal](https://developer.humanapi.co/) to easily manage all users, data, and connections Lets examine each in detail and how they work together: #Ecosystem of Wellness and Medical Data Sources Human API partners and works with a wide variety of data sources, from electronic medical records, activity trackers, blood glucose monitors, apps, and more. This ecosystem of data sources provides the building blocks of data on which Human API developers can build their applications. More information on data types can be found [here](doc:data-types). [block:image] { "images": [ { "image": [ "https://files.readme.io/lgG1bTPQVCeG0mHKYcvO_WellnessIcons.png", "WellnessIcons.png", "684", "224", "#ef6636", "" ] } ] } [/block] #Human Connect Single Sign-on Human API provides a simple way for you to authenticate your users' health data from anywhere within our data source network. When you integrate our authentication process into your web or mobile application, your users will be prompted with a popup to grant your application access to their health data. The process of integrating Human Connect is straightforward and fast. [block:image] { "images": [ { "image": [ "https://files.readme.io/8zee9XDQRKf5pVQDEXOK_wellnessKannectChrome.png", "wellnessKannectChrome.png", "691", "360", "#3e7bd9", "" ] } ] } [/block] #A Normalized API Human API pulls in, cleans up, structures, and normalizes all of this health data and provides a unified API for your backend to query. We give you a single access token for a user's records, which you can use like a key to query whatever data they have provided you with. [block:image] { "images": [ { "image": [ "https://files.readme.io/BTfmYCKESdOsez2CN0Yy_Screen%20Shot%202016-05-31%20at%204.29.24%20PM.png", "Screen Shot 2016-05-31 at 4.29.24 PM.png", "1392", "821", "#659fda", "" ] } ] } [/block] #Developer and Data Management Portal Human API provides a Developer Portal, which is the hub of your Human API experience. In this portal, you will be able to set up and configure your applications and backend, select which data sources you want to retrieve data from, invite team members to collaborate on your app, create and authenticate users, and manage their respective access tokens and data. [block:image] { "images": [ { "image": [ "https://files.readme.io/ow42RXgWSxCdrwNjYmy8_Screen%20Shot%202016-05-31%20at%204.28.01%20PM.png", "Screen Shot 2016-05-31 at 4.28.01 PM.png", "1392", "821", "#5992d1", "" ] } ] } [/block] For more information on Human API, please see the pages below: - [Architecture](doc:architecture) - [Security](doc:security) - [Data Types](doc:data-types) Or, [Start Here](doc:start-here) to get right to coding!