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

# Public Endpoint - Custom Markers

Este endpoint é uma alternativa ao nosso endpoint da [API de markers](/api/markers#custom-marker),
e usa um método de autenticação diferente.

## Endpoint

Método da requisição: `POST`

| Endpoint                                                                         | Descrição                       |
| -------------------------------------------------------------------------------- | ------------------------------- |
| [https://appsignal-endpoint.net/markers](https://appsignal-endpoint.net/markers) | Aceita dados formatados em JSON |

## Parâmetros de URL

Dependendo da chave de API que você quer usar, você pode:

### Push API key

| Parâmetro   | Tipo   | Descrição                                                                                                             |
| ----------- | ------ | --------------------------------------------------------------------------------------------------------------------- |
| api\_key    | String | Chave de API **Push**, pode ser encontrada nas [configurações do App](https://appsignal.com/redirect-to/app?to=info). |
| name        | String | O nome da aplicação.                                                                                                  |
| environment | String | O ambiente em que a aplicação está rodando.                                                                           |

```shell Shell theme={null}
https://appsignal-endpoint.net/markers?api_key=<api_key>&name=<name>&environment=<environment>
```

### Front-end API key

| Parâmetro | Tipo   | Descrição                                                                                                                  |
| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| api\_key  | String | Chave de API **Front-end**, pode ser encontrada nas [configurações do App](https://appsignal.com/redirect-to/app?to=info). |

```shell Shell theme={null}
https://appsignal-endpoint.net/markers?api_key=<api_key>
```

## Parâmetros do corpo

O corpo do post deve conter um objeto JSON, formatado da seguinte forma:

| Parâmetro   | Tipo                                                      | Descrição                                                                               |
| ----------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| created\_at | Date - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) | Horário em que inserir o marcador. Deixe vazio para usar o horário atual.               |
| icon        | String - Opcional                                         | Emoji a ser usado para este Custom marker, padrão é 🚀.                                 |
| message     | String - Opcional                                         | Mensagem mostrada ao passar o mouse sobre o marcador na UI. Truncada em 200 caracteres. |

Por exemplo:

<CodeGroup>
  ```json JSON theme={null}
  {
    "created_at": "2015-07-21T15:06:31.737+02:00",
    "icon": "🚀",
    "message": "Upscaled the database for better performance"
  }
  ```
</CodeGroup>