{"_id":"5864d2e079ce642d00f0ff20","project":"56439dfe9eebf70d00490d54","version":{"_id":"5864d2df79ce642d00f0fec7","project":"56439dfe9eebf70d00490d54","__v":4,"createdAt":"2016-12-29T09:09:51.074Z","releaseDate":"2016-12-29T09:09:51.074Z","categories":["5864d2df79ce642d00f0fec8","5864d2df79ce642d00f0fec9","5864d2df79ce642d00f0feca","5864d2df79ce642d00f0fecb","5864d2df79ce642d00f0fecc","5864d2df79ce642d00f0fecd","5864d2df79ce642d00f0fece","5864d2df79ce642d00f0fecf","5864d2df79ce642d00f0fed0","5864d2df79ce642d00f0fed1","5864d2df79ce642d00f0fed2","5864d2df79ce642d00f0fed3","5864d2df79ce642d00f0fed4","5864d2df79ce642d00f0fed5","5864d2df79ce642d00f0fed6","5864d2df79ce642d00f0fed7","5864d2df79ce642d00f0fed8","5864d2df79ce642d00f0fed9","5864d2df79ce642d00f0feda","5864d2df79ce642d00f0fedb","5864d2df79ce642d00f0fedc","5864d2df79ce642d00f0fedd","5864d2df79ce642d00f0fede","598aa64f4b6e990019b7a2d2","599bc76bc03fa2000f83db2a","599bcc3c3c5bf7000f3434fc"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"__v":0,"category":{"_id":"5864d2df79ce642d00f0fec9","project":"56439dfe9eebf70d00490d54","__v":0,"version":"5864d2df79ce642d00f0fec7","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-19T00:09:16.715Z","from_sync":false,"order":1,"slug":"authentication","title":"Authentication"},"parentDoc":null,"user":"55dd6b48a649eb170083b97a","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-03T05:58:37.414Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"In order to interact with Gooru's API, you must first have API access credentials , a client_id and a client_secret. These credentials must be obtained directly from Gooru staff. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Header authentication\",\n  \"body\": \"The authentication (access token or anonymous access token) is done in the header of each request which MUST contain the access token.\"\n}\n[/block]\nOnce in possession with a client_id and client_key, you can either obtain an anonymous access token or proceed to authenticate with any existing user credentials. This returned token should then be used and is required in the Header of almost all API calls.\n\nSome API calls (mostly write operations) will require actual user authenticated access token, not just anonymous access token.","excerpt":"","slug":"authentication-flow","type":"basic","title":"Authentication Flow"}

Authentication Flow


In order to interact with Gooru's API, you must first have API access credentials , a client_id and a client_secret. These credentials must be obtained directly from Gooru staff. [block:callout] { "type": "info", "title": "Header authentication", "body": "The authentication (access token or anonymous access token) is done in the header of each request which MUST contain the access token." } [/block] Once in possession with a client_id and client_key, you can either obtain an anonymous access token or proceed to authenticate with any existing user credentials. This returned token should then be used and is required in the Header of almost all API calls. Some API calls (mostly write operations) will require actual user authenticated access token, not just anonymous access token.