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

# Início Rápido

> Aprenda como integrar a API do curto.io no seu projeto, sem perder sua marca!

## Pré-requisitos

* [Crie uma API Key](https://curto.io/profile/developer)

## Autenticação

Para autenticar suas requisições, você precisa agregar o seguinte cabeçalho:

```bash theme={null}
'X-Curto-Api-Key': '<your_key>'
```

## Encurte seu primeiro link!

Você pode fazer isso através de uma requisição `POST` para o endpoint `/v1/links`, igual o exemplo abaixo:

```bash theme={null}
curl -X POST -H 'Content-Type: application/json' \
-H 'X-Curto-Api-Key: <your_key>' \
-d '{ "link": "<your_destination>" }' \
https://api.curto.io/v1/links
```

Você então terá um `JSON` como esse na resposta:

```json theme={null}
200 OK

{
  "data": {
    "id": "<link_id>",
    "destination": "<your_destination>",
    "token": "D7tX8",
    "short_link": "https://curr.to/D7tX8",
    "domain_id": "<domain_id>",
    "domain": "curr.to",
    "password": false,
    "created_at": "2023-06-21T20:26:04.865908",
    "updated_at": "2023-06-21T20:26:04.865922",
    "clicks": 0
  },
  "status": "OK"
}
```

## Explore

<CardGroup cols={2}>
  <Card title="Referência da API" icon="file" href="/api-reference">
    Integre nossa API REST.
  </Card>

  <Card title="Integrações" icon="flask" href="/integrations">
    Dê superpoderes ao seu fluxo de trabalho com integrações incríveis.
  </Card>
</CardGroup>