> For the complete documentation index, see [llms.txt](https://docs.scorepositivo.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scorepositivo.com.br/introducao.md).

# Introdução

## HTTP 

Nossa API utiliza códigos de resposta convencionais de HTTP para indicar o sucesso ou a falha de uma requisição. Sendo assim, códigos 2xx indicam sucesso, 4xx indicam erros por algum dado informado incorretamente (por exemplo, algum campo obrigatório não enviado) e códigos 5xx indicando erros em nossos servidores.

Caso o retorno de erro 500 persista por um período considerável, entre em contato com nosso suporte.

## URL de integração

<table><thead><tr><th width="323">Ambiente</th><th>Endpoint</th></tr></thead><tbody><tr><td>Relatórios Individuais</td><td>https://core.scorepositivo.com.br</td></tr></tbody></table>

## Requisição base

Todas as requisições de **autenticação** e **solicitação de relatórios**, devem ser requisitados através do método <mark style="color:orange;">**POST**</mark>, conforme detalhamentos seguintes.

Os resultados de relatórios que são do tipo de processamento assíncrono, deverão ser requisitados no endpoint de resultados através do método <mark style="color:green;">**GET**</mark>, conforme detalhamentos seguintes.

## Headers

Todas as requisições são transacionadas em **JSON**, por isso devem <mark style="color:red;">**obrigatoriamente**</mark> possuir os headers a seguir para uma conexão bem sucedida:

<table><thead><tr><th width="284">Header</th><th>Valor</th></tr></thead><tbody><tr><td><strong>Accept</strong></td><td>application/json</td></tr><tr><td><strong>Content-Type</strong></td><td>application/json</td></tr><tr><td><strong>Authorization</strong></td><td>Bearer ACCESS_TOKEN</td></tr></tbody></table>