{"__v":28,"_id":"564d1afc4567342100ad96c7","category":{"__v":1,"_id":"564d1af94567342100ad96ac","pages":["564d1afc4567342100ad96c7","564d1afc4567342100ad96c8","564d1afc4567342100ad96c9","564d1afc4567342100ad96ca","564d1afc4567342100ad96cb","564d1afc4567342100ad96cc"],"project":"551375e1d04af219007ddc52","version":"564d1af84567342100ad96aa","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-03-26T02:58:42.784Z","from_sync":false,"order":1,"slug":"getting-started","title":"Getting Started"},"project":"551375e1d04af219007ddc52","user":"5539912a0074c80d00621b14","version":{"__v":1,"_id":"564d1af84567342100ad96aa","project":"551375e1d04af219007ddc52","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":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-27T22:50:56.357Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Welcome to [Human API](www.humanapi.co)! \n\nWe've provided some guides to help get you up and running as quickly as possible, and we're excited to have you on board. What follows is a technical explanation of the Human API integration process. For a higher-level view, check out [What is Human API?](doc:overview)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Integration Overview\"\n}\n[/block]\nHuman API has two main components:\n* **Human Connect** - UI to facilitate data source connections\n* **Data API** - Endpoints to pull user data from\n\nTo quickly grasp how an integration with Human API works, it is helpful to view the following diagram:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/QI3KkBPJQBGZyUJrhayA_Screen%20Shot%202015-11-19%20at%201.39.13%20PM.png\",\n        \"Screen Shot 2015-11-19 at 1.39.13 PM.png\",\n        \"721\",\n        \"313\",\n        \"#285276\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nIn the diagram, you'll see your application and server in orange, Human API's components and actions in blue, and all external data sources the user is trying to connect to in gray.\n\nThe flow here is simple:\n- **A**: A user of your application launches Human Connect to connect a data source\n- **B**: In Human Connect, they search for/select available data source(s) to connect to your application\n- **C**: When they are finished, Connect notifies our system of the connected accounts\n- **D**: Our system begins syncing their data from the source\n- **E**: Your server retrieves user credentials and data from Human API\n\nOnce a user has an active connection, we will continue to sync new data for that user and make it available to you. Most importantly, no matter what or how many sources the user connects, you'll end up with a single set of Human API credentials and one, normalized API to query all of that user's data. \n\nThere are two main components of integrating Human API:\n* **Authentication**\n  * Adding Human Connect to your application (Client Side)\n  * Retrieving a user's API Credentials (Server Side)\n* **Data Retrieval**\n  * Retrieving the user's data from the Data API\n\n  \n\n\nLet's get started! \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Setting Up Your Access Credentials\"\n}\n[/block]\nFirst, you'll need to sign up for a developer account at [developer.humanapi.co/signup](https://developer.humanapi.co/signup). \n\nAfter signing up, the first thing you'll want to do is create a Human API application. An application in Human API is a container that holds users and their data, and allows for custom configuration options. Above all, it is the single pipeline that you will integrate directly with your application.\n\nEach application has a specific set of keys found on the application's settings page that you'll need for development, as described below:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"**Client ID**\",\n    \"1-0\": \"**Client Secret**\",\n    \"2-0\": \"**App Key**\",\n    \"1-1\": \"Secret value for the application container\",\n    \"0-1\": \"Unique ID of the application container\",\n    \"2-1\": \"Authentication token for the [Application API](doc:application-api)\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Your **Client Secret** and **App Key** should be kept securely on your server. For support requests, please send along your **Client ID** only.\",\n  \"title\": \"Secure Values\"\n}\n[/block]\nNow that you've got application keys, everything is in place to start the integration. \n\nNext up, [integrating Human Connect](doc:overview-of-human-connect)!","excerpt":"","slug":"start-here","type":"basic","title":"Start Here"}
Welcome to [Human API](www.humanapi.co)! We've provided some guides to help get you up and running as quickly as possible, and we're excited to have you on board. What follows is a technical explanation of the Human API integration process. For a higher-level view, check out [What is Human API?](doc:overview) [block:api-header] { "type": "basic", "title": "Integration Overview" } [/block] Human API has two main components: * **Human Connect** - UI to facilitate data source connections * **Data API** - Endpoints to pull user data from To quickly grasp how an integration with Human API works, it is helpful to view the following diagram: [block:image] { "images": [ { "image": [ "https://files.readme.io/QI3KkBPJQBGZyUJrhayA_Screen%20Shot%202015-11-19%20at%201.39.13%20PM.png", "Screen Shot 2015-11-19 at 1.39.13 PM.png", "721", "313", "#285276", "" ] } ] } [/block] In the diagram, you'll see your application and server in orange, Human API's components and actions in blue, and all external data sources the user is trying to connect to in gray. The flow here is simple: - **A**: A user of your application launches Human Connect to connect a data source - **B**: In Human Connect, they search for/select available data source(s) to connect to your application - **C**: When they are finished, Connect notifies our system of the connected accounts - **D**: Our system begins syncing their data from the source - **E**: Your server retrieves user credentials and data from Human API Once a user has an active connection, we will continue to sync new data for that user and make it available to you. Most importantly, no matter what or how many sources the user connects, you'll end up with a single set of Human API credentials and one, normalized API to query all of that user's data. There are two main components of integrating Human API: * **Authentication** * Adding Human Connect to your application (Client Side) * Retrieving a user's API Credentials (Server Side) * **Data Retrieval** * Retrieving the user's data from the Data API Let's get started! [block:api-header] { "type": "basic", "title": "Setting Up Your Access Credentials" } [/block] First, you'll need to sign up for a developer account at [developer.humanapi.co/signup](https://developer.humanapi.co/signup). After signing up, the first thing you'll want to do is create a Human API application. An application in Human API is a container that holds users and their data, and allows for custom configuration options. Above all, it is the single pipeline that you will integrate directly with your application. Each application has a specific set of keys found on the application's settings page that you'll need for development, as described below: [block:parameters] { "data": { "h-0": "Key", "h-1": "Description", "0-0": "**Client ID**", "1-0": "**Client Secret**", "2-0": "**App Key**", "1-1": "Secret value for the application container", "0-1": "Unique ID of the application container", "2-1": "Authentication token for the [Application API](doc:application-api)" }, "cols": 2, "rows": 3 } [/block] [block:callout] { "type": "warning", "body": "Your **Client Secret** and **App Key** should be kept securely on your server. For support requests, please send along your **Client ID** only.", "title": "Secure Values" } [/block] Now that you've got application keys, everything is in place to start the integration. Next up, [integrating Human Connect](doc:overview-of-human-connect)!