> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/ambientes-e-autenticacao.md).

# Ambientes e Autenticação

URLs de cada ambiente e como autenticar as chamadas.

## Ambientes

| Ambiente        | URL Base                                      | Finalidade                                                                                                                   |
| --------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Homologação** | `https://ingress.gtpayroll.staging.giro.tech` | Desenvolvimento e testes                                                                                                     |
| **Produção**    | `https://ingress.gtpayroll.giro.tech`         | Operações reais, após a [homologação](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/processo-de-homologacao.md) |

***

## Autenticação

A API usa **JWT**. O token é emitido pela equipe de integração da Giro.Tech no onboarding: informe CNPJ, razão social e contato técnico do originador, e o token é entregue por canal seguro.

Envie o token no header `Authorization` de **todas** as requisições:

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X GET 'https://ingress.gtpayroll.staging.giro.tech/api/v1/originator/employees/{{employeePublicId}}' \
  -H 'Authorization: Bearer {{seu_token_jwt}}' \
  -H 'Content-Type: application/json'
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const response = await fetch('https://ingress.gtpayroll.staging.giro.tech/api/v1/originator/employees/{{employeePublicId}}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{seu_token_jwt}}',
    'Content-Type': 'application/json'
  }
});
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

headers = {
    'Authorization': 'Bearer {{seu_token_jwt}}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://ingress.gtpayroll.staging.giro.tech/api/v1/originator/employees/{{employeePublicId}}',
    headers=headers
)
```

{% endtab %}
{% endtabs %}

Token expirado retorna `401`; peça um novo à equipe de integração.

## Headers obrigatórios

| Header          | Valor              | Descrição                           |
| --------------- | ------------------ | ----------------------------------- |
| `Authorization` | `Bearer {token}`   | Token JWT                           |
| `Content-Type`  | `application/json` | Em requisições com corpo (POST/PUT) |

***

## Códigos de resposta

| Código | Quando ocorre                                     |
| ------ | ------------------------------------------------- |
| `200`  | Sucesso                                           |
| `201`  | Recurso criado                                    |
| `202`  | Processamento assíncrono iniciado                 |
| `204`  | Sucesso sem corpo de resposta                     |
| `400`  | Dados de entrada inválidos ou incompletos         |
| `401`  | Token ausente, inválido ou expirado               |
| `403`  | Token válido sem permissão para o recurso         |
| `404`  | Recurso inexistente                               |
| `409`  | Operação não permitida no estado atual do recurso |

Detalhes e formato do corpo de erro em [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.md).

***

## Restrição de IPs

Se a sua política de segurança exigir, a equipe de integração configura allowlist de IP para produção.

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
