Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Esistono diversi concetti che sono idee comuni con un significato univoco in Apigee.
| Termine | Definizione |
|---|---|
| API | Un proxy che funge da facade per l'API esistente. Anziché chiamare l'API esistente API, gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa facade disaccoppia l'interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche del backend e consentendoti di innovare all'edge senza influire sui team di sviluppo interni. Man mano che apporti modifiche al backend, gli sviluppatori continuano a chiamare la stessa API senza interruzioni. In scenari più avanzati, Apigee ti consente di esporre più interfacce alla stessa API, consentendoti di personalizzare la firma di un'API per soddisfare contemporaneamente le esigenze di varie nicchie di sviluppatori. |
| Percorso base e risorse API | Un'API è composta da un percorso base e da un insieme di risorse (note anche come percorsi delle risorse). Per ogni API, definisci un singolo URL root e più percorsi delle risorse. Puoi considerare un'API semplicemente come un insieme di URI, tutti con un percorso base comune. Per semplificare la gestione delle API, Apigee aumenta questi URI non elaborati con nomi visualizzati e descrizioni. |
| Consumatore di API | Sinonimo di "sviluppatore di app", che utilizza le API create da un fornitore di API. |
| Sviluppatore di API | Un ingegnere software in un'organizzazione di fornitori di API che crea API. Queste API vengono utilizzate dagli sviluppatori di app (consumatori di API) per creare app. |
| Pacchetto API | Una raccolta di prodotti API presentati agli sviluppatori come un pacchetto e in genere associati a un piano tariffario. |
| Prodotto API | Una raccolta di risorse API (URI) combinate con un piano di servizio e presentate agli sviluppatori come un pacchetto. Il prodotto API può includere anche alcuni metadati specifici per la tua attività per il monitoraggio o l'analisi. Una o più risorse possono essere monetizzate includendo le in un prodotto API, che può essere raggruppato in un pacchetto API per la monetizzazione. |
| Fornitore API | Un fornitore di API crea API (utilizzando Edge) per l'utilizzo da parte dei consumatori di API (sviluppatori di app). |
| Sviluppatore di app | In Edge, gli sviluppatori di app registrano le proprie app presso un fornitore di API, in modo da ottenere le chiavi API necessarie per chiamare i proxy API del fornitore. |
| App | Gli sviluppatori utilizzano le app per accedere alle risorse nei prodotti API. Quando crei un'app, seleziona 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 ha accesso ai tuoi prodotti API revocando e aggiornando la chiave di un'app. Puoi controllare l'accesso ai bundle di risorse revocando o eliminando l'accesso ai prodotti in un'app. |
| Dettagli saldo | Per uno sviluppatore prepagato, il saldo nel suo account. |
| Aggiustamento chiuso | Un aggiustamento 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 (ad esempio un limite al numero di transazioni su un prodotto API) che puoi configurare in modo esplicito utilizzando la monetizzazione. È detto anche limite esplicito. |
| Piano tariffario per categoria di sviluppatori | Un piano tariffario che si applica a tutti gli sviluppatori di una categoria specifica ed è disponibile per l'acquisto da parte di tutti gli sviluppatori di quella categoria. |
| Piano tariffario per sviluppatori | Un piano tariffario che si applica a uno sviluppatore specifico ed è disponibile per l'acquisto solo da parte di questo sviluppatore. |
| Agente dichiarato | Nel diritto commerciale, una persona autorizzata ad agire per conto di un'altra (denominata principale) per creare un rapporto giuridico con una terza parte. Nella monetizzazione, è possibile configurare un modello fiscale per un piano di condivisione delle entrate in modo che il fornitore di API agisca come agente dichiarato dello sviluppatore per raccogliere le entrate (ed eventualmente le imposte sulle vendite) per conto dello sviluppatore. |
| Modello fiscale dichiarato | Un modello fiscale in cui il fornitore di API agisce come agente dichiarato dello sviluppatore. |
| Ambiente | Un contesto di esecuzione di runtime per le API. Un'API deve essere sottoposta a deployment in un ambiente prima di essere accessibile in fase di runtime. Per impostazione predefinita, le organizzazioni Apigee vengono sottoposte a provisioning con due ambienti: 'test' e 'prod'. L'ambiente "test" viene in genere utilizzato per il deployment API in fase di test. L'ambiente "prod" viene in genere utilizzato per il deployment delle API per l' utilizzo in produzione. |
| Modello fiscale ibrido | Un modello fiscale in cui il fornitore di API agisce come agente dichiarato dello sviluppatore. Tuttavia, il fornitore di API paga le imposte sulle vendite raccolte da i suoi 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 | Un componente dei servizi per sviluppatori di Apigee Edge che fornisce un modo semplice e flessibile per monetizzare i prodotti API. |
| Importo mensile utilizzato | L'utilizzo totale di uno sviluppatore per un determinato mese, che include la tariffa di configurazione + la commissione di transazione + la tariffa ricorrente. |
| Pagamenti mensili | I pagamenti ricorrenti effettuati da uno sviluppatore in base ai piani acquistati. I piani tariffari possono prevedere una tariffa ricorrente addebitata a uno sviluppatore ogni mese, indipendentemente dall'utilizzo. |
| Documento di compensazione | Un documento finanziario che mostra i saldi netti tra le fatture e i documenti di condivisione delle entrate. |
| Aggiustamento aperto | Un aggiustamento che non è ancora stato applicato nei documenti di fatturazione pubblicati. |
| Mese di fatturazione aperto | Un mese di calendario completo per il quale non sono stati pubblicati i documenti di fatturazione "finali". |
| Organizzazione | Un contenitore per tutti gli oggetti nel tuo account Apigee, tra cui API, prodotti API, API packages, app e sviluppatori. Per ogni organizzazione di cui potresti essere membro è necessario un account utente. La maggior parte degli utenti avrà un account in una sola organizzazione. Devi fornire le tue credenziali (nome utente e password) e il nome della tua organizzazione con ogni richiesta API che invii. |
| Catalogo dei pacchetti | Un elenco di pacchetti API. Ogni pacchetto è elencato con i relativi prodotti API e piani tariffari |
| Saldo prepagato | Un importo di denaro disponibile per uno sviluppatore prepagato per pagare in anticipo i pacchetti API |
| Sviluppatore prepagato | Uno sviluppatore che paga in anticipo l'utilizzo di un prodotto API. I fondi vengono detratti da un saldo sviluppatore prepagato quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per acquistare il prodotto API. Lo stato prepagato o postpagato viene assegnato agli sviluppatori dal fornitore di API. |
| Norme | Un passaggio di elaborazione che viene eseguito come unità di logica atomica e riutilizzabile all'interno di un flusso API Le norme tipiche includono l'instradamento delle richieste all'endpoint corretto, la trasformazione di un formato di messaggio, l'applicazione del controllo dell'accesso, la chiamata di servizi remoti per informazioni aggiuntive, la mascheratura dei dati sensibili per gli utenti esterni, l'esame dei contenuti dei messaggi per potenziali minacce, la memorizzazione nella cache delle risposte comuni per migliorare il rendimento e così via. Le norme possono essere eseguite in modo condizionale in base al contenuto o al contesto di un messaggio di richiesta o risposta. Ad esempio, è possibile eseguire una norma di trasformazione per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone. |
| Sviluppatore postpagato | Uno sviluppatore a cui viene fatturato mensilmente (tramite fattura) l'utilizzo dei prodotti API. Lo sviluppatore paga l'utilizzo dei prodotti API in base ai termini di pagamento impostati dai piani inclusi nella fattura. Lo stato postpagato o prepagato viene assegnato agli sviluppatori dal fornitore di API provider. |
| Prezzi consigliati | Una serie di prezzi possibili a cui un prodotto potrebbe essere commercializzato. |
| Piano tariffario con tariffario | Un piano tariffario in cui allo sviluppatore viene addebitata una tariffa fissa o variabile per ogni transazione che coinvolge un prodotto API monetizzato. |
| Piano tariffario | Una specifica delle tariffe, degli altri addebiti e della condivisione delle entrate per l'utilizzo dei prodotti API offerti in un pacchetto API monetizzato. |
| Risorsa percorso |
Un concetto RESTful, un percorso della risorsa è un URI (Uniform Resource Identifier) che identifica il percorso di rete di una determinata risorsa. |
| Piano tariffario di condivisione delle entrate | Un piano tariffario in cui una percentuale delle entrate generate da ogni transazione che coinvolge un prodotto API monetizzato viene condivisa con lo sviluppatore dell'app che emette la richiesta. |
| Piano tariffario con condivisione delle entrate e tariffario | Un piano tariffario in cui una percentuale delle entrate generate da ogni transazione che coinvolge un prodotto API monetizzato viene condivisa con lo sviluppatore dell'app che emette la richiesta. Allo sviluppatore viene addebitata anche una tariffa fissa o variabile per ogni transazione. |
| Fattura di autofatturazione | Un documento finanziario generato al posto di un documento di condivisione delle entrate. Specifica 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. |
| Imposta | L'imposta totale applicata all'utilizzo e alle tariffe di uno sviluppatore. |
| Ricarica | L'azione intrapresa da uno sviluppatore prepagato per aggiungere fondi al saldo prepagato. |
| Norma di registrazione delle transazioni | Un meccanismo che consente alla monetizzazione di acquisire parametri di transazione e attributi personalizzati attributi. La monetizzazione ha bisogno di queste informazioni per eseguire l'elaborazione della monetizzazione, ad esempio applicando i piani tariffari alle richieste e alle risposte API in base agli attributi personalizzati acquisiti in ogni transazione. |
| Agente non dichiarato | Un'organizzazione (o un operatore) che partecipa alla fornitura sottostante di applicazioni, in modo che sia considerata l'acquisto dei contenuti per conto dello sviluppatore (solo a fini fiscali solo). In qualità di agente non dichiarato, l'organizzazione (o l'operatore) può riscuotere e contabilizzare le imposte dovute dagli utenti finali. Questo stato è rilevante solo a fini fiscali: lo stato giuridico dello sviluppatore nella catena di fornitura non è interessato. |
| Modello fiscale non dichiarato | Un modello fiscale in cui il fornitore di API detrae l'imposta riscossa dagli utenti finali e paga 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 da "revisione", ovvero il pacchetto numerato e controllato dalla versione di configurazione e norme raggruppate in un proxy API. In breve, le interfacce API hanno versioni, mentre i proxy API hanno revisioni. |