# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devcenter.unico.io/unico-sign/primeiros-passos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.