> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-sign/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-sign/primeiros-passos.md).

# Primeiros passos

Entenda como configurar sua conta na Unico e deixar tudo pronto para efetuar suas primeiras requisições com a API REST do Unico Sign. Após estes passos, você estará pronto para iniciar sua integração com nossa API.

## Crie sua conta com a Unico[​](https://developers.unico.io/docs/sign/getting-started#crie-sua-conta-com-a-unico) <a href="#crie-sua-conta-com-a-unico" id="crie-sua-conta-com-a-unico"></a>

O **Unico Sign** ainda não está disponível para todos nossos clientes. Caso tenha interesse, entre em contato conosco através de nossos [<mark style="color:blue;">canais de atendimento</mark>](https://empresas.unico.io/hc/pt-br/p/atendimentoparaempresas) e solicite um convite.

## Obtenha suas credenciais[​](https://developers.unico.io/docs/sign/getting-started#obtenha-suas-credenciais) <a href="#obtenha-suas-credenciais" id="obtenha-suas-credenciais"></a>

Após a criação de sua conta na Unico, você deverá solicitar uma conta de serviço para sua aplicação. A conta de serviço deve ser solicitada diretamente ao GP ou CS responsável por sua integração.

Ao receber sua conta de serviço, você também receberá um arquivo (no formato `.pem`) contendo suas credenciais. O arquivo `.pem` será utilizado posteriormente no processo de autenticação das APIs.

{% hint style="warning" %}
É importante solicitar que o perfil `Integradores` seja adicionado a sua conta de serviço.
{% endhint %}

## Teste sua integração[​](https://developers.unico.io/docs/sign/getting-started#teste-sua-integra%C3%A7%C3%A3o) <a href="#teste-sua-integracao" id="teste-sua-integracao"></a>

Sugerimos que você efetue um teste rápido com suas credenciais, para isto:

{% stepper %}
{% step %}

### Obtenha um token OAuth válido <a href="#obtenha-um-token-oauth-valido" id="obtenha-um-token-oauth-valido"></a>

Para efetuar requisições a nossas APIs você necessitará de um token de acesso OAuth válido. Caso não esteja familizarizado com o modelo de autenticação OAuth, entenda como gerar um token válido [<mark style="color:blue;">neste artigo</mark>](https://devcenter.unico.io/unico-sign/guia-das-apis/autenticacao).  Após sua geração, o token de acesso deverá ser enviado no `header` de sua requisição.

{% hint style="info" %}
**Ambientes**

Ao iniciar sua integração você receberá credenciais a nosso ambiente de homologação. Sómente após o processo de testes e certificação você receberá credenciais de produção.

Você deverá apontar suas requisições às URLs corretas em cada estágio de sua integração. Abaixo listamos as URLs de homologação e produção:

* Ambiente de homologação: `https://signhom.acesso.io`;
* Ambiente de produção: `https://sign.acesso.io`.
  {% endhint %}

{% endstep %}

{% step %}

### Faça uma requisição básica a nossa API <a href="#faca-uma-requisicao-basica-a-nossa-api" id="faca-uma-requisicao-basica-a-nossa-api"></a>

Após obter um token de acesso válido, efetue uma requisição a um de nossos end-points e certifique-se que tudo está funcionando. Recomendamos um teste com o end-point que retorna os envelopes criados em sua conta. Abaixo um exemplo de como chamar este end-point:

```json
curl --location --request POST '${URI}/api/v1/service/envelopes' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${access_token}' \
--data-raw '{}'
```

Se tudo der certo, você deverá receber um código HTTP 200 e caso possua algum envelope criado em sua conta uma resposta semelhante a esta:

{% code overflow="wrap" %}

```json
{
    "Success": true,
    "Message": "",
    "Data": {
        "Page": 1,
        "MaxPage": 363,
        "Count": 10886,
        "Envelopes": [
            {
                "CreatedDate": "21/05/2018 17:24",
                "ID_EnvelopeStatus": 1,
                "EnvelopeStatus": "Pendente",
                "UUID": "x11x111x-x11x-1111-11x1-11x111x1xx1x",
                "Documents": [
                    {
                        "Url": "https://signhom.acesso.io/api/v1/service/file/y00y000y-y00y-0000-00y0-00y000y0yy00",
                        "UrlVoucher": "https://sign.acesso.io/api/v1/service/evidence/y00y000y-y00y-0000-00y0-00y000y0yy00",
                        "DocumentType": "Teste Core",
                        "CreatedDate": "21/05/2018 17:24",
                        "CompanySocialName": "ACESSO DIGITAL",
                        "UUID": "y00y000y-y00y-0000-00y0-00y000y0yy00",
                        "Subscribers": [
                            {
                                "SubscriberName": "Nome do Assinante Primeiro",
                                "SubscriberCPF": "11122233344",
                                "SubscriberEmail": "nome@email.com",
                                "SubscriberPhone": "5511999988888",
                                "SubscriberRole": 1,
                                "URLFrameFull": "https://url/client/?token=JymY0s0s0s0d0sa0d0sd0sa0dsa0d"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
```

{% endcode %}
{% endstep %}
{% endstepper %}

## Próximos passos[​](https://developers.unico.io/docs/sign/getting-started#pr%C3%B3ximos-passos) <a href="#proximos-passos" id="proximos-passos"></a>

A seguir recomendamos que você entenda um pouco mais sobre nossos [<mark style="color:blue;">conceitos básicos</mark>](https://devcenter.unico.io/unico-sign/conceitos-basicos) e logo em seguida navegue por nossos [<mark style="color:blue;">guias de integração</mark>](https://devcenter.unico.io/unico-sign/guia-das-apis/visao-geral).

***

**Dúvidas?**[**​**](https://developers.unico.io/docs/IDunico/Integracao/primeirosPassos#d%C3%BAvidas)

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da [<mark style="color:blue;">Central de Ajuda</mark>](https://empresas.unico.io/hc/pt-br/p/atendimentoparaempresas).