{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Delphi","type":"basic","slug":"instalacao-sdk-delphi","excerpt":"Saiba como instalar e configurar nossa SDK em Delphi para API Pix e API Boletos (Bolix)","body":"[block:html]\n{\n  \"html\": \"<p>Nossa API é <a href=\\\"https://en.wikipedia.org/wiki/Representational_state_transfer\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">RESTful</a> e responde em <a href=\\\"http://www.json.org/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">JSON</a>. A Gerencianet utiliza <a href=\\\"http://oauth.net/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">OAuth</a> para fornecer acesso autorizado à <abbr title=\\\"Application Programming Interface\\\">API</abbr>. Nossa SDK de Delphi já está preparada para realizar essa autenticação automaticamente.</p>\"\n}\n[/block]\nA seguir, confira os procedimentos para instalação da SDK da Gerencianet em Delphi:\n\n# Pré Requisitos\n\n- Aplicações que usarão a SDK devem ser compiladas na plataforma Windows 32-bit;\n- Apenas aplicações Desktop.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Observações\",\n  \"body\": \"Originalmente, as SDK´s de Delphi foram executados e desenvolvidas no Delphi Rio Community Edition 10.3.\\n\\nLembrando que esta SDK, foi desenvolvida para ser retrocompatível, ou seja, compatível tanto com as versões mais recentes do Delphi quanto as versões mais antigas, no entanto, a Gerencianet somente irá dar suporte à aplicações desktop win-32 desenvolvidas no Delphi Rio Community Edition 10.3.\"\n}\n[/block]\n# Download da SDK Delphi - API Boletos (Bolix)\n\nTodo o código de demonstração está disponível em nosso repositório do GitHub <a href=\"https://github.com/gerencianet/gn-api-sdk-delphi\" target=\"_blank\">(Clique neste link)</a>. Após concluir o download descompacte o arquivo em alguma pasta de sua preferência e a SDK estará pronta para uso.\n\n# Download da SDK Delphi - Pix\n\nTodo o código de demonstração está disponível em nosso repositório do GitHub <a href=\"https://github.com/gerencianet/gn-api-sdk-delphi-pix\" target=\"_blank\">(Clique neste link)</a>. Após concluir o download descompacte o arquivo em alguma pasta de sua preferência e a SDK estará pronta para uso.</p>\n\n# Execução Demo\n\nApós realizar o download e extrair os arquivos, abra a pasta Api Compilada e lá terá o arquivo a ser executado <code>ApisGN.exe</code>.\n\n# Usando a SDK da Gerencianet\n\nPara utilização da SDK, basta adicionar as classes ao seu projeto e chama-las conforme suas necessidades.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Dependendo do Endpoint a ser utilizado, será necessário adicionar as DLL´s (Disponíveis em: \\\\Api Compilada) e classes externas (Disponíveis em: \\\\Code\\\\External) ao seu projeto também.\"\n}\n[/block]\nA API sempre irá retornar uma string JSON, portanto, qualquer tipo de argumento passado para as funções da SDK devem ser do tipo *String*. \n\nAntes de consumir qualquer endpoint da API, é necessário autenticar na API usando a SDK. Para isso, você irá fornecer os seus dados:\n- <code>Client_Id</code>;\n- <code>Client_Secret</code>;\n- Ambiente (sandbox ou produção);\n- Certificado em modo .p12 (Apenas a API Pix).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Observação\",\n  \"body\": \"O ambiente \\\"sandbox\\\" (ou \\\"homologação\\\") é o local que a Gerencianet disponibiliza ao integrador para testar sua integração.\\n\\nJá o ambiente de \\\"produção\\\" é o ambiente \\\"real\\\" que sua aplicação deverá estar para gerar cobranças (ou \\\"transações\\\") \\\"reais\\\".\\n\\n**LEMBRE-SE:** caso você ativar o \\\"sandbox\\\", utilize *Client_Id* e *Client_Secret* de \\\"homologação\\\" (<a href=\\\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\\\" target=\\\"_blank\\\">veja onde localizar</a>), assim como, se estiver usando ambiente de \\\"produção\\\", use *Client_Id* e *Client_Secret* do referido ambiente (<a href=\\\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\\\" target=\\\"_blank\\\">veja onde localizar</a>).\\n\\nCaso utilize nossa API Pix, carregue o seu certificado (arquivo .p12). Se você ainda não possui um certificado, veja [como gerar](https://gerencianet.com.br/artigo/como-gerar-o-certificado-para-usar-a-api-pix/).\"\n}\n[/block]\n# Dependências externas do Projeto\n\nPara desenvolvimento da SDK, foi utilizada algumas classes externas disponíveis em:\n- Classe Super Object: https://github.com/onryldz/x-superobject\n- Classe ZXingQRCode: https://github.com/foxitsoftware/DelphiZXingQRCode/tree/master/Source\n- Classe Chilkat: https://www.chilkatsoft.com/delphiDll.asp\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Observação\",\n  \"body\": \"Essas classes externas já se encontram dentro de nosso projeto na pasta \\\"Utils/External\\\".\"\n}\n[/block]","updates":[],"order":9,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6149f9c54fd2ec004ea87406","createdAt":"2021-09-21T15:27:01.126Z","user":"6149f8769bc8dd01aa9337c4","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Instalação da API (SDK's)","slug":"instalação-da-api-sdks","order":7,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878343d","createdAt":"2017-03-10T12:37:05.075Z","project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6","__v":0},"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e","61473375119247002a9c14d7"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":3,"forked_from":"575aeffae12cf20e002f306f"},"project":"575aeffae12cf20e002f306c","__v":0,"parentDoc":null}

Delphi

Saiba como instalar e configurar nossa SDK em Delphi para API Pix e API Boletos (Bolix)

[block:html] { "html": "<p>Nossa API é <a href=\"https://en.wikipedia.org/wiki/Representational_state_transfer\" target=\"_blank\" title=\"Link Externo\">RESTful</a> e responde em <a href=\"http://www.json.org/\" target=\"_blank\" title=\"Link Externo\">JSON</a>. A Gerencianet utiliza <a href=\"http://oauth.net/\" target=\"_blank\" title=\"Link Externo\">OAuth</a> para fornecer acesso autorizado à <abbr title=\"Application Programming Interface\">API</abbr>. Nossa SDK de Delphi já está preparada para realizar essa autenticação automaticamente.</p>" } [/block] A seguir, confira os procedimentos para instalação da SDK da Gerencianet em Delphi: # Pré Requisitos - Aplicações que usarão a SDK devem ser compiladas na plataforma Windows 32-bit; - Apenas aplicações Desktop. [block:callout] { "type": "info", "title": "Observações", "body": "Originalmente, as SDK´s de Delphi foram executados e desenvolvidas no Delphi Rio Community Edition 10.3.\n\nLembrando que esta SDK, foi desenvolvida para ser retrocompatível, ou seja, compatível tanto com as versões mais recentes do Delphi quanto as versões mais antigas, no entanto, a Gerencianet somente irá dar suporte à aplicações desktop win-32 desenvolvidas no Delphi Rio Community Edition 10.3." } [/block] # Download da SDK Delphi - API Boletos (Bolix) Todo o código de demonstração está disponível em nosso repositório do GitHub <a href="https://github.com/gerencianet/gn-api-sdk-delphi" target="_blank">(Clique neste link)</a>. Após concluir o download descompacte o arquivo em alguma pasta de sua preferência e a SDK estará pronta para uso. # Download da SDK Delphi - Pix Todo o código de demonstração está disponível em nosso repositório do GitHub <a href="https://github.com/gerencianet/gn-api-sdk-delphi-pix" target="_blank">(Clique neste link)</a>. Após concluir o download descompacte o arquivo em alguma pasta de sua preferência e a SDK estará pronta para uso.</p> # Execução Demo Após realizar o download e extrair os arquivos, abra a pasta Api Compilada e lá terá o arquivo a ser executado <code>ApisGN.exe</code>. # Usando a SDK da Gerencianet Para utilização da SDK, basta adicionar as classes ao seu projeto e chama-las conforme suas necessidades. [block:callout] { "type": "warning", "body": "Dependendo do Endpoint a ser utilizado, será necessário adicionar as DLL´s (Disponíveis em: \\Api Compilada) e classes externas (Disponíveis em: \\Code\\External) ao seu projeto também." } [/block] A API sempre irá retornar uma string JSON, portanto, qualquer tipo de argumento passado para as funções da SDK devem ser do tipo *String*. Antes de consumir qualquer endpoint da API, é necessário autenticar na API usando a SDK. Para isso, você irá fornecer os seus dados: - <code>Client_Id</code>; - <code>Client_Secret</code>; - Ambiente (sandbox ou produção); - Certificado em modo .p12 (Apenas a API Pix). [block:callout] { "type": "info", "title": "Observação", "body": "O ambiente \"sandbox\" (ou \"homologação\") é o local que a Gerencianet disponibiliza ao integrador para testar sua integração.\n\nJá o ambiente de \"produção\" é o ambiente \"real\" que sua aplicação deverá estar para gerar cobranças (ou \"transações\") \"reais\".\n\n**LEMBRE-SE:** caso você ativar o \"sandbox\", utilize *Client_Id* e *Client_Secret* de \"homologação\" (<a href=\"http://image.prntscr.com/image/447be4bc64644a35bcf5eaecd1125f5d.png\" target=\"_blank\">veja onde localizar</a>), assim como, se estiver usando ambiente de \"produção\", use *Client_Id* e *Client_Secret* do referido ambiente (<a href=\"http://image.prntscr.com/image/7dc272063bb74dccba91739701a0478b.png\" target=\"_blank\">veja onde localizar</a>).\n\nCaso utilize nossa API Pix, carregue o seu certificado (arquivo .p12). Se você ainda não possui um certificado, veja [como gerar](https://gerencianet.com.br/artigo/como-gerar-o-certificado-para-usar-a-api-pix/)." } [/block] # Dependências externas do Projeto Para desenvolvimento da SDK, foi utilizada algumas classes externas disponíveis em: - Classe Super Object: https://github.com/onryldz/x-superobject - Classe ZXingQRCode: https://github.com/foxitsoftware/DelphiZXingQRCode/tree/master/Source - Classe Chilkat: https://www.chilkatsoft.com/delphiDll.asp [block:callout] { "type": "success", "title": "Observação", "body": "Essas classes externas já se encontram dentro de nosso projeto na pasta \"Utils/External\"." } [/block]