Panoramica
Fieldwire include un’API (Application Program Interface) Open REST disponibile per i clienti con contratto Enterprise o che hanno aggiunto l’accesso API al proprio abbonamento Pro/Business/Business Plus tramite il nostro team commerciale. (Vedi la nostra pagina sulle tariffe per maggiori informazioni).
Ti invitiamo a richiedere una demo se vuoi saperne di più su come usare la nostra API e/o aggiornare il tuo account per ottenere l’accesso!
Sommario
Funzionalità API
La nostra API ti consente di svolgere tutte le operazioni possibili tramite l’interfaccia utente di Fieldwire (e non solo), ma usando il codice! Alcuni dei modi più comuni in cui i nostri clienti utilizzano l'API sono: importare in blocco i dati dei progetti creati in altri sistemi quando migrano a Fieldwire; sincronizzare i dati tra Fieldwire e altre piattaforme software; copiare automaticamente planimetrie e documenti Fieldwire sui propri server; analizzare grandi quantità di dati su più progetti.
- Visualizza la documentazione della nostra API
- Iscriviti per ricevere le notifiche email del Changelog API
Accesso sviluppatori e chiavi API
I titolari account e i gestori account possono richiedere l’accesso come sviluppatori, generare token API, vedere se l’accesso API è abilitato o no e consultare la nostra documentazione API dalla sezione "Impostazioni API" nella scheda "Account" nella homepage del proprio account Fieldwire.
Come attivare l’accesso sviluppatori
1. Contatta il nostro team Account per ottenere una demo API e acquistare un abbonamento Fieldwire Premium con accesso API.
2. Accedi alla homepage Fieldwire da web, fai clic per visualizzare la scheda "Account" e scorri in basso fino alla sezione "Impostazioni API".
3. Fai clic sul link "Richiedi l'accesso API per sviluppatori":
3. Comparirà un pop-up per contattare via email l’indirizzo support@fieldwire.com. Nella richiesta assicurati di includere le informazioni di contesto necessarie e assicurati di premere il pulsante blu "Invia":
4. Il nostro team risponderà per confermarti l’avvenuta attivazione dell’accesso API per il tuo account.
Come generare le chiavi API
1. Segui le istruzioni qui sopra per ottenere l’accesso sviluppatori.
2. Quando accedi alla sezione "Impostazioni API" in basso nella scheda Account della homepage Fieldwire, il link "Richiedi l’accesso API per sviluppatori" sarà scomparso. (Se il link è ancora disponibile, segui le istruzioni riportate qui sopra per richiedere l’accesso). Se il link è stato sostituito da un link "Gestisci i token", l’operazione è andata a buon fine. Fai clic sul link per proseguire:
3. Fai clic su "Nuovo token" per generare una chiave API per il tuo account.
Nota: è possibile generare fino a 10 chiavi API per ogni account Fieldwire. Assicurati che le chiavi siano conservate in modo sicuro e condivise solo con chi ne ha diritto.
4. Assegna un nome univoco alla tua chiave API, poi fai clic su "Crea".
5. Il popup che segue rivelerà ora un token API univoco. Assicurati di conservare questo token in un luogo sicuro, perché non potrai più visualizzarlo una volta chiuso il popup.
Se chiudi accidentalmente il popup, puoi revocare il token e generarne uno nuovo.
Nota: La revoca disattiverà il vecchio token e pertanto tutte le funzioni che lo utilizzano dovranno essere aggiornate con il nuovo token.
Se dopo aver seguito queste istruzioni hai problemi con i token API, contatta support@fieldwire.com.
Pagina sviluppatori API
- Una volta ottenuto l’accesso alla nostra API, consulta la Documentazione per sviluppatori API per ulteriori informazioni.
- Per visualizzare i cambiamenti recenti nella struttura dell’API, consulta il changelog.
- Se lo desideri, puoi anche iscriviti per ricevere le notifiche email del Changelog API.
- Se preferisci, puoi iscriverti al feed RSS del changelog.
Nota: le chiamate API per gli status attività personalizzati non sono ancora disponibili nella documentazione per sviluppatori API. Assicurati di seguire questa guida per le chiamate API per gli status attività personalizzati.