Drip API – Documentation
Documentazione ufficiale delle Drip API. Qui trovi endpoint, modelli, parametri e risposte per integrare la piattaforma Drip nelle tue applicazioni.
Introduzione
Le Drip API sono progettate per essere RESTful, versionate e sicure. Tutti gli endpoint restituiscono dati in formato JSON e supportano autenticazione tramite token.
DripPoint
Controller per la gestione dei Drip Point
| API | Description |
|---|---|
| GET api/DripPoint/GetDripPointsVisible |
Restituisce i Drip Point visibili |
| POST api/DripPoint/v2/GetDripPointsVisible |
Restituisce i Drip Point visibili |
| GET api/DripPoint/GetTipologie |
Restituisce le tipologie di Drip Point |
| GET api/DripPoint/GetTipiContatto |
Restituisce i tipi di contatto/social disponibili per i Drip Point |
| GET api/DripPoint/GetMacrocategorie |
Restituisce le macrocategorie disponibili per i Drip Point |
| GET api/DripPoint/GetSottotipologie |
Restituisce le sottotipologie disponibili per i Drip Point |
| GET api/DripPoint/GetNomiCertificazioniUsati |
Restituisce una lista distinta di (NomeCertificazione, EnteEmittente) già usate, per l'autofill frontend quando si inserisce una nuova certificazione. |
| GET api/DripPoint/GetDripPoints |
Restituisce tutti i Drip Point |
| POST api/DripPoint/NewDripPoint |
Crea un nuovo Drip Point |
| POST api/DripPoint/EditDripPoint |
Modifica un Drip Point esistente |
| POST api/DripPoint/UploadPhoto?IdPointDrip={IdPointDrip} |
Carica la foto di copertina del Drip Point |
| POST api/DripPoint/UploadPhotoFromUrl?IdPointDrip={IdPointDrip} | |
| POST api/DripPoint/AppendPhotoFromUrl?IdPointDrip={IdPointDrip} |
Aggiunge una foto al Drip Point |
| POST api/DripPoint/AppendPhoto?IdPointDrip={IdPointDrip} |
Aggiunge una foto al Drip Point |
| POST api/DripPoint/UpdatePhotos |
Aggiorna ordine e stato delle foto del Drip Point |
| POST api/DripPoint/UploadCertificazioneImage |
Carica l'immagine di una certificazione di sostenibilità |
| POST api/DripPoint/DuplicaDripPoint?Id={Id} |
Duplica un Drip Point esistente |
| POST api/DripPoint/EliminaDripPoint?Id={Id} |
Elimina un Drip Point esistente |
Segnalazioni
Controller per la gestione delle segnalazioni.
| API | Description |
|---|---|
| POST api/segnalazioni/decline |
Imposta declined = true per una segnalazione specifica. |
| POST api/segnalazioni/VerifySegnalazione |
Imposta IsVerified = true per una segnalazione specifica. |
| GET api/segnalazioni/DeclineAllSegnalazioni |
Imposta declined = true e IsVerified = false per tutte le segnalazioni. |
| GET api/segnalazioni/GetSegnalazioni |
Restituisce tutte le segnalazioni ordinate per timestamp decrescente. |
| POST api/segnalazioni/AddSegnalazione |
Aggiunge una nuova segnalazione. |
TestAuth
Controller di test per verificare che la validazione JWT funzioni correttamente. UTILIZZO: GET /api/testauth/claims Header: Authorization: Bearer {token_wordpress} Risposta attesa: JSON con tutti i claim estratti dal token (email, id, username, roles). Se il token è valido, restituisce 200. Se mancante/scaduto/non valido, restituisce 401. Questo controller può essere rimosso una volta verificato il funzionamento in produzione.
| API | Description |
|---|---|
| GET api/testauth/claims |
Restituisce tutti i claim estratti dal token JWT. Usare questo endpoint per verificare che id, email, username e roles arrivino correttamente. |
| GET api/testauth/admin-only |
Endpoint di test per verificare l'autorizzazione per ruolo "administrator". Restituisce 403 Forbidden se l'utente autenticato non ha il ruolo richiesto. |
Commenti
Controller per la gestione dei commenti/recensioni su DripPoint.
| API | Description |
|---|---|
| POST api/Commenti/GetCommentiValidati/{idDripPoint} |
Recupera i commenti validati (pubblici) per uno specifico DripPoint, paginati. Accessibile a utenti autenticati. |
| GET api/Commenti/GetTipiEsperienza |
Recupera la lista di tipi di esperienza disponibili per i commenti. Accessibile pubblicamente. |
| GET api/Commenti/GetCosti |
Recupera la lista di categorie costo disponibili per i commenti. Accessibile pubblicamente. |
| GET api/Commenti/GetTempistiche |
Recupera la lista di categorie tempistica disponibili per i commenti. Accessibile pubblicamente. |
| POST api/Commenti/NewCommento |
Crea un nuovo commento su un DripPoint. Solo utenti autenticati possono commentare. Include validazione testo e rate limiting (max 1 commento per DripPoint al giorno). |
| POST api/Commenti/GetCommentiNonValidati |
Recupera i commenti non validati (in attesa di moderazione), paginati. Accessibile solo ad Admin e Editore. |
| POST api/Commenti/ValidateCommento/{idCommento} |
Valida (approva) un singolo commento. Accessibile solo ad Admin e Editore. |
| POST api/Commenti/ValidateCommentioBulk |
Valida (approva) più commenti in una sola richiesta. Accessibile solo ad Admin e Editore. |
| POST api/Commenti/DeclineCommento/{idCommento} |
Rifiuta un commento (cancellazione logica). Accessibile solo ad Admin e Editore. |