> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/gateway-act/assinatura-+-carimbo.md).

# Assinatura + Carimbo

Essa API é responsável por realizar a assinatura de um hash utilizando o BirdID e atribuir um carimbo do tempo.

É necessário que o requerente possua um certificado BirdID, um **client id** e **client secret** previamente cadastrado e **permitido** no portal **Wings**.

A requisição deve ser realizada com o tipo de autenticação Basic, que envia no header o base64 do "clientid:clientsecret".

<mark style="color:green;">`POST`</mark> `https://gateway-act.hom.vaultid.com.br/api/sign`

#### Headers

| Name                                            | Type   | Description                           |
| ----------------------------------------------- | ------ | ------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Basic base64("clientid:clientsecret") |
| Content-Type<mark style="color:red;">\*</mark>  | String | application/json                      |

#### Request Body

| Name                                            | Type    | Description                                                                       |
| ----------------------------------------------- | ------- | --------------------------------------------------------------------------------- |
| hash<mark style="color:red;">\*</mark>          | String  | Conteúdo a ser assinado                                                           |
| access\_token<mark style="color:red;">\*</mark> | String  | Token adquirido com autenticação do usuário BirdID                                |
| skip\_timestamp                                 | Boolean | É possível obter o CMS sem o carimbo passando **true** nesse parâmetro            |
| id                                              | String  | Identificador do conteúdo a ser assinado                                          |
| alias                                           | String  | Identificador do conteúdo que será exibido no histórico de assinaturas do usuário |
| certificate\_alias                              | String  | Identificador do certificado correspondente à chave utilizada na assinatura       |

{% tabs %}
{% tab title="401: Unauthorized " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="200: OK CMS binário / DER" %}

{% endtab %}

{% tab title="400: Bad Request " %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

Exemplo:

```shell
curl --location --request POST 'https://gateway-act.hom.vaultid.com.br/api/sign' \
--header 'Authorization: Basic dGVzdGU6dGVzdGU=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "certificate_alias": "crt-test",
    "id": "1",
    "alias": "act-test",
    "hash": "196f2abba063cff054042ed77cda5a4e4cb35f0d5ecac23a08a3f7345a001423",
    "access_token": "538c1c9c3a0a345a617760a8607ebe7e2125ce44",
    "skip_timestamp": false
}'
```