Programma API
Developer Terms
1. Ambito e accettazione
Questi termini integrano i Termini di Servizio per chi crea o utilizza chiavi API Vetrinà. La creazione di ogni chiave richiede un’accettazione esplicita e ne registra versione, data, utente e workspace.
2. Credenziali e responsabilità
Le chiavi sono segrete e appartengono al workspace. Devi conservarle lato server, limitarne l’accesso, ruotarle in caso di sospetta esposizione e revocare quelle non più necessarie. Non inserirle in repository pubblici, applicazioni client o pagine web.
3. Versioni e compatibilità
Le integrazioni devono usare endpoint versionati, attualmente /api/v1. Le modifiche additive possono essere pubblicate nella stessa major; rimozioni, rinomine o cambiamenti incompatibili richiedono una nuova major e una guida di migrazione. OpenAPI e capabilities sono le fonti tecniche ufficiali.
4. Aggiornamenti operativi
Finché esiste una chiave attiva, Vetrinà può inviare al suo creatore report necessari su release del contratto API, deprecazioni, scadenze, migrazioni, incidenti e sicurezza. Sono comunicazioni operative connesse all’uso dell’API e restano separate da marketing e newsletter. Per non riceverle occorre revocare tutte le chiavi attive associate o indicare un diverso referente tecnico tramite il supporto.
5. Uso corretto
Devi rispettare limiti, quote, idempotenza e istruzioni di sicurezza. Sono vietati aggiramento dei rate limit, condivisione o rivendita non autorizzata delle credenziali, probing abusivo, scraping e uso dell’API per contenuti o attività illecite.
6. Modifiche, deprecazione e sospensione
Le versioni deprecate indicano gli header Deprecation, Sunsetquando definito e il link alla versione successiva. Possiamo sospendere una chiave per rischio di sicurezza, abuso, obbligo legale o violazione dei termini, informando il workspace quando possibile.
7. Dati e comunicazioni
Trattiamo identificativi di chiave in forma hash, utilizzo, errori, accettazioni e prove di consegna dei report secondo la Privacy Policy. I report tecnici non devono contenere segreti, payload cliente o dati personali non necessari.
8. Contatti
Per cambiare referente tecnico o chiedere chiarimenti: stocka.official@gmail.com.