{"id":1297,"date":"2024-09-26T17:46:28","date_gmt":"2024-09-26T20:46:28","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&#038;p=1297"},"modified":"2024-10-03T17:02:05","modified_gmt":"2024-10-03T20:02:05","slug":"gerar-autenticacao-oauth-access-token-2","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=gerar-autenticacao-oauth-access-token-2","title":{"rendered":"Gerar Autentica\u00e7\u00e3o oAuth (Access Token)"},"content":{"rendered":"\n<p> A API de Autentica\u00e7\u00e3o do Banco Semear utiliza o protocolo <strong>oAuth<\/strong>, proporcionando um mecanismo seguro e eficiente para autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o de acesso \u00e0s APIs. Esse m\u00e9todo garante que apenas clientes e parceiros devidamente autenticados possam realizar opera\u00e7\u00f5es em nome dos usu\u00e1rios, oferecendo controle total sobre as permiss\u00f5es e a seguran\u00e7a dos dados.<\/p>\n\n\n\n<p>Antes de acessar qualquer um dos servi\u00e7os oferecidos pelas APIs do Banco Semear, \u00e9 necess\u00e1rio gerar um <strong>Access Token<\/strong>. Esse token \u00e9 obtido ao fornecer as credenciais v\u00e1lidas do cliente, e ser\u00e1 utilizado nas chamadas subsequentes, permitindo a autentica\u00e7\u00e3o segura por um per\u00edodo determinado.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Principais Funcionalidades:<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Autentica\u00e7\u00e3o via <strong>oAuth<\/strong>;<\/li>\n\n\n\n<li>Emiss\u00e3o de <strong>Access Token<\/strong> para chamadas \u00e0s APIs;<\/li>\n\n\n\n<li>Garantia de seguran\u00e7a e controle de permiss\u00f5es;<\/li>\n\n\n\n<li>Suporte \u00e0 autentica\u00e7\u00e3o segura para m\u00faltiplos servi\u00e7os.<\/li>\n<\/ul>\n\n\n\n<p>Confira os detalhes abaixo sobre como realizar a integra\u00e7\u00e3o e iniciar o processo de autentica\u00e7\u00e3o para garantir acesso aos servi\u00e7os do Banco Semear.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Descri\u00e7\u00e3o<\/h3>\n\n\n\n<p>Para viabilizar as chamadas \u00e0 API, \u00e9 necess\u00e1rio chamar o m\u00e9todo de inicializa\u00e7\u00e3o que gera o token de acesso que ser\u00e1 usado nas pr\u00f3ximas chamadas. Dever\u00e1 ser feita uma requisi\u00e7\u00e3o HTTP do tipo POST \u00e0 URL do oAuth:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Endpoints<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Produ\u00e7\u00e3o:<\/strong> https:\/\/api2.bancosemear.com.br\/oauth\/access-token<\/li>\n\n\n\n<li><strong>Homologa\u00e7\u00e3o:<\/strong> https:\/\/hmlapi2.bancosemear.com.br\/oauth\/access-token<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Requisi\u00e7\u00e3o (POST)<\/h3>\n\n\n\n<p>Segue exemplo de requisi\u00e7\u00e3o:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl https:\/\/api2.bancosemear.com.br\/oauth\/access-token \\\n    --request POST \\\n    --header \"Content-Type: application\/json\" \\\n    --header \"Authorization: Basic MDAwMDAwMDAtMTExMS0yMjIyLTMzMzMtNDQ0NDQ0NDQ0NDQ6YWFhYWFhYWEtYmJiYi1jY2NjLWRkZGQtZWVlZWVlZWVlZWVlCg==\" \\\n    --data '{\"grant_type\":\"client_credentials\"}'<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Par\u00e2metros de Requisi\u00e7\u00e3o<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Cabe\u00e7alho<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Content-Type:<\/strong> Tipo do corpo da requisi\u00e7\u00e3o. Obrigat\u00f3rio ser <strong>application\/json<\/strong><\/li>\n\n\n\n<li><strong>Authorization:<\/strong> Autentica\u00e7\u00e3o b\u00e1sica composta do <strong>client_id + client_secret<\/strong> separados pelo caracter <strong>&#8220;:&#8221; (dois pontos)<\/strong> e codificados em base64. Passado no header Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX. <strong>Par\u00e2metro obrigat\u00f3rio<\/strong><\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Corpo (JSON)<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>grant_type:<\/strong> Tipo de solicita\u00e7\u00e3o oAuth. Obrigat\u00f3rio ser <strong>client_credentials<\/strong><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Resposta<\/h3>\n\n\n\n<p>Segue exemplo de resposta:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"access_token\":\"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\",\n    \"token_type\":\"access_token\",\n    \"expires_in\":86400\n}<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Par\u00e2metros de Resposta<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Corpo (JSON)<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>access_token:<\/strong> Token de acesso. <strong>Dever\u00e1 ser utilizado como par\u00e2metro do cabe\u00e7alho em todas as demais solicita\u00e7\u00f5es<\/strong><\/li>\n\n\n\n<li><strong>token_type:<\/strong> Tipo do token<\/li>\n\n\n\n<li><strong>expires_in:<\/strong> Tempo de expira\u00e7\u00e3o do token em segundos<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>A API de Autentica\u00e7\u00e3o do Banco Semear utiliza o protocolo oAuth, proporcionando um mecanismo seguro e eficiente para autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o de acesso \u00e0s APIs. Esse m\u00e9todo garante que apenas clientes e parceiros devidamente autenticados possam realizar opera\u00e7\u00f5es em nome dos usu\u00e1rios, oferecendo controle total sobre as permiss\u00f5es e a seguran\u00e7a dos dados. Antes de &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/www.bancosemear.com.br\/docs\/?docs=gerar-autenticacao-oauth-access-token-2\"> <span class=\"screen-reader-text\">Gerar Autentica\u00e7\u00e3o oAuth (Access Token)<\/span> Leia mais &raquo;<\/a><\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"doc_category":[27],"doc_tag":[],"class_list":["post-1297","docs","type-docs","status-publish","hentry","doc_category-credit-as-a-service-caas"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1297"}],"version-history":[{"count":3,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1297\/revisions"}],"predecessor-version":[{"id":1384,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1297\/revisions\/1384"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1297"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=1297"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}