# Chaves de envio

Crie chaves para scripts que enviam arquivos sozinhos para a CDN, como os prints do screenshot-basic, cada uma presa a uma pasta.

Source: https://fivedash.fivex.gg/docs/pt/cdn/upload-keys

Uma chave de envio é um crachá de entregador: ela deixa um script mandar arquivos para a CDN sem ninguém da equipe no painel, mas só para uma pasta. É o que os scripts de print (como o screenshot-basic), câmeras do jogo e anexos de denúncia usam. Esta página é para quem configura a CDN e os scripts que enviam arquivos.

[Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/cdn-upload-keys-pt.mp4)

## Antes de começar

* **CDN criada:** veja [CDN](https://fivedash.fivex.gg/docs/pt/cdn/overview).
* **Uma pasta para a chave:** crie antes a pasta onde os arquivos vão cair (por exemplo, `screenshots`).
* **Nível de acesso** em **Configurações** (CDN):

| O que fazer            | Nível necessário |
| ---------------------- | ---------------- |
| Ver a lista de chaves  | **Ver**          |
| Criar e revogar chaves | **Configurar**   |

## Criar uma chave

### Abra as chaves

Vá em **CDN → Configurações** e desça até **Chaves de envio** (ou clique em **Chaves de envio** em "Nesta página").

### Comece uma chave nova

Clique em **Nova chave**.

### Preencha

Em **Nome**, escreva para que é a chave (por exemplo, "Câmera do jogo"). Em **Envia para**, escolha a pasta. Marque **Também pode apagar** só se o script precisar limpar o que enviou.

### Crie

Clique em **Criar chave**.

### Copie a chave agora

Na janela **Chave criada**, clique em **Copiar chave**. Nas abas **screenshot-basic (Lua)** e **HTTP (cURL)**, o código já vem com a chave; use **Copiar código**. Clique em **Pronto**.

> A chave aparece inteira uma vez só. Depois, a lista mostra só o começo e o fim. Se perder a chave, crie outra e revogue a antiga.

### Campos da chave

| Campo                  | O que faz                                                                      | Padrão                                                      |
| ---------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------- |
| **Nome**               | Para você saber qual script usa a chave. Até 40 caracteres.                    | —                                                           |
| **Envia para**         | A pasta onde os arquivos da chave caem. **Todos os arquivos** é a raiz da CDN. | A pasta `screenshots`, se existir; se não, a primeira pasta |
| **Também pode apagar** | Deixa o script apagar os arquivos que **ele mesmo** enviou.                    | Desmarcado                                                  |

## O que uma chave pode fazer

| Pode                                                                    | Não pode                                                            |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Enviar um arquivo por vez, de até 20 MiB, para a pasta dela             | Escolher outra pasta ou outro servidor                              |
| Apagar um arquivo que ela mesma enviou, se tiver **Também pode apagar** | Apagar arquivos de outras pessoas ou de outras chaves               |
| Enviar os formatos aceitos pela CDN                                     | Ver a lista de arquivos, mudar configurações ou criar outras chaves |

Cada chave só envia para a pasta dela: se vazar, o estrago fica ali.

> No screenshot-basic, a chave vai junto do script no cliente (o jogador consegue ver). Por isso ela só envia para a pasta dela. Use uma pasta só para os prints.

## Formato da chave

A chave começa com `fdm_` seguida de 64 letras e números, como `fdm_xxxxxxxx…`. Ela vai no cabeçalho `Authorization` de cada envio:

```http
Authorization: Bearer fdm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

Veja os exemplos completos em [Integrações](https://fivedash.fivex.gg/docs/pt/cdn/integrations).

## A lista de chaves

| O que aparece                 | O que significa                                                                                    |
| ----------------------------- | -------------------------------------------------------------------------------------------------- |
| Nome                          | O **Nome** da chave.                                                                               |
| **Também apaga**              | A chave tem **Também pode apagar**.                                                                |
| `fdm_xxxxxx…xxxxxx` · em …    | O começo e o fim da chave e a pasta para onde ela envia ("pasta removida" se a pasta foi apagada). |
| **… envios**                  | Quantos arquivos a chave já enviou.                                                                |
| **usada …** / **nunca usada** | Quando a chave foi usada pela última vez.                                                          |

## Revogar uma chave

### Encontre a chave

Em **CDN → Configurações → Chaves de envio**, ache a chave na lista.

### Revogue

Clique na lixeira ao lado dela (**Revogar …**) e confirme em **Revogar**.

Os scripts que usam essa chave param de enviar na hora. Os arquivos já enviados continuam na CDN.

## Trocar uma chave (rotação)

Não existe um botão de girar a chave. Para trocar sem parar o script:

### Crie a chave nova

Clique em **Nova chave**, com a mesma pasta em **Envia para**, e copie a chave.

### Troque no script

Cole a chave nova no script e reinicie ele no console do servidor.

### Revogue a antiga

Confira que os envios chegam com a chave nova (o contador **… envios** sobe) e revogue a antiga.

## Limites

| Item                                   | Limite                                  |
| -------------------------------------- | --------------------------------------- |
| Chaves por servidor                    | 50 ("O limite de chaves foi atingido.") |
| Tamanho por arquivo enviado pela chave | 20 MiB                                  |
| Arquivos por envio                     | 1                                       |

Os envios pelas chaves contam nas mesmas franquias do plano que os envios pelo painel. Veja [Uso e limites](https://fivedash.fivex.gg/docs/pt/cdn/usage-and-limits).

## Perguntas frequentes

**Apaguei a pasta da chave. O que acontece?**
A chave para de enviar ("A pasta da chave não está disponível."). Se a pasta só foi para a lixeira, restaure a pasta. Se ela foi apagada para sempre, criar uma pasta com o mesmo nome não traz a chave de volta: crie uma chave nova para a pasta nova.

**Posso usar a mesma chave em vários scripts?**
Pode, mas é melhor uma chave por script: assim você revoga uma sem parar as outras e vê os envios de cada uma.

**O arquivo enviado pela chave tem o link de sempre?**
Sim. Ele cai na pasta da chave e ganha o link público normal, `https://cdn.fivex.sh/<endereco>/<pasta>/<arquivo>`. Na lista de arquivos, **Enviado por** mostra "Chave: …".

## Próximos passos

[Integrações](https://fivedash.fivex.gg/docs/pt/cdn/integrations)screenshot-basic e envio por HTTP.
[Enviar arquivos](https://fivedash.fivex.gg/docs/pt/cdn/upload-files)Crie a pasta da chave.
[API da CDN](https://fivedash.fivex.gg/docs/pt/developers/cdn-api)Detalhes técnicos para desenvolvedores.
[Uso e limites](https://fivedash.fivex.gg/docs/pt/cdn/usage-and-limits)Franquias de envio do plano.