ERERE per sviluppatori

Le API di ERERE per aziende e sviluppatori. Nessuna restituisce dati personali in chiaro: le identità sono impronte, i dati aggregati restano sopra le soglie di anonimato, i file condivisi viaggiano cifrati. Il contratto completo, leggibile da qualsiasi strumento OpenAPI 3.1, è in /api/openapi.json; ogni risposta del server è verificata contro di esso a ogni rilascio.

Iniziare in un minuto

1. Leggi il listino (nessuna chiave):

curl https://erere.app/api/pricing/catalogue

2. Con la chiave aziendale rilasciata dal Custode, verifica un'identità:

curl -X POST https://erere.app/api/verify \
  -H 'content-type: application/json' \
  -H 'x-erere-key: LA_TUA_CHIAVE' \
  -d '{"user_hash":"impronta_della_persona","min_accuracy":70}'

In JavaScript:

const r = await fetch('https://erere.app/api/verify', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'x-erere-key': process.env.ERERE_KEY },
  body: JSON.stringify({ user_hash, min_accuracy: 70 }),
});
const { verified, accuracy } = await r.json();

In Python:

import os, requests
r = requests.post('https://erere.app/api/verify', json={'user_hash': user_hash, 'min_accuracy': 70},
                  headers={'x-erere-key': os.environ['ERERE_KEY']}, timeout=10)
print(r.json()['verified'])

Regole

• Errori: sempre JSON {"error": "…"} con lo stato HTTP (400 richiesta non valida, 401 chiave mancante, 403 non consentito, 404 non trovato, 410 scaduto, 429 troppe richieste).
• Limiti: 60 richieste al minuto per indirizzo sulle API generali; al 429 attendi i secondi indicati in Retry-After. Gli agenti hanno il limite del proprio abbonamento (listino agenti).
• Versioni: la data in info.version del contratto; un cambiamento incompatibile arriva con 90 giorni di preavviso e la versione precedente resta attiva in quel periodo.
• Prezzi: in centesimi di euro, IVA inclusa per i privati.
• Dati: nessuna API restituisce testi, posizioni o contenuti delle persone; le richieste sono registrate senza il corpo.
• Contratto aziendale: l'uso con chiave B2B segue le Condizioni per le aziende e le API (English), con l'accordo sul trattamento dei dati (art. 28 GDPR) e i livelli di servizio.
• Sicurezza: le vulnerabilità si segnalano secondo la politica di segnalazione (security.txt).

Riferimento

Stato del servizio · Aiuto