Documentazione
Come integrare i contenuti di Riva Stories nel vostro sito o nel vostro sistema.
Riva Stories fornisce ai rivenditori online i contenuti di prodotto dei brand: scheda tecnica, immagini, documenti e Product Story (rich content). Un prodotto si identifica sempre per EAN/GTIN oppure per brand + MPN, il codice del produttore (non il vostro SKU interno).
Due modi di integrare
| Servizio | Cosa fa | Per chi | Credenziali |
|---|---|---|---|
| JS Script | Tre righe di JavaScript nella pagina prodotto: story, scheda tecnica, testata con galleria compaiono dentro la vostra pagina, già impaginate e aggiornate da noi. | Chi vuole il contenuto pronto, senza sviluppo | Shop (identificativo pubblico) + domini autorizzati |
| Dati | Chiamate HTTP che restituiscono i dati strutturati in JSON, XML o CSV, da importare nel vostro gestionale o PIM. Include anche il JS Script. | Chi vuole i dati grezzi nel proprio sistema | Chiave API nell'intestazione X-API-Key |
Come si parte
- Richiedete l'accesso: azienda, referente, sito, servizio desiderato. Confermate l'email.
- Riva verifica la richiesta e la attiva. Ricevete una mail con il link per impostare la password.
- Nell'area clienti trovate: lo shop, i domini autorizzati, la chiave API (servizio Dati), gli snippet già compilati, la prova dal vivo per EAN e i consumi.
La pagina Integrazione dell'area clienti ha gli esempi già compilati con il vostro shop. Questa documentazione spiega tutto il resto.
Cosa vedono i vostri visitatori
Il JS Script non imposta cookie, non traccia i visitatori tra siti diversi e non carica risorse pubblicitarie. Registriamo solo i dati tecnici necessari a servire la richiesta e a rendicontare i consumi (vedi privacy). Non serve aggiungere nulla al vostro banner cookie.
Ambienti e limiti
| Cosa | Valore |
|---|---|
| Base URL | https://api.rivastories.com |
| Lingue | IT con riserva EN; altre lingue su richiesta |
| Limite API dati | 300 richieste al minuto per chiave (modificabile per contratto); intestazioni X-RateLimit-Limit e X-RateLimit-Remaining in ogni risposta |
| Limite JS Script | nessun limite per shop; 120 richieste al minuto per singolo indirizzo IP |
| Perimetro | ogni accesso vede i brand previsti dal contratto; un prodotto fuori perimetro risponde 403 (dati) o "nessun contenuto" (widget) |