Abundera QR Check/ Documentazione per sviluppatori

Documentazione per sviluppatori

REST API per il servizio di classificazione della sicurezza QR/barcode Abundera QR Check. Invia un payload decodificato e ricevi un verdetto con catena percorsa.

Specifica API

L'API Abundera QR Check segue OpenAPI 3.1. Sfoglia il riferimento interattivo, scarica la specifica o importala nel tuo client API preferito.

Riferimento API interattivo →
Ogni endpoint con schemi di richiesta/risposta, parametri e possibilità di prova nel browser. Powered by Scalar.
OpenAPI 3.1 (YAML)
Specifica completa con schemi, descrizioni ed esempi. Ideale per i generatori di documentazione.
OpenAPI 3.1 (JSON)
Stessa specifica in JSON. Ideale per il consumo programmatico e gli strumenti.
Postman Collection v2.1
Importa in Postman o Insomnia. Pre-configurato con le variabili {{base_url}} e {{token}}.

Autenticazione

L'endpoint pubblico POST /api/scan è soggetto a rate limit per il livello anonimo (10 richieste al minuto in burst, 3 ogni 24 ore, per IP). Un livello Pro a pagamento, in arrivo con il lancio per i Membri Fondatori, supera i limiti anonimi quando viene presentata una chiave API come bearer token:

Authorization: Bearer sk_live_abnd_check_…

Le chiavi API vengono create alla sottoscrizione e gestite su abundera.ai/account/api-keys. La validazione è federata all'hub e memorizzata nella cache KV per 60 secondi.

URL di base e formato

URL di base: https://check.qr.abundera.ai

Formato della richiesta: JSON (Content-Type: application/json).

Formato della risposta: JSON (application/json; charset=utf-8). Le risposte contengono un campo schema_version.

Esempio rapido

curl -X POST https://check.qr.abundera.ai/api/scan \
  -H "Content-Type: application/json" \
  -d '{"payload":"https://example.com/login"}'

Discovery (well-known)

Endpoint di auto-discovery sotto /.well-known/ (RFC 8615). Sfoglia l'indice leggibile o recupera direttamente:

Indice /.well-known/ →
Elenco leggibile di ogni URI well-known pubblicato da questo sito.
Funzionalità
Ambiti, livelli di rate limit, superficie API. Aggregati dalle UI federate dell'hub.
Politica di sicurezza QR
Schema dei verdetti di Check, formati supportati, feed di reputazione, postura sulla privacy.
Catalogo API famiglia →
RFC 9727 Linkset sull'hub che elenca ogni API Abundera.

Correlati

Copertura e formati supportati
Ogni formato QR/barcode e tipo di payload riconosciuto dallo scanner.
Prezzi
Livello Free vs. Pro, offerta per i Membri Fondatori e dettagli sui rate limit.
Architettura di sicurezza
Come vengono elaborati i payload, cosa viene memorizzato nella cache e la postura sulla privacy QR-17/18.