Esta seção é um repositório selecionado de informações, oferecendo soluções rápidas e esclarecimentos para otimizar o processo de integração da API Monotype. Com clareza e concisão, serve como um ponto de referência essencial para navegar nas complexidades do cenário de integração, garantindo uma jornada mais tranquila para os desenvolvedores.

Visão geral

Os clientes empresariais pagos podem acessar o inventário de fontes premium. Portanto, os clientes empresariais são integrados com o fluxo de código de autorização. Isso significa que os usuários também são autenticados juntamente com a validação da aplicação.

Pré-requisitos

Ser um cliente empresarial.
Compartilhar um URL de redirecionamento para o processo de integração da API. A Monotype usará esse URL para registrar o URI na configuração do aplicativo Monotype para desktop.
Aceitar o convite para integrar seu usuário à organização.

Tokens

Token de acesso: Um token de acesso é um token temporário de curta duração que é emitido a um cliente. Esse token é usado para acessar recursos protegidos, como dados ou serviços. Os tokens de acesso são tipicamente limitados no tempo e oferecem um nível adicional de segurança. A expiração do token de acesso é definida para um dia, ou seja, 24 horas.
Token de atualização: Diferente dos tokens de acesso, os tokens de atualização não são destinados a acessar recursos diretamente. Em vez disso, seu propósito principal é obter novos tokens de acesso quando os existentes expirarem ou se tornarem inválidos. Quando um token de acesso expira ou não é mais válido por algum motivo, você pode usar o token de atualização para solicitar um novo token de acesso sem precisar reintroduzir suas credenciais.

Autorização

Login de usuário

Obtenha um Client ID e um Client Secret de sua representante de vendas ou do contato parceiro na Monotype.
Use o Client ID e o URL de redirecionamento para direcionar o usuário à tela de login. Execute o seguinte URL:
```
https://api.monotype.com/v2/oauth/authorize?client_id=<clientid>&redirect_uri=<redirecturi>&response_type=code
```

<clientid>	clientId é o Client ID obtido da Monotype
<redirecturi>	O URL compartilhado pelo cliente, no qual o código será enviado após o login bem-sucedido,

redirecionará o usuário para a página de login da Monotype. O usuário então deverá inserir suas credenciais. Essas credenciais foram definidas inicialmente no momento em que o usuário aceitou o convite da Monotype.
Insira os detalhes de login.

Após o login bem-sucedido, o código de autorização será enviado ao URL de redirecionamento.

Geração de token

Extraia o código de autorização do URL de redirecionamento. O código de autorização é anexado como um parâmetro de consulta.

Execute o seguinte comando curl para gerar o token de acesso e o token de atualização.

curl --location 'https://api.monotype.com/v2/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic <authcode>' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'code=<code>' \
--data-urlencode 'redirect_uri=<redirecturi>'

<authcode>	Base64 encoded string Clientid:Clientsecret.
<code>	Extraído do URL de redirecionamento após o login do usuário. Observação: O código pode ser usado apenas uma vez para gerar o token ou executar o comando curl mencionado acima.
<redirecturi>	Compartilhado por um cliente registrado da Monotype

Após a execução bem-sucedida, registre o token de acesso e o token de atualização gerados.
Você pode usar o token de acesso para invocar as APIs. Após a expiração do token de acesso, você pode atualizar o token de acesso utilizando o fluxo de tokens de atualização.

Tokens de atualização

Execute o curl abaixo para atualizar os tokens. Os tokens de atualização podem ser usados apenas uma vez para gerar um novo token de acesso. O curl abaixo retornará o novo token de acesso e um novo token de atualização que devem ser utilizados para gerar os novos tokens.
```
curl --location 'https://api.monotype.com/v2/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic <authcode>' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'refresh_token=<refreshtoken>'
```

<authcode>	Base64 encoded string Clientid:Clientsecret
<refreshtoken>	Gere e registre o token de atualização

Após a execução bem-sucedida, o novo token de acesso e o novo token de atualização serão gerados. Registre o novo token de acesso e o token de atualização.
Revogue o token de atualização existente utilizando o fluxo de revogação de token. Use o novo token de atualização para gerar os tokens novamente.

Ao usar o mesmo token de atualização novamente, uma reutilização do token de atualização é detectada, e todos os tokens de atualização gerados ficam invalidados, exigindo um novo login para gerar os tokens.

Revogação de token

Execute o seguinte comando curl para revogar o token.

curl --location 'https://api.monotype.com/v2/oauth/token/revoke' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic <authcode>' \
--data-urlencode 'token=<token>'

<authcode>	Base64 encoded string Clientid:Clientsecret.
<token>	Token de atualização que precisa ser revogado.

O token será revogado com o status code 200.

Invocação de API

Use o token de acesso para invocar as APIs Monotype. Exemplo:

curl --location --request POST 'https://api.monotype.com/v1/fonts/search'\
--header 'Authorization: Bearer <accesstoken>'

O token de acesso gerado pela API de autorização.