Struct AZTecDecoder 

pub struct AZTecDecoder { /* private fields */ }

Klient dekodera kodów AZTEC 2D z dowodów rejestracyjnych (Web API).

Komunikuje się z usługą Web API pod adresem https://www.pelock.com/api/aztec-decoder/v1.

Przykład

use aztec_decoder::AZTecDecoder;

let decoder = AZTecDecoder::new("ABCD-ABCD-ABCD-ABCD");
let result = decoder.decode_text("ggMAANtYAAJD...").await?;
println!("{}", serde_json::to_string_pretty(&result)?);

Implementations

impl AZTecDecoder

pub fn new(api_key: impl Into<String>) -> Self

Tworzy nową instancję dekodera.

Argumenty

• api_key – klucz do usługi Web API

pub async fn decode_text(&self, text: &str) -> Result<Value, AZTecError>

Dekoduje zaszyfrowaną wartość tekstową do wyjściowej struktury JSON.

Wysyła polecenie decode-text wraz z podanym tekstem (np. odczytanym skanerem w formacie Base64) do serwera Web API.

Argumenty

• text – odczytana wartość kodu AZTEC 2D w formie ASCII

Błędy

Zwraca AZTecError w przypadku pustego klucza API, błędu sieciowego lub nieprawidłowej odpowiedzi JSON.

pub async fn decode_text_from_file( &self, path: impl AsRef<Path>, ) -> Result<Value, AZTecError>

Dekoduje zaszyfrowaną wartość tekstową ze wskazanego pliku do wyjściowej struktury JSON.

Odczytuje zawartość pliku jako UTF-8 i przekazuje ją do decode_text.

Argumenty

• path – ścieżka do pliku z odczytaną wartością kodu AZTEC 2D

Błędy

Zwraca AZTecError::FileRead jeśli plik nie istnieje lub nie można go odczytać, oraz pozostałe warianty AZTecError w przypadku błędów komunikacji z API.

pub async fn decode_image_from_file( &self, path: impl AsRef<Path>, ) -> Result<Value, AZTecError>

Dekoduje zaszyfrowaną wartość zakodowaną w obrazku PNG lub JPG/JPEG do wyjściowej struktury JSON.

Wysyła plik graficzny jako formularz multipart z poleceniem decode-image do serwera Web API.

Argumenty

• path – ścieżka do obrazka z kodem AZTEC 2D

Błędy

Zwraca AZTecError::FileRead jeśli plik nie istnieje lub nie można go odczytać, oraz pozostałe warianty AZTecError w przypadku błędów komunikacji z API.