Glossar

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an.
info

Es gibt verschiedene Konzepte, die allgemeine Ideen mit einer einzigartigen Bedeutung in Apigee sind.

Begriff Definition
API Ein Proxy, der als Fassade für Ihre vorhandene API fungiert. Anstatt Ihre vorhandene API aufzurufen, beginnen Entwickler mit dem Aufruf der neuen API, die von Apigee generiert wurde. Diese Fassade entkoppelt Ihre öffentliche Schnittstelle von Ihrer Back-End-API, schützt Entwickler vor Back-End-Änderungen und ermöglicht Ihnen die innovative Nutzung von Edge-Punkten, ohne dass Ihre internen Entwicklungsteams dadurch beeinträchtigt werden. Wenn Sie Änderungen am Back-End vornehmen, rufen Entwickler dieselbe API weiterhin ohne Unterbrechung auf. In komplexeren Szenarien können Sie mit Apigee mehrere Schnittstellen für dieselbe API freigeben, sodass Sie die Signatur einer API so anpassen können, dass sie gleichzeitig den Anforderungen verschiedener Entwicklernischen entspricht.
API-Basispfad und Ressourcen Eine API besteht aus dem Basispfad und einer Reihe von Ressourcen (auch Ressourcenpfade genannt). Sie definieren für jede API eine einzelne Stamm-URL und mehrere Ressourcenpfade. Sie können sich eine API einfach als eine Gruppe von URIs vorstellen, die alle einen gemeinsamen Basispfad haben. Um die Verwaltung Ihrer APIs zu vereinfachen, erweitert Apigee diese Roh-URIs durch Anzeigenamen und Beschreibungen.
API-Nutzer Synonym für "App-Entwickler", der die von einem API-Anbieter erstellten APIs verwendet.
API-Entwickler Softwareentwickler in einer Organisation des API-Anbieters, der APIs erstellt. Diese APIs werden von Anwendungsentwicklern (API-Nutzern) zum Erstellen von Anwendungen verwendet.
API-Paket Eine Sammlung von API-Produkten, die Entwicklern als Paket angeboten und typischerweise mit einem Tarif verknüpft sind.
API-Produkt Eine Sammlung von API-Ressourcen (URIs) in Kombination mit einem Serviceplan, die Entwicklern als Set präsentiert wird. Das API-Produkt kann außerdem einige für Ihr Unternehmen spezifische Metadaten für Monitoring oder Analysen enthalten. Sie können eine oder mehrere Ressourcen monetarisieren, indem Sie sie in ein API-Produkt einbinden. Dieses kann dann zur Monetarisierung in einem API-Paket gebündelt werden.
API-Anbieter Ein API-Anbieter erstellt APIs (mit Edge) für API-Nutzer (App-Entwickler).
App-Entwickler In Edge registrieren App-Entwickler ihre Apps bei einem API-Anbieter. Dadurch erhalten App-Entwickler die API-Schlüssel, die sie zum Aufrufen der API-Proxys des Anbieters benötigen.
Anwendungen Ihre Entwickler verwenden Apps, um auf die Ressourcen in Ihren API-Produkten zuzugreifen. Wenn Sie eine Anwendung erstellen, wählen Sie das API-Produkt aus, das Sie hinzufügen möchten, und Apigee generiert einen Schlüssel. Jede Anwendung hat einen einzelnen Schlüssel, der Zugriff auf mehrere API-Produkte bietet. Mit Anwendungen können Sie steuern, wer auf Ihre Ressourcen zugreifen kann. Sie können steuern, wer Zugriff auf Ihre API-Produkte hat, indem Sie den Schlüssel einer Anwendung widerrufen und aktualisieren. Außerdem können Sie den Zugriff auf Ressourcenpakete steuern, indem Sie den Zugriff auf die Produkte in einer Anwendung widerrufen oder löschen.
Kontostandinformationen Bei einem Prepaid-Entwicklerguthaben ist das Guthaben im Konto des Entwicklers.
Geschlossene Anpassung Eine Anpassung, die in veröffentlichten Abrechnungsdokumenten angewendet wurde.
Geschlossener Abrechnungsmonat Ein vollständiger Kalendermonat, für den Fakturierungsdokumente veröffentlicht wurden.
Benutzerdefiniertes Limit Ein Limit (z. B. ein Limit für die Anzahl der Transaktionen bei einem API-Produkt), das Sie explizit über die Monetarisierung einrichten können. Wird auch als explizites Limit bezeichnet.
Rate der Entwicklerkategorie Tarif, der für alle Entwickler einer bestimmten Kategorie gilt und für alle Entwickler dieser Kategorie zum Kauf zur Verfügung steht.
Rate für Entwickler Ein Tarif, der für einen bestimmten Entwickler gilt und nur von diesem Entwickler erworben werden kann.
Nicht abgeschlossener Agent Im kommerziellen Recht hat eine Person, die berechtigt ist, im Auftrag einer anderen Person (als Hauptkonto bezeichnet) eine rechtliche Beziehung zu einem Drittanbieter aufzubauen. In der Monetarisierung kann ein Steuermodell für einen gemeinsamen Umsatzplan eingerichtet werden, sodass der API-Anbieter als determinierter Agent des Entwicklers agiert, um Einnahmen (und möglicherweise Verkaufssteuern) im Namen des Entwicklers einzuziehen.
Geschlossenes Steuermodell Ein Steuermodell, bei dem der API-Anbieter als determinierter Agent des Entwicklers fungiert.
Umgebung Laufzeitkontext für APIs Eine API muss in einer Umgebung bereitgestellt werden, bevor sie zur Laufzeit aufgerufen werden kann. Standardmäßig werden Apigee-Organisationen mit zwei Umgebungen bereitgestellt: "test" und "prod". Die "Testumgebung" wird normalerweise zum Bereitstellen von getesteten APIs verwendet. Die "Prod"-Umgebung wird in der Regel zum Bereitstellen von APIs für die Produktion verwendet.
Hybrides Steuermodell Ein Steuermodell, bei dem der API-Anbieter als determinierter Agent des Entwicklers fungiert. Der API-Anbieter zahlt jedoch die von seinen Abonnenten erhobene Umsatzsteuer im Namen des Entwicklers an die lokalen Steuerbehörden.
Implizites Limit Ein von der Monetarisierung festgelegtes Limit für die Entwicklerabrechnung
Monetarisierung Eine Komponente der Apigee Edge-Entwicklerdienste, die eine benutzerfreundliche und flexible Möglichkeit zur Monetarisierung von API-Produkten bietet.
Verwendeter monatlicher Betrag Die Gesamtnutzung eines Entwicklers für einen bestimmten Monat, die Einrichtungsgebühr + Transaktionsgebühr + wiederkehrende Gebühr umfasst.
Monatliche Zahlung Die wiederkehrenden Zahlungen eines Entwicklers, der auf den erworbenen Plänen basiert. Bei Tarifpaketen kann einem Anbieter für jeden Monat eine wiederkehrende Gebühr anfallen, unabhängig von der Nutzung.
Netzwerkanweisung Ein Finanzdokument, das die Nettoguthaben zwischen Rechnungen und Ertragsausgleichsaufstellungen zeigt.
Offene Anpassung Eine Anpassung, die in veröffentlichten Abrechnungsdokumenten noch nicht angewendet wurde.
Monat der offenen Abrechnung Ein vollständiger Kalendermonat, für den "finale" Abrechnungsdokumente nicht veröffentlicht wurden.
Organisation Ein Container für alle Objekte in Ihrem Apigee-Konto, einschließlich APIs, API-Produkten, API-Paketen, Anwendungen und Entwicklern. Für jede Organisation, der Sie angehören können, ist ein Nutzerkonto erforderlich. Die meisten Nutzer haben nur ein Konto in nur einer Organisation. Sie müssen bei jeder übermittelten API-Anfrage Ihre Anmeldedaten (Nutzername und Passwort) und den Namen Ihrer Organisation angeben.
Paketkatalog Eine Liste der API-Pakete Jedes Paket wird mit seinen API-Produkten und Tarifen aufgelistet.
Prepaid-Guthaben Ein Geldbetrag, den ein im Voraus bezahlter Entwickler für API-Pakete im Voraus bezahlen kann.
Prepaid-Entwickler Ein Entwickler, der im Voraus für die Nutzung eines API-Produkts bezahlt. Die Verwendung des API-Produkts wird vom Guthaben eines Prepaid-Entwicklers abgezogen. Der Entwickler muss über ein Vorauszahlungsguthaben verfügen, das zum Kauf des API-Produkts ausreicht. Entwickler erhalten vom API-Anbieter einen Prepaid- oder Postpaid-Status.
Richtlinie Ein Verarbeitungsschritt, der als atomare, wiederverwendbare Logikeinheit innerhalb eines API-Ablaufs ausgeführt wird. Typische Richtlinien sind Routinganfragen an den richtigen Endpunkt, die Umwandlung eines Nachrichtenformats, die Durchsetzung der Zugriffssteuerung, das Aufrufen von Remotediensten für zusätzliche Informationen, das Maskieren sensibler Daten von externen Nutzern, das Prüfen von Nachrichteninhalten auf potenzielle Bedrohungen, Caching allgemeiner Antworten zur Verbesserung der Leistung usw. Richtlinien können basierend auf dem Inhalt oder Kontext einer Anfrage oder Antwortnachricht bedingt ausgeführt werden. Zum Beispiel kann eine Transformationsrichtlinie ausgeführt werden, um ein Antwortformat anzupassen, wenn die Anfragenachricht von einem Smartphone gesendet wurde.
Postpaid-Entwickler Ein Entwickler, der die Nutzung von API-Produkten monatlich in Rechnung stellt. Der Entwickler bezahlt für die Nutzung von API-Produkten basierend auf den Zahlungsbedingungen, die in den auf der Rechnung enthaltenen Tarifen angegeben sind. Entwickler werden vom API-Anbieter nach Postpaid- oder Prepaid-Status zugewiesen.
Preise Eine Reihe möglicher Preise, an denen ein Produkt angeboten werden kann.
Preislistenplan Tarif, bei dem dem Entwickler für jede Transaktion mit einem monetarisierten API-Produkt ein fester oder variablen Preis berechnet wird.
Preismodell Eine Beschreibung der Gebühren, anderer Gebühren und Umgebungsvariablen für die Verwendung von API-Produkten, die in einem Monetarisierungs-API-Paket angeboten werden.
Ressourcenpfad
Ein RESTful-Konzept ist ein einheitlicher Ressourcenpfad (URI), der den Netzwerkpfad zu einer bestimmten Ressource identifiziert.
Tarif mit Umsatzbeteiligung Ein Tarifplan, bei dem ein Prozentsatz des Umsatzes, der mit einer Transaktion mit einem monetarisierten API-Produkt generiert wurde, an den Entwickler der Anwendung weitergegeben wird, von der die Anfrage stammt.
Umsatzbeteiligung und Preislisten Ein Tarifplan, bei dem ein Prozentsatz des Umsatzes, der mit einer Transaktion mit einem monetarisierten API-Produkt generiert wurde, an den Entwickler der Anwendung weitergegeben wird, von der die Anfrage stammt. Außerdem wird dem Entwickler für jede Transaktion eine feste oder variable Gebühr berechnet.
Rechnung mit eigener Abrechnung Ein Finanzdokument, das anstelle einer Umsatzbeteiligung erstellt wird. Sie enthält den dem Entwickler geschuldeten Betrag und fungiert als Rechnung an den API-Anbieter im Namen des Entwicklers.
Standardtarif Ein Tarif, der von allen Entwicklern gekauft werden kann.
Steuer Gesamtsteuer, der auf die Nutzung und Gebühren eines Entwicklers angewendet wird.
Mitgliedschaft verlängern Die Aktion eines Prepaid-Entwicklers, um Guthaben auf das Vorauszahlungsguthaben zu übertragen.
Richtlinie zur Transaktionsaufzeichnung Ein Mechanismus, der Monetarisierung ermöglicht, um Transaktionsparameter und benutzerdefinierte Attribute zu erfassen. Für die Monetarisierung sind diese Informationen erforderlich, um die Monetarisierung abzuwickeln, z. B. Anwenden von Ratenplänen auf API-Anfragen und -Antworten basierend auf den benutzerdefinierten Attributen, die bei jeder Transaktion erfasst werden.
Nicht determinierter Agent Eine Organisation (oder ein Operator), die (der) an der zugrunde liegenden Bereitstellung von Anwendungen beteiligt ist, deren Bereitstellung dem Kauf des Inhalts im Namen des Entwicklers (nur zu Steuerzwecken) entspricht. Als nicht determinierter Agent kann die Organisation (oder der Operator) Steuern von Endnutzern erheben und berücksichtigen. Dieser Status ist nur für Steuerzwecke relevant. Der rechtliche Status des Entwicklers in der Lieferkette ist davon nicht betroffen.
Nicht offengelegtes Steuermodell Ein Steuermodell, bei dem der API-Anbieter die von den Endnutzern erfassten Steuern abrechnet und an die lokalen Finanzamt zahlt.
Version Die Version der API-Schnittstelle für Entwickler. Beispiel: pivotaltracker.com/services/v3, oder api.enterprise.apigee.com/v1. Dieser Begriff unterscheidet sich von "Revision", dem nummerierten, versionierten Paket mit Konfigurations- und Richtlinienrichtlinien eines API-Proxys. Kurz gesagt, API-Schnittstellen haben Versionen, während API-Proxys Revisionen haben.