Skip to content

fiscalapi 0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Oct 05:30
· 3 commits to main since this release
v0.1.0
46eacd4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Primera versión de fiscalapi, el CLI de FiscalAPI para webhooks y eventos desde la terminal.

Qué trae

  • login / logout: guarda o borra la API key y la tenant key en el almacén de credenciales del sistema.
  • webhooks: administra los webhooks del tenant (list, retrieve, create, update, delete, rotate-secret).
  • events: consulta y reenvía los eventos de los últimos 30 días (list, retrieve, resend).
  • listen: recibe los eventos en la terminal y los reenvía a tu servidor local con --forward-to.
  • trigger <type>: dispara un evento de prueba hacia tu listen o hacia un webhook (solo en pruebas).
  • Aviso en stderr cuando hay una versión nueva.

Plataformas

Sistema Empaque Requisito
Windows x64 fiscalapi-win-x64.zip Windows 10 u 11, o Windows Server 2012 o más nuevo
Linux x64 fiscalapi-linux-x64.tar.gz glibc 2.28 o más nueva; no corre en Alpine (musl)
macOS Apple Silicon fiscalapi-osx-arm64.tar.gz macOS 15 o más nuevo
macOS Intel fiscalapi-osx-x64.tar.gz macOS 15 o más nuevo

Un solo ejecutable, sin dependencias. No tiene firma de código: SmartScreen y Gatekeeper avisan la primera vez.

Importante

La API con las rutas /api/v4/webhooks todavía no está desplegada en test ni en live. Por ahora el CLI solo funciona contra un back local:

fiscalapi login --api-base http://localhost:5001
fiscalapi listen --api-base http://localhost:5001 --forward-to http://localhost:3000/webhooks

Instalar y verificar

Descarga tu empaque y SHA256SUMS, y compara el SHA-256 antes de ejecutarlo.

Linux (en macOS cambia el empaque y usa shasum -a 256 -c - en lugar de sha256sum -c -):

base=https://github.com/FiscalAPI/fiscalapi-cli/releases/latest/download
curl -fsSLO "$base/fiscalapi-linux-x64.tar.gz"
curl -fsSLO "$base/SHA256SUMS"
grep ' fiscalapi-linux-x64.tar.gz$' SHA256SUMS | sha256sum -c -   # debe decir: OK
tar -xzf fiscalapi-linux-x64.tar.gz
sudo install -m 0755 fiscalapi /usr/local/bin/fiscalapi
fiscalapi --version

Windows (PowerShell):

$base = 'https://github.com/FiscalAPI/fiscalapi-cli/releases/latest/download'
Invoke-WebRequest "$base/fiscalapi-win-x64.zip" -OutFile fiscalapi-win-x64.zip
Invoke-WebRequest "$base/SHA256SUMS" -OutFile SHA256SUMS
$expected = (Select-String -Path SHA256SUMS -Pattern ' fiscalapi-win-x64\.zip$').Line.Split(' ')[0]
$actual = (Get-FileHash fiscalapi-win-x64.zip -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "El SHA-256 no coincide: $actual" } else { 'SHA-256 OK' }
Expand-Archive fiscalapi-win-x64.zip -DestinationPath (Join-Path $env:LOCALAPPDATA 'Programs\fiscalapi') -Force

Para esta versión fija, cambia releases/latest/download por releases/download/v0.1.0.

Documentación

  • README: inicio rápido.
  • Instalación: PATH, Gatekeeper, SmartScreen, actualizar y desinstalar.
  • Todas las guías: autenticación, listen, webhooks y eventos, trigger, salida y códigos, solución de problemas.

Full Changelog: https://github.com/FiscalAPI/fiscalapi-cli/commits/v0.1.0

Assets 7
Loading