Histórico da Página

...

No assistente de configuração do TotvsApps,, ao buscar os aplicativos disponíveis para o cliente, poderá ocorrer o seguinte erro:

Image Modified

Nesse momento, três api's do TotvsApp's são consultadas para fornecer essa informação, entre elas:

...

a) - Apis's que retornam todos os endereços disponíveis da plataforma TotvsApps.

Ambiente	Endereço
Desenvolvimento	https://endpoint-registry.dev.totvs.app
Staging	https://endpoint-registry.staging.totvs.app
Produção	https://endpoint-registry.totvs.app

Informações
O retorno dessa api, oferecerá todos os outros endereços de conexão na plataforma Totvsapps.

...

Algum problema de conectividade poderá ocorrer nessa chamada. Portanto, é importante utilizar o aplicativo "curl" para verificar se a chamada está sendo realizada com sucesso. Nesse caso, basta rodar o comando abaixo em todas as máquinas de servidor de aplicação (máquinas que respondem a solicitações de tela) do ambiente de produção do cliente conforme exemplo

curl --location --request GET "https://endpoint-registry.totvs.app/api/v1/services" --header "User-Agent: RM" --header "Accept: */"

Deve ser retornado um json no seguinte formato, conforme exemplo:

[
    {
        "service": "carol-staging-tables-sync",
        "endpoints": [
            {
                "version": "2",
                "address": "https://app.carol.ai/api/v2/staging/tables/{table}/sync"
            },
            {
                "version": "3",
                "address": "https://app.carol.ai/api/v3/staging/tables/{table}/sync"
            }
        ]
    },

.

b) - Api's de recuperação do accesstoken de acesso no Rac

Ambiente	Endereço
Desenvolvimento	https://admin.rac.dev.totvs.app/totvs.rac/connect/token
Staging	https://admin.rac.staging.totvs.app/totvs.rac/connect/token
Produção	https://admin.rac.totvs.app/totvs.rac/connect/token

Informações
O retorno dessa api, fornecerá o accessToken de acesso para todas as outras api's da plataforma TotvsApps.

Algum problema de conectividade poderá ocorrer nessa chamada. Portanto, é importante utilizar o aplicativo "curl" para verificar se a chamada está sendo realizada com sucesso. Nesse caso, basta rodar o comando abaixo em todas as máquinas de servidor de aplicação (máquinas que respondem a solicitações de tela) do ambiente de produção do cliente conforme exemplo

curl --location --request

GET "https://endpoint-registry.totvs.app/api/v1/services" --header "User-Agent: RM" --header "Accept: */"

c) - Api's que retornam os aplicativos que o cliente tem acesso

...

title	Utilize esse comando para recuperar o accessToken

...

POST "https://admin.rac.totvs.app/totvs.rac/connect/token" --header "Content-Type: application/x-www-form-urlencoded" --data-urlencode "grant_type=client_credentials" --data-urlencode "client_id=

...

1111111111111111111" --data-urlencode "client_secret=

...

222222222222222222222" --data-urlencode "scope=authorization_api"

Deve ser retornado um json no seguinte formato, conforme exemplo:

{
    "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjJiYjZmYzUyM2ZjNzQwZjI4NmMxOTZmY2ExMzUyNzE2IiwidHlwIjoiSldUIn0.eyJuYmYiOjE2NDc1Mzg0ODAsImV4cCI6MTY0NzUzOTY4MCwiaXNzIjoiaHR0cHM6Ly9hZG1pbi5yYWMudG90dnMuYXBwL3RvdHZzLnJhYyIsImF1ZCI6ImF1dGhvcml6YXRpb25fYXBpIiwiY2xpZW50X2lkIjoiODVhYWFmMjU5YTdhNGM2MWIwNmQwMDg3M2I0OWQ1M2QiLCJodHRwOi8vd3d3LnRuZi5jb20vaWRlbnRpdHkvY2xhaW1zL3Byb2R1Y3ROYW1lIjoiK1NhbGRvIiwiaHR0cDovL3d3dy50bmYuY29tL2lkZW50aXR5L2NsYWltcy9wcm9kdWN0SWQiOiIyMCIsImh0dHA6Ly93d3cudG5mLmNvbS9pZGVudGl0eS9jbGFpbXMvdGVuYW50SWQiOiI1ZGFkMDdjYy1mY2E0LTRmMWQtYmFiYi1iMTA0YzJhMTFjOTYiLCJpYXQiOjE2NDc1Mzg0ODAsInNjb3BlIjpbImF1dGhvcml6YXRpb25fYXBpIl19.wQi5JXsN_7pMpC-kj7pmS9Pnr-RiV45anwZ2bopy3usKKPJH6Pk9W-sMvuQ3G_mhIYSear1vQMK3OgTDwTNmLBHTjRu3AN6WW7L2oBn9bebYCpLZHtarK8DQ3JrHBpkwmhtsex62_ZDFwDS0rFf8j7JBWJJN3uib2U9ttZ1OhEe__PykmSFJ6yTdg51AlS4RSKrSMqzFIpiDKq8_ZK4E_rCJFwXNYx1dk7eChEfBy5o-CYDiM-YNLsFi2ingZDap7WnD1jpNgs9YyrxwUqYXGwX9hkE2ieUNHDxlw5Xp2hWTtvFSqdKjEpE4sGUA6K3Mi-tuZuNygbSoyWPcImENbQ",
    "expires_in": 1200,
    "token_type": "Bearer"
}

c) - Api's que retornam os aplicativos que o cliente tem acesso

Ambiente	Endereço
Desenvolvimento	https://provisioning.dev.totvs.app/api/data-management/v1/apps/by-tenant
Staging	https://provisioning.staging.totvs.app/api/data-management/v1/apps/by-tenant
Produção	https://provisioning.totvs.app/api/data-management/v1/apps/by-tenant

Informações
O retorno dessa api, fornecerá um json contendo os aplicativos que o cliente tem acesso.

Informações

O acessToken recuperado na chamada acima deverá ser enviada nessa chamada de api conforme exemplo abaixo no postMan:

Image Added

Algum problema de conectividade poderá ocorrer nessa chamada. Portanto, é importante utilizar o aplicativo "curl" para verificar se a chamada está sendo realizada com sucesso. Nesse caso, basta rodar o comando abaixo em todas as máquinas de servidor de aplicação (máquinas que respondem a solicitações de tela) do ambiente de produção do cliente conforme exemplo

curl --location --request GET "https://provisioning.totvs.app/api/data-management/v1/apps/by-tenant" --header "split-metadata: true" --header "Authorization:Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjJiYjZmYzUyM2ZjNzQwZjI4NmMxOTZmY2ExMzUyNzE2IiwidHlwIjoiSldUIn0.eyJuYmYiOjE2NDc1Mzg2MjMsImV4cCI6MTY0NzUzOTgyMywiaXNzIjoiaHR0cHM6Ly9hZG1pbi5yYWMudG90dnMuYXBwL3RvdHZzLnJhYyIsImF1ZCI6ImF1dGhvcml6YXRpb25fYXBpIiwiY2xpZW50X2lkIjoiODVhYWFmMjU5YTdhNGM2MWIwNmQwMDg3M2I0OWQ1M2QiLCJodHRwOi8vd3d3LnRuZi5jb20vaWRlbnRpdHkvY2xhaW1zL3Byb2R1Y3ROYW1lIjoiK1NhbGRvIiwiaHR0cDovL3d3dy50bmYuY29tL2lkZW50aXR5L2NsYWltcy9wcm9kdWN0SWQiOiIyMCIsImh0dHA6Ly93d3cudG5mLmNvbS9pZGVudGl0eS9jbGFpbXMvdGVuYW50SWQiOiI1ZGFkMDdjYy1mY2E0LTRmMWQtYmFiYi1iMTA0YzJhMTFjOTYiLCJpYXQiOjE2NDc1Mzg2MjMsInNjb3BlIjpbImF1dGhvcml6YXRpb25fYXBpIl19.t8s4wJZEfOA1yGq1jUVzNdCVTs_cXh8hMhP8pXzqMAoG1uSjsK88nDngvOXmbDwD5xBwJSoQistDDGNVFLEzrYXlgVSWd3hP26gZtvYIg-jM1MWwxayW8UXbFIIXDxG_xv0GB81-CaE8T7Dy6b2xx3w766NADJsEAkvx1qLzSXHE8lLSr-cSdLG9xVb7YfbubD2s2Y1oyWKtkW9ZdGiUoAjR27neWNgVlRbBz9IDel2omTdUeDN5vohoADNJuHOlZ0Z6QelMLOq3KTAA48hASMc1-

...

wgq5glRp-W2H54tUqyTdU9Gv1LjN_F9Sjf4OMROZfMINjzOlBZuxFpcVU_mQQ"

Deve ser retornado um json no seguinte formato, conforme exemplo:

[ { "productName": "Consignado", "productKey": "saldo" } ]

HABILITAR TLS

Em alguns casos é necessário ajustar o TLS do servidor.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 10

Nova versão 11

Chave