Saltar al contenido

Inicio rápido

Requisitos previos:

  • Riversoft® STCP Gemini API instalada y en ejecución. Vea Instalación de Riversoft STCP Gemini.
  • Un operador del Riversoft Console Portal con permiso de consulta.
  • curl y, opcionalmente, jq.

Defina la dirección de la API

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

Obtenga el token de acceso

read -r -p 'Operador: ' API_USER
read -r -s -p 'Contraseña: ' 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 no aplica la autenticación de dos factores (2FA). Si el 2FA está habilitado en el registro de la API, o si el operador inicia sesión por LDAP, obtenga el token como en Inicio de sesión local y 2FA.

Consulte el historial de transferencias

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"

La respuesta incluye los registros en data y la página siguiente en next.

Cierre la sesión

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

Próximos pasos: vea los demás informes y la referencia de la API.