> For the complete documentation index, see [llms.txt](https://agilspot-pay.gitbook.io/api-finance-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agilspot-pay.gitbook.io/api-finance-hub/overview/primeiros-passos.md).

# Primeiros Passos

Comece por aqui

{% hint style="info" %}
**AgilSpot Pay dev by dev:** Se você é um desenvolvedor e pretende integrar seu site à sua conta digital AgilSpotPay para **emitir suas cobranças de forma automatizada**, você está no lugar certo!
{% endhint %}

Esta documentação é destinada a desenvolvedores que desejam **integrar seu site ou aplicação com a API da AgilSpotPay**. São descritas as funcionalidades da API, módulos, parâmetros técnicos, vídeos em formato de aulas sobre integrações com nossa API e disponibilização de códigos prontos de exemplos para facilitar suas atividades de desenvolvimento.

## **Aspectos técnicos**

A AgilSpotPay está implementada em conformidade com o princípio de design [REST](https://en.wikipedia.org/wiki/Representational_state_transfer). Nossa API possui recursos orientados a URLs, com códigos HTTP para indicar erros. Nós utilizamos funcionalidades HTTP nativas, como verbos de ação POST, PUT, GET, DELETE, para operações de leitura e escrita, bem como o modelo [básico de autenticação](https://en.wikipedia.org/wiki/Basic_access_authentication) HTTP.

Nós suportamos chamadas diretas aos recursos da API a partir de outras origens, [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) (cross-origin resource sharing), permitindo você interagir de maneira segura com nossas APIs a partir de aplicações web. Todas as respostas da API estão no formato de dados JSON, incluindo errors. 

Para permitir que você possa explorar todos os serviços sem preocupação, utilize suas credenciais de **SANDBOX** que são compostas de **client\_id**, **client\_secret** e **Token** gerado a partir da **autenticação**, nos modos de produção (**API**) e teste (**SANDBOX**). Não é possível alternar entre modos, basta usar a credencial apropriada para realizar operações em produção ou ambiente de teste. Lembrando que, chamadas realizadas com credenciais de ***sandbox***, não são processadas junto a instituições bancárias.