> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beehivehub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Bibliotecas oficiais da BeehiveHub para integração com a API

Os SDKs oficiais da BeehiveHub são bibliotecas que facilitam a integração com a nossa API em aplicações backend.

Em vez de montar manualmente chamadas HTTP, headers de autenticação, tratamento de erros e estrutura de requisições, você utiliza métodos prontos para criar transações, consultar clientes, gerar links de pagamento, fazer transferências e acessar outros recursos da plataforma.

## Por que usar um SDK?

O SDK foi criado para tornar a integração mais rápida, organizada e segura.

Ao utilizar o SDK, você reduz a complexidade da implementação porque:

* não precisa montar requisições manualmente para cada endpoint;
* centraliza a autenticação com a sua `SECRET_KEY`;
* trabalha com métodos mais diretos e fáceis de manter;
* reduz a chance de erro na integração;
* acelera a implementação dos recursos mais comuns da API.

## Quando faz sentido usar?

O SDK é indicado quando você possui uma aplicação backend e quer integrar a BeehiveHub no seu servidor, API própria, painel administrativo, backoffice ou backend de e-commerce.

Exemplos de uso:

* criação de transações Pix, boleto e cartão;
* consulta de transações e clientes;
* criação de recebedores e transferências;
* geração de links de pagamento;
* automações internas do seu sistema financeiro.

> Recomendamos o uso dos SDKs para integrações **server-side**. Nunca utilize sua `SECRET_KEY` no front-end.

## Escolha sua linguagem

<CardGroup cols={2}>
  <Card color="#23ff00" icon="node-js" iconType="brands" href="/sdk-nodejs" title="Node.js">
    SDK oficial para aplicações Node.js e TypeScript.
  </Card>

  <Card color="#7a86b8" icon="php" iconType="brands" href="/sdk-php" title="PHP">
    SDK oficial para aplicações PHP.
  </Card>

  <Card color="#3572A5" icon="python" iconType="brands" href="/sdk-python" title="Python">
    SDK oficial para aplicações Python.
  </Card>

  <Card color="#f89820" icon="java" iconType="brands" href="/sdk-java" title="Java">
    SDK oficial para aplicações Java.
  </Card>
</CardGroup>

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Como instalo o SDK da minha linguagem?">
    Cada SDK possui uma página dedicada com as instruções de instalação. De forma geral, utilize o gerenciador de pacotes da sua linguagem:

    * **Node.js:** `npm install @paybeehive/beehivehub-nodejs-sdk`
    * **PHP:** `composer require paybeehive/beehivehub-php-sdk`
    * **Python:** `pip install beehivehub-python-sdk`
    * **Java:** via Maven ou Gradle — veja a [página do SDK Java](/sdk-java)
  </Accordion>

  <Accordion title="Os SDKs funcionam em sandbox e em produção?">
    Sim. Todos os SDKs suportam os dois ambientes. Para usar o ambiente de testes, passe `environment: "sandbox"` ao inicializar o cliente. Para produção, basta não informar o parâmetro ou usar a chave da conta de produção.
  </Accordion>

  <Accordion title="Preciso usar um SDK ou posso chamar a API diretamente?">
    O uso do SDK é recomendado, mas opcional. Você pode integrar diretamente pela API REST usando qualquer cliente HTTP. A vantagem do SDK é eliminar a configuração manual de autenticação, tratamento de erros e estrutura das requisições.
  </Accordion>

  <Accordion title="O que fazer se encontrar um bug em um SDK?">
    Abra uma issue no repositório GitHub do SDK correspondente. Nossa equipe acompanha os repositórios e trabalha para corrigir problemas e evoluir os SDKs continuamente.
  </Accordion>
</AccordionGroup>