{"_id":"56b276461bc8490d00701fc9","project":"56abd2434e4b730d009eb10a","__v":26,"category":{"_id":"56abd2444e4b730d009eb10e","version":"56abd2434e4b730d009eb10d","__v":9,"pages":["56abd2454e4b730d009eb110","56af82fd5b1f01170014dbd6","56b276461bc8490d00701fc9","56b279f73b6f690d00bdb76a","56b4bc4999c8d30d00f557f1","56b4bdf95997532100bc6b70","56b50972eed075230097d71a","56b520525f1cf00d00cc4737","56c34084521f350d00d34864"],"project":"56abd2434e4b730d009eb10a","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-29T20:57:40.302Z","from_sync":false,"order":0,"slug":"documentation","title":"Documentación"},"version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":20,"createdAt":"2016-01-29T20:57:39.712Z","releaseDate":"2016-01-29T20:57:39.712Z","categories":["56abd2444e4b730d009eb10e","56abd4c8f25f160d00e17f81","56abd72ff25f160d00e17f84","56b3b8ea9f97020d0012d936","56b3b91ac25dea2b00b0cac9","56b4b2faeed075230097d688","56b4b32deed075230097d689","56b4b37327d9c00d005d6bc4","56b4b3bf3d5f130d00dad120","56b4b3d9eed075230097d68a","56b4b3eb7bccae0d00e9a12e","56b4b4085997532100bc6b61","56fbce6e2885e80e006c855f","5739ed9aad40e23200f674b6","573dd672b3f88f0e00dcae1c","58ad0922e570c62500512a82","58ad092b55018f1900218fda","58e412a5aa544d1b0005f7da","59e62c2a3ccab100263e800a","59e63126b4f8b0002edbe92c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"parentDoc":null,"user":"56abd213d4432d1900eed227","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-03T21:51:02.011Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"El API de Alegra utiliza Basic Access como método de autenticación. Todos los request que se realicen deben incluir el header *Authorization*. \n\nEl acceso al API se realiza utilizando el correo y el token otorgado al usuario registrado en Alegra. \n\n## Obtener token de acceso\n Debes seguir los siguientes pasos para obtener el token de acceso:\n\n1. Ingresar a aplicación [Alegra](http://app.alegra.com). \n2. Haz clic sobre el vínculo \"Configuración\" en la parte superior derecha de la pantalla de Alegra y haz clic en la sección \"API - Integraciones con otros sistemas\"\n3. En la nueva pantalla puedes encontrar el correo con el cual debes acceder al API y el token. Si aún no cuentas con un token puedes generarlo también.\n\n## ¿Cómo utilizar el token?\nEn el header *Authorization* se debe poner el correo y el token del usuario separado por dos puntos (:), todo en base64.\n\nPor ejemplo, si el correo del usuario es ejemploapi:::at:::alegra.com y el token es tokenejemploapi12345 el header *Authorization* debe quedar así : \n```\nAuthorization: Basic ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1\n```\n\nDonde ```ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1``` es base_64('ejemploapi@alegra.com:tokenejemploapi12345')\n\n## Errores en autenticación\nSi el API encuentra algún inconveniente con la autenticación retorna un código 401 y el error encontrado.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/i9VyJPS8Qtqrn80hre17_Captura%20de%20pantalla%202016-02-04%20a%20la(s)%208.44.18.png\",\n        \"Captura de pantalla 2016-02-04 a la(s) 8.44.18.png\",\n        \"746\",\n        \"110\",\n        \"#c76969\",\n        \"\"\n      ],\n      \"sizing\": \"smart\",\n      \"caption\": \"Ejemplo error en autenticación\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"autenticacion","type":"basic","title":"Autenticación"}
El API de Alegra utiliza Basic Access como método de autenticación. Todos los request que se realicen deben incluir el header *Authorization*. El acceso al API se realiza utilizando el correo y el token otorgado al usuario registrado en Alegra. ## Obtener token de acceso Debes seguir los siguientes pasos para obtener el token de acceso: 1. Ingresar a aplicación [Alegra](http://app.alegra.com). 2. Haz clic sobre el vínculo "Configuración" en la parte superior derecha de la pantalla de Alegra y haz clic en la sección "API - Integraciones con otros sistemas" 3. En la nueva pantalla puedes encontrar el correo con el cual debes acceder al API y el token. Si aún no cuentas con un token puedes generarlo también. ## ¿Cómo utilizar el token? En el header *Authorization* se debe poner el correo y el token del usuario separado por dos puntos (:), todo en base64. Por ejemplo, si el correo del usuario es ejemploapi@alegra.com y el token es tokenejemploapi12345 el header *Authorization* debe quedar así : ``` Authorization: Basic ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1 ``` Donde ```ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1``` es base_64('ejemploapi@alegra.com:tokenejemploapi12345') ## Errores en autenticación Si el API encuentra algún inconveniente con la autenticación retorna un código 401 y el error encontrado. [block:image] { "images": [ { "image": [ "https://files.readme.io/i9VyJPS8Qtqrn80hre17_Captura%20de%20pantalla%202016-02-04%20a%20la(s)%208.44.18.png", "Captura de pantalla 2016-02-04 a la(s) 8.44.18.png", "746", "110", "#c76969", "" ], "sizing": "smart", "caption": "Ejemplo error en autenticación" } ] } [/block]