Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
In Apigee esistono diversi concetti che sono idee comuni con un significato unico.
| Termine | Definizione |
|---|---|
| API | Un proxy che funge da facade per la tua API esistente. Anziché chiamare la tua API esistente, gli sviluppatori iniziano a chiamare la nuova API generata da Apigee. Questa facciata disaccoppia l'interfaccia pubblica dall'API di backend, proteggendo gli sviluppatori dalle modifiche al backend, ma consente al contempo di innovare all'edge senza influire sui team di sviluppo interni. Mentre 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, liberandoti di personalizzare la firma di un'API per soddisfare contemporaneamente le esigenze di varie nicchie di sviluppatori. |
| Percorso di base dell'API e risorse | Un'API è costituita dal percorso base e da un insieme di risorse (noto anche come percorsi risorse). Per ogni API, definisci un singolo URL principale e più percorsi delle risorse. Puoi considerare un'API semplicemente come un insieme di URI, che condividono tutti un percorso di base comune. Per semplificare la gestione delle API, Apigee integra questi URI non elaborati con nomi visualizzati e descrizioni. |
| Consumer 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 provider 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 tipicamente associati a un piano tariffario. |
| Prodotto API | Una raccolta di risorse API (URI) combinate con un piano di servizio e presentata agli sviluppatori come un pacchetto. Il prodotto API può includere anche alcuni metadati specifici per la tua attività per il monitoraggio o le analisi. Una o più risorse possono essere monetizzate includendole in un prodotto API, che può essere raggruppato in un pacchetto API per la monetizzazione. |
| Fornitore di API | Un fornitore di API crea API (utilizzando Edge) per i relativi consumatori (sviluppatori di app). |
| sviluppatore di app | In Edge, gli sviluppatori di app registrano le loro app con un provider API, in modo da ottenere le chiavi API necessarie per chiamare i proxy API del provider. |
| app | Gli sviluppatori utilizzano le app per accedere alle risorse dei 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 ha accesso ai tuoi 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 abbonamento prepagato, il saldo dell'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 (ad esempio 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 sviluppatore | 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 della categoria in questione. |
| piano tariffario per gli sviluppatori | Un piano tariffario che si applica a uno sviluppatore specifico ed è disponibile per l'acquisto solo da parte di quel sviluppatore. |
| agente divulgato | Nel diritto commerciale, una persona autorizzata ad agire per conto di un'altra (chiamata mandante) per creare un rapporto giuridico con una terza parte. In 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 divulgato | Un modello fiscale in cui il fornitore dell'API agisce come agente dichiarato dello sviluppatore. |
| ambiente | Un contesto di esecuzione del runtime per le API. Un'API deve essere dispiata in un ambiente prima di poter essere acceduta in fase di runtime. Per impostazione predefinita, per le organizzazioni Apigee viene eseguito il provisioning di due ambienti: "test" e "prod". L'ambiente "test" viene in genere utilizzato per il deployment delle API in fase di test. L'ambiente "prod" viene in genere utilizzato per il deployment delle API per l'uso in produzione. |
| modello fiscale ibrido | Un modello fiscale in cui il fornitore dell'API agisce come agente dichiarato dello sviluppatore. Tuttavia, il fornitore dell'API paga l'imposta sulle vendite riscossa dagli abbonati alle autorità fiscali locali per conto dello sviluppatore. |
| limite implicito | Un limite (ad esempio un limite di saldo prepagato dello sviluppatore) impostato dalla monetizzazione. |
| monetization | Un componente dei servizi per sviluppatori Apigee Edge che offre 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 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 commissione ricorrente addebitata a uno sviluppatore ogni mese, indipendentemente dall'utilizzo. |
| estratto conto di compensazione | Un documento finanziario che mostra i saldi netti tra le fatture e gli estratti conto della quota di condivisione delle entrate. |
| apri aggiustamento | Un aggiustamento che non è stato ancora applicato nei documenti di fatturazione pubblicati. |
| open billing month | Un mese di calendario completo per il quale non sono stati pubblicati documenti di fatturazione "finali". |
| organizzazione | Un contenitore per tutti gli oggetti del tuo account Apigee, tra cui API, prodotti API, pacchetti API, app e sviluppatori. È necessario un account utente per ogni organizzazione di cui potresti essere membro. 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 inviata. |
| 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 da pagare in anticipo per i pacchetti di API. |
| sviluppatore con abbonamento prepagato | Uno sviluppatore che paga in anticipo per l'utilizzo di un prodotto API. I fondi vengono detratti dal saldo di uno sviluppatore con pagamento prepagato quando viene utilizzato il prodotto API. Lo sviluppatore deve mantenere un saldo prepagato sufficiente per acquistare il prodotto API. Gli sviluppatori vengono assegnati allo stato prepagato o postpaid dal fornitore dell'API. |
| norme | Un passaggio di elaborazione che viene eseguito come unità di logica atomica e riutilizzabile all'interno di un flusso dell'API. I criteri tipici includono l'indirizzamento delle richieste all'endpoint appropriato, la trasformazione di un formato di messaggio, l'applicazione del controllo dell'accesso, la chiamata di servizi remoti per ulteriori informazioni, il mascheramento di dati sensibili da 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 postpaid | Uno sviluppatore a cui viene addebitato mensilmente (tramite una fattura) l'utilizzo di prodotti basati su API. Lo sviluppatore paga l'utilizzo dei prodotti API in base ai termini di pagamento impostati dai piani inclusi nella fattura. Lo stato postpaid o prepagato viene assegnato agli sviluppatori dal fornitore dell'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 che coinvolge un prodotto API monetizzato. |
| piano tariffario | Una specifica delle commissioni, di altri addebiti e della quota di condivisione delle entrate per l'utilizzo dei prodotti basati su API offerti in un pacchetto API monetizzato. |
| percorso della risorsa |
Un concetto RESTful, un percorso della risorsa è un URI (Uniform Resource Identifier) che identifica il percorso di rete di una determinata risorsa. |
| piano di tariffe per la quota 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. |
| quota di condivisione delle entrate e piano 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 inoltre addebitata una commissione fissa o variabile per ogni transazione. |
| Fattura con autofatturazione | Un documento finanziario generato anziché una dichiarazione relativa alla 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 acquistabile da tutti gli sviluppatori. |
| tax | Imposte totali applicate all'utilizzo e alle commissioni di uno sviluppatore. |
| ricarica | L'azione intrapresa da uno sviluppatore prepagato per aggiungere fondi al saldo prepagato. |
| norme relative alla registrazione delle transazioni | Un meccanismo che consente alla monetizzazione di acquisire parametri di transazione e attributi personalizzati. La monetizzazione ha bisogno di queste informazioni per eseguire il proprio trattamento, ad esempio l'applicazione di piani tariffari alle richieste e alle risposte dell'API in base agli attributi personalizzati acquisiti in ogni transazione. |
| agente non divulgato | Un'organizzazione (o un operatore) che partecipa alla fornitura sottostante delle applicazioni, in modo da essere considerata come acquirente dei contenuti per conto dello sviluppatore (solo ai fini fiscali). In qualità di agente non divulgato, l'organizzazione (o l'operatore) può raccogliere e registrare le imposte dovute dagli utenti finali. Questo stato è rilevante solo ai fini fiscali: lo stato legale dello sviluppatore nella catena di approvvigionamento rimane invariato. |
| modello fiscale non divulgato | Un modello fiscale in cui il fornitore dell'API detrae l'imposta riscossa dagli utenti finali e paga le 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 è distinto da "revisione", che è il pacchetto numerato e controllato dalla versione di configurazione e criteri raggruppati in un proxy API. In breve, le interfacce API hanno versioni, mentre i proxy API hanno revisioni. |