Saltar para o conteúdo

Início rápido

Pré-requisitos:

  • Riversoft® STCP Gemini API instalada e em execução. Veja Instalação do Riversoft STCP Gemini.
  • Um operador do Riversoft Console Portal com permissão de consulta.
  • curl e, opcionalmente, jq.

Defina o endereço da API

export API_BASE='https://api.exemplo.com:33070'

Obtenha o token de acesso

read -r -p 'Operador: ' API_USER
read -r -s -p 'Senha: ' API_PASSWORD; printf '\n'

ACCESS_TOKEN=$(curl -s \
  --data-urlencode 'grant_type=password' \
  --data-urlencode "username=$API_USER" \
  --data-urlencode "password=$API_PASSWORD" \
  "$API_BASE/oauth/token" | jq -r .access_token)

Nota

POST /oauth/token não aplica a autenticação de dois fatores (2FA). Se a 2FA estiver habilitada no cadastro da API, ou se o operador entrar por LDAP, obtenha o token como em Login local e 2FA.

Consulte o histórico de transferências

START=$(( $(date -d '1 day ago' +%s) * 1000 ))
END=$(( $(date +%s) * 1000 ))

curl -s -G \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Accept: application/json' \
  --data-urlencode 'instance=STCPGEMINI' \
  --data-urlencode 'events=5' --data-urlencode 'events=7' \
  --data-urlencode "start=$START" --data-urlencode "end=$END" \
  --data-urlencode 'limit=100' \
  "$API_BASE/reports/v2/transfers"

A resposta traz os registros em data e a próxima página em next.

Encerre a sessão

curl -s -X DELETE \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  "$API_BASE/disconnect/api/v3/logout"

Próximos passos: veja os demais relatórios e a referência da API.