Glossario

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Esistono diversi concetti comuni con un significato unico in Apigee.

Termine Definizione
API Un proxy che funge da facade per l'API esistente. Anziché chiamare la tua API esistente, gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa facciata disaccoppia la tua interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche al backend e consentendoti di innovare a livello perimetrale senza influire sui team di sviluppo interni. Mentre apporti modifiche al backend, gli sviluppatori continuano a chiamare la stessa API senza interruzioni. Negli scenari più avanzati, Apigee ti consente di esporre più interfacce alla stessa API, lasciandoti la possibilità di personalizzare la firma di un'API per soddisfare contemporaneamente le esigenze di varie nicchie di sviluppatori.
Percorso e risorse di base dell'API Un'API è composta da un percorso di base e un insieme di risorse (noti anche come percorsi delle risorse). Per ogni API, definisci un singolo URL principale e più percorsi delle risorse. Puoi considerare un'API semplicemente come un insieme di URI, tutti condividono un percorso di base comune. Per semplificare la gestione delle API, Apigee aumenta questi URI non elaborati con nomi visualizzati e descrizioni.
Consumatore API Sinonimo di "sviluppatore di app", che utilizza le API create da un provider di API.
Sviluppatore di API Un ingegnere software in un'organizzazione provider di API che crea API. Queste API vengono utilizzate dagli sviluppatori di app (consumer di API) per creare app.
Pacchetto API Una raccolta di prodotti API presentati agli sviluppatori come un pacchetto e generalmente associati a un piano tariffario.
Prodotto API Una raccolta di risorse API (URI) combinate con un piano di servizio e presentate agli sviluppatori in un bundle. Il prodotto API può anche includere alcuni metadati specifici per la tua azienda per il monitoraggio o l'analisi. È possibile monetizzare una o più risorse includendole in un prodotto API, che può quindi essere abbinato a un pacchetto API per la monetizzazione.
Provider API Un provider di API crea API (utilizzando Edge) che possono essere utilizzate dai consumatori di API (sviluppatori di app).
sviluppatore di app In Edge, gli sviluppatori di app registrano le proprie app con un provider di API, il che consente a questi ultimi di ottenere le chiavi API necessarie per chiamare i proxy API del provider.
app I tuoi sviluppatori utilizzano le app per accedere alle risorse nei tuoi prodotti API. Quando crei un'app, selezioni il prodotto API da includere e Apigee genera una chiave. Ogni app ha una singola chiave che fornisce l'accesso a più prodotti API. Le app ti consentono di controllare chi può accedere alle tue risorse. Puoi controllare chi può accedere ai prodotti API revocando e aggiornando la chiave di un'app. Inoltre, puoi controllare l'accesso a pacchetti di risorse revocando o eliminando l'accesso ai prodotti in un'app.
dettagli del saldo Per uno sviluppatore con pagamento anticipato, il saldo nell'account dello sviluppatore.
aggiustamento chiuso Un aggiustamento che è stato applicato nei documenti di fatturazione pubblicati.
mese di fatturazione chiuso Un mese di calendario completo per il quale sono stati pubblicati i documenti di fatturazione.
limite personalizzato Un limite (come un limite al numero di transazioni su un prodotto API) che puoi impostare esplicitamente utilizzando la monetizzazione. Chiamato anche limite esplicito.
piano tariffario per categoria di sviluppatori Un piano tariffario che si applica a tutti gli sviluppatori di una categoria specifica e che può essere acquistato da tutti gli sviluppatori di quella categoria.
piano tariffario per sviluppatori Un piano tariffario che si applica a uno sviluppatore specifico e può essere acquistato solo da tale sviluppatore.
agente dichiarato Nel diritto commerciale, una persona autorizzata ad agire per conto di un'altra persona (definita il preside) al fine di creare un rapporto legale con una terza parte. Nella monetizzazione, è possibile configurare un modello fiscale per un piano di entrate condiviso in modo che il fornitore dell'API agisca come un agente divulgato dello sviluppatore per riscuotere le entrate (ed eventualmente le imposte sulle vendite) per conto dello sviluppatore.
modello fiscale dichiarato Un modello fiscale in cui il fornitore dell'API agisce in qualità di agente comunicato dello sviluppatore.
ambiente Un contesto di esecuzione runtime per le API. È necessario eseguire il deployment di un'API in un ambiente prima di potervi accedere in fase di runtime. Per impostazione predefinita, il provisioning delle organizzazioni Apigee viene eseguito con due ambienti: "test" e "prod". L'ambiente "test" viene generalmente utilizzato per il deployment delle API in fase di test. L 'ambiente di produzione viene generalmente utilizzato per il deployment delle API per l'uso in produzione.
modello fiscale ibrido Un modello fiscale in cui il fornitore dell'API agisce in qualità di agente comunicato dello sviluppatore. Tuttavia, il fornitore dell'API paga l'imposta sulle vendite riscossa dai propri abbonati alle autorità fiscali locali per conto dello sviluppatore.
limite implicito Un limite (ad esempio un limite del saldo prepagato dello sviluppatore) impostato dalla monetizzazione.
monetizzazione Componente dei servizi per sviluppatori Apigee Edge che fornisce un modo flessibile e facile da usare per monetizzare i prodotti API.
importo mensile utilizzato Utilizzo totale da parte di uno sviluppatore per un determinato mese, che include la commissione di configurazione + la commissione di transazione + la commissione ricorrente.
pagamenti mensili I pagamenti ricorrenti effettuati da uno sviluppatore in base ai piani acquistati. I piani tariffari possono avere una tariffa ricorrente che viene addebitata allo sviluppatore ogni mese, indipendentemente dall'utilizzo.
dichiarazione di compensazione Un documento finanziario che mostra i saldi netti tra fatture ed estratti conto relativi alla quota di condivisione delle entrate.
apri aggiustamento Un aggiustamento non ancora applicato nei documenti di fatturazione pubblicati.
Apri mese di fatturazione Un mese di calendario completo per il quale non sono stati pubblicati documenti di fatturazione "finali".
organizzazione Un container per tutti gli oggetti nel tuo account Apigee, tra cui API, prodotti API, pacchetti API, app e sviluppatori. È necessario un account utente per ogni organizzazione di cui puoi essere membro. La maggior parte degli utenti avrà un account in una sola organizzazione. Per ogni richiesta API inviata, devi fornire le tue credenziali (nome utente e password) e il nome della tua organizzazione.
catalogo dei pacchetti Un elenco di pacchetti API. Ogni pacchetto è elencato con i prodotti API e i piani tariffari.
saldo prepagato Un importo disponibile che uno sviluppatore prepagato può pagare in anticipo per i pacchetti API.
sviluppatore prepagato Uno sviluppatore che paga in anticipo per l'utilizzo di un prodotto API. I fondi vengono detratti dal saldo prepagato di uno sviluppatore quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per acquistare il prodotto API. Agli sviluppatori viene assegnato lo stato prepagato o postpagato dal fornitore di API.
norme Una fase di elaborazione che viene eseguita come unità logica atomica e riutilizzabile all'interno di un flusso API. I criteri tipici includono il routing delle richieste all'endpoint appropriato, la trasformazione di un formato dei messaggi, l'applicazione del controllo dell'accesso, la chiamata a servizi remoti per ulteriori informazioni, il mascheramento dei dati sensibili degli utenti esterni, l'esame dei contenuti dei messaggi per potenziali minacce, la memorizzazione nella cache delle risposte comuni per migliorare le prestazioni e così via. I criteri possono essere eseguiti in modo condizionale in base ai contenuti o al contesto di una richiesta o di un messaggio di risposta. Ad esempio, è possibile eseguire un criterio di trasformazione per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone.
sviluppatore con pagamento posticipato Uno sviluppatore che riceve l'addebito mensile (tramite una fattura) per l'utilizzo di prodotti API. Lo sviluppatore paga l'utilizzo dei prodotti API in base ai termini di pagamento stabiliti dai piani inclusi nella fattura. Agli sviluppatori viene assegnato lo stato con pagamento posticipato o prepagato dal provider di API.
prezzi consigliati Una gamma di possibili prezzi a cui un prodotto potrebbe essere commercializzato.
piano tariffario del tariffario Un piano tariffario in cui allo sviluppatore viene addebitata una tariffa fissa o variabile per ogni transazione relativa a un prodotto API monetizzato.
piano tariffario Una specifica di tariffe, altri addebiti e quota di condivisione delle entrate per l'utilizzo di prodotti basati su API offerti in un pacchetto API monetizzato.
percorso risorsa
Un concetto RESTful, ovvero un percorso risorsa è una risorsa uniforme identificata (URI) che identifica il percorso di rete verso una determinata risorsa.
piano tariffario per la quota di condivisione delle entrate Un piano tariffario in cui una percentuale delle entrate generate da ogni transazione relativa a un prodotto API monetizzato viene condivisa con lo sviluppatore dell'app che ha inviato la richiesta.
quota di condivisione delle entrate e piano tariffario Un piano tariffario in cui una percentuale delle entrate generate da ogni transazione relativa a un prodotto API monetizzato viene condivisa con lo sviluppatore dell'app che ha inviato la richiesta. Allo sviluppatore viene inoltre addebitata una commissione fissa o variabile per ogni transazione.
fattura con autofatturazione Un documento finanziario generato al posto di una dichiarazione sulla quota di condivisione delle entrate. Indica in dettaglio l'importo dovuto allo sviluppatore e funge da fattura al fornitore di API per conto dello sviluppatore.
piano tariffario standard Un piano tariffario disponibile per l'acquisto da parte di tutti gli sviluppatori.
tax Imposta totale applicata all'utilizzo e alle commissioni di uno sviluppatore.
ricarica L'azione intrapresa da uno sviluppatore prepagato per aggiungere fondi al saldo prepagato.
criteri di registrazione delle transazioni Meccanismo che consente alla monetizzazione di acquisire parametri di transazione e attributi personalizzati. La monetizzazione ha bisogno di queste informazioni per eseguire l'elaborazione della monetizzazione, ad esempio applicando piani tariffari alle richieste e alle risposte delle API in base agli attributi personalizzati acquisiti in ogni transazione.
agente non identificato Un'organizzazione (o operatore) che partecipa alla fornitura sottostante di applicazioni, in modo che si preveda l'acquisto dei contenuti per conto dello sviluppatore (solo a fini fiscali). In qualità di agente non dichiarato, l'organizzazione (o l'operatore) può riscuotere e tenere conto delle imposte dovute dagli utenti finali. Questo stato è pertinente solo ai fini fiscali: lo stato legale dello sviluppatore nella catena di fornitura non è interessato.
modello fiscale non specificato Modello fiscale in cui il fornitore dell'API detrae le tasse riscosse dagli utenti finali e la versa alle autorità fiscali locali.
Versione La versione dell'interfaccia API rivolta agli sviluppatori. Ad esempio, pivotaltracker.com/services/v3 o api.enterprise.apigee.com/v1. Questo termine si distingue dalla "revisione", che è il pacchetto numerato e controllato a livello di versione di configurazione e criteri abbinato a un proxy API. In breve, le interfacce API hanno più versioni, mentre i proxy API hanno revisioni.