Panoramica
Fieldwire fornisce un'API RESTful aperta (interfaccia di programmazione delle applicazioni) ai clienti con un contratto a livello Enterprise, o che hanno aggiunto l'accesso API al loro piano Pro/Business/Business Plus in collaborazione con il nostro team commerciale. (Consulta la nostra pagina dei prezzi per maggiori dettagli).
Per favore richiedi una demo se sei interessato a saperne di più su come puoi utilizzare la nostra API e/o a fare l'upgrade del tuo account per accedervi!
Indice
Accesso API: determina il tuo prossimo passo
I tuoi prossimi passi dipendono dal fatto che il tuo account abbia già l'accesso API abilitato.
- SE il tuo account ha già l'accesso API abilitato ALLORA puoi generare un token API seguendo i passaggi nella sezione “Come generare chiavi API” qui sotto E non è necessario alcun acquisto aggiuntivo o contatto con il team commerciale
- SE il tuo account NON ha l'accesso API abilitato ALLORA dovrai collaborare con il nostro team commerciale per aggiornare il tuo account o aggiungere l'accesso API al tuo piano attuale E NON potrai generare token API finché l'accesso API non sarà stato abilitato
Funzionalità API
La nostra API ti permette di fare tutto ciò che puoi fare nell'interfaccia utente di Fieldwire (e anche di più), ma con la programmazione! Alcuni modi popolari in cui i nostri clienti utilizzano l'API sono importare in blocco dati di progetto esistenti da altri sistemi a Fieldwire durante la migrazione sulla nostra piattaforma, sincronizzare dati tra altri software e Fieldwire, copiare automaticamente piani e documenti di Fieldwire sui propri server e analizzare grandi quantità di dati su più progetti.
Accesso sviluppatore e chiavi API
I Proprietari e i Manager degli account possono richiedere l'accesso sviluppatore, generare token API, verificare se l'accesso API è abilitato o disabilitato e visualizzare la nostra documentazione API nella sezione 'Impostazioni API' nella scheda 'Account' nella pagina iniziale del loro account Fieldwire.
Come attivare l'accesso sviluppatore (richiede accesso API)
IMPORTANTE: Devi già avere l'accesso API abilitato sul tuo account prima di richiedere l'accesso sviluppatore. Se non hai ancora accesso API, consulta la sezione “Accesso API: determina il tuo prossimo passo” qui sopra.
1. Contatta il nostro team account per ottenere una demo API e acquistare un abbonamento Premium Fieldwire personalizzato con accesso API.
2. Vai alla pagina Home su Fieldwire web, clicca per visualizzare la scheda 'Account' e scorri fino alla sezione 'Impostazioni API' in fondo alla pagina.
3. Clicca sul link per 'Richiedi accesso sviluppatore API':
3. Apparirà un popup per inviare una email a support@fieldwire.com. Includi il contesto della tua richiesta e assicurati di cliccare il pulsante blu 'Invia' :
4. Il nostro team risponderà per confermare che abbiamo attivato l'accesso API del tuo account.
Come generare chiavi API
IMPORTANTE:
- Puoi generare chiavi API solo se ENTRAMBE le seguenti condizioni sono vere:
- L'accesso API è abilitato sul tuo account
- L'accesso sviluppatore è già stato attivato
SE non vedi l'opzione “Gestisci token” nelle Impostazioni API ALLORA potresti dover ancora richiedere l'accesso sviluppatore o confermare che l'accesso API è abilitato.
1. Segui le istruzioni sopra per ottenere l'accesso sviluppatore.
2. Quando navighi alla sezione Impostazioni API in fondo alla scheda Account della tua home page Fieldwire, il link "Richiedi accesso sviluppatore API" non sarà più presente. (Se è ancora presente, devi ancora seguire le istruzioni sopra per richiedere l'accesso).
Se vedi un link "Gestisci token" al suo posto, allora sei pronto.
Clicca quel link per procedere:
3. Clicca su "Nuovo Token" per generare una chiave API per il tuo account.
Nota: Possono essere generate fino a 10 chiavi API per account Fieldwire. Assicurati di conservarle in modo sicuro e di condividerle solo con persone autorizzate.
4. Dai un nome unico alla tua chiave API, quindi clicca su "Crea".
5. Il popup successivo mostrerà un token API unico. Assicurati di conservarlo in un luogo sicuro, poiché non potrai più accedervi una volta chiuso il popup.
Se chiudi accidentalmente il popup, puoi revocare il token e generarne uno nuovo.
Nota: Revocare disattiverà il token vecchio, quindi tutte le istanze in cui è stato usato dovranno essere aggiornate con il nuovo token.
Se hai problemi con i token API dopo aver seguito queste istruzioni, invia un'email a support@fieldwire.com.
Riepilogo dei requisiti
Per generare un token API, TUTTI i seguenti devono essere veri:
- Il tuo account include l'accesso API (Enterprise o aggiunto tramite Sales)
- L'accesso sviluppatore è stato richiesto e approvato
- Puoi vedere l'opzione “Gestisci token” nelle Impostazioni API
SE manca anche solo uno di questi ALLORA non potrai generare un token API.
Pagina sviluppatori API
- Una volta che hai accesso alla nostra API, consulta la nostra documentazione per sviluppatori API per indicazioni.
- Per vedere le modifiche recenti nella struttura API, consulta il nostro changelog
- Allo stesso modo, puoi iscriverti al feed RSS del changelog
- Iscriviti alle notifiche email del changelog API, se desideri
Nota: Le chiamate API per lo stato personalizzato dei task non sono ancora visibili nella nostra documentazione per sviluppatori API. Assicurati di seguire questa guida per le chiamate CTS API.