Słownik

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
informacje.

W Apigee jest kilka wspólnych koncepcji o unikalnym znaczeniu.

Termin Definicja
Interfejs API Serwer proxy, który pełni funkcję pokrywy do istniejącego interfejsu API. Zamiast wywoływać istniejący interfejs API, deweloperzy zaczynają wywoływać nowy interfejs API wygenerowany przez Apigee. Taka fasada oddziela interfejs publiczny od interfejsu API backendu, chroniąc programistów przed zmianami w backendzie, a jednocześnie umożliwia wprowadzanie innowacji na brzegu sieci bez wpływu na wewnętrzne zespoły programistów. Gdy wprowadzasz zmiany w backendzie, deweloperzy nadal będą wywoływać ten sam interfejs API bez przerw. W bardziej zaawansowanych scenariuszach Apigee umożliwia udostępnianie wielu interfejsów temu samemu interfejsowi API, dzięki czemu możesz dostosować podpis API pod kątem spełniania potrzeb różnych niszowych programistów jednocześnie.
Ścieżka bazowa i zasoby interfejsu API Interfejs API składa się ze ścieżki podstawowej i zbioru zasobów (nazywanych też ścieżkami zasobów). Dla każdego interfejsu API definiujesz jeden główny adres URL i wiele ścieżek zasobów. Interfejs API można wyobrazić sobie jako zbiór identyfikatorów URI, których wszystkie mają wspólną ścieżkę podstawową. Aby ułatwić zarządzanie interfejsami API, Apigee uzupełnia nieprzetworzone identyfikatory URI o wyświetlane nazwy i opisy.
Konsument interfejsu API Synonim „deweloper aplikacji” korzystający z interfejsów API utworzonych przez dostawcę interfejsu API.
Deweloper interfejsów API Inżynier oprogramowania w organizacji dostawcy interfejsów API, który tworzy interfejsy API. Te interfejsy API są używane przez deweloperów aplikacji (konsumentów interfejsu API) do tworzenia aplikacji.
Pakiet API Kolekcja usług API prezentowanych deweloperom w postaci pakietu i zwykle powiązanych z abonamentem.
Usługa API Zbiór zasobów interfejsu API (identyfikatorów URI) połączonych z abonamentem i prezentowanych deweloperom w postaci pakietu. Usługa API może też zawierać metadane specyficzne dla Twojej firmy, które służą do monitorowania lub analizowania. Na co najmniej jednym zasobie można zarabiać, uwzględniając go w usłudze API, który można następnie połączyć w pakiet interfejsów API, na którym można zarabiać.
Dostawca interfejsu API Interfejsy API kompilacji dostawcy interfejsów API (z użyciem Edge), z których mogą korzystać użytkownicy interfejsu API (deweloperzy aplikacji).
deweloper aplikacji W Edge programiści aplikacji rejestrują swoje aplikacje u dostawcy interfejsów API. W ten sposób programiści uzyskują klucze interfejsu API potrzebne do wywoływania serwerów proxy API dostawcy.
aplikacje Deweloperzy korzystają z aplikacji, aby uzyskiwać dostęp do zasobów usług interfejsu API. Podczas tworzenia aplikacji wybierasz usługę API, którą chcesz uwzględnić, a Apigee generuje klucz. Każda aplikacja ma jeden klucz, który zapewnia dostęp do wielu usług interfejsu API. Aplikacje dają Ci kontrolę nad tym, kto może korzystać z Twoich zasobów. Możesz unieważnić i odświeżyć klucz aplikacji, aby kontrolować, kto ma dostęp do Twoich usług API. Możesz też kontrolować dostęp do pakietów zasobów, anulując lub usuwając dostęp do usług w aplikacji.
szczegóły salda W przypadku dewelopera korzystającego z przedpłaty jest to saldo na koncie dewelopera.
korekta zamknięta Korekta, która została zastosowana w opublikowanych dokumentach rozliczeniowych.
zamknięty miesiąc rozliczeniowy Kompletny miesiąc kalendarzowy, za który opublikowano dokumenty rozliczeniowe.
limit niestandardowy Limit (na przykład limit liczby transakcji związanych z usługą API), który możesz skonfigurować bezpośrednio w usłudze zarabiania. Nazywa się je też wyraźnym limitem.
plan stawek według kategorii dewelopera Abonament, który dotyczy wszystkich deweloperów z określonej kategorii i można go kupić dla wszystkich deweloperów z tej kategorii.
plan stawek dewelopera Abonament, który dotyczy określonego dewelopera i może być dostępny tylko przez niego.
ujawniony agent W świetle prawa handlowego osoba, która jest upoważniona do występowania w imieniu innej osoby (zwanej zleceniodawcą) do nawiązywania relacji prawnej z osobą trzecią. W ramach zarabiania można skonfigurować model podatkowy dla wspólnego planu przychodów. W takim przypadku dostawca interfejsu API pełni funkcję ujawnionego agenta dewelopera, który będzie pobierać przychody (i ewentualnie podatki od sprzedaży) w imieniu dewelopera.
ujawniony model podatkowy Model podatkowy, w którym dostawca interfejsu API pełni funkcję ujawnionego agenta dewelopera.
środowisko Kontekst wykonania w środowisku wykonawczym dla interfejsów API. Aby można było uzyskać dostęp do interfejsu API w środowisku wykonawczym, trzeba go wdrożyć w środowisku. Domyślnie organizacje Apigee mają dostęp do 2 środowisk: „test” i „prod”. Środowisko „testowe” jest zwykle używane do wdrażania testowanych interfejsów API. Środowisko „prod” jest zwykle używane do wdrażania interfejsów API w środowisku produkcyjnym.
Hybrydowy model podatkowy Model podatkowy, w którym dostawca interfejsu API pełni funkcję ujawnionego agenta dewelopera. Jednak dostawca interfejsu API płaci w imieniu dewelopera podatek od sprzedaży pobrany od subskrybentów do lokalnego urzędu skarbowego.
limit niejawny limit (np. limit salda z przedpłaty dewelopera) ustalony przez funkcję zarabiania.
generowanie przychodu Komponent usług dla programistów Apigee Edge, który umożliwia łatwe w użyciu i elastyczne zarabianie na usługach API.
wykorzystana kwota miesięczna Łączne wykorzystanie przez dewelopera w danym miesiącu obejmujące opłatę konfiguracyjną, opłatę transakcyjną i opłatę cykliczną.
płatności miesięczne Płatności cykliczne dokonywane przez dewelopera na podstawie zakupionych pakietów. Abonamenty mogą być objęte cykliczną opłatą, którą deweloper jest obciążany co miesiąc niezależnie od użycia.
deklaracja dotycząca sieci Dokument finansowy przedstawiający salda netto między fakturami a raportami o udziale w przychodach.
otwórz korektę Korekta, która nie została jeszcze zastosowana w opublikowanych dokumentach rozliczeniowych.
miesiąc otwartego rozliczenia Kompletny miesiąc kalendarzowy, za który nie zostały opublikowane „ostateczne” dokumenty rozliczeniowe.
organizacja Kontener na wszystkie obiekty na Twoim koncie Apigee, w tym interfejsy API, usługi API, pakiety API, aplikacje i programistów. Konto użytkownika jest wymagane dla każdej organizacji, której możesz być członkiem. Większość użytkowników ma konta tylko w jednej organizacji. Przy każdym przesyłanym żądaniu do interfejsu API musisz podać swoje dane logowania (nazwę użytkownika i hasło) oraz nazwę organizacji.
katalog pakietów Lista pakietów interfejsu API. Każdy pakiet jest wymieniony z usługami interfejsu API i abonamentami.
saldo przedpłacone Kwota dostępna dla przedpłaconego dewelopera, który może zapłacić z góry za pakiety API.
deweloper przedpłaconych Programista, który płaci z góry za korzystanie z usługi API. Gdy korzystasz z usługi API, środki są odliczane od salda dewelopera korzystającego z przedpłaty. Deweloper musi utrzymywać saldo z przedpłaty wystarczające do zakupu usługi API. Stan przedpłacony lub abonamentowy jest przypisywany deweloperom przez dostawcę interfejsu API.
zasady Etap przetwarzania, który jest wykonywany jako atomowa jednostka logiczna wielokrotnego użytku w ramach przepływu interfejsu API. Typowe zasady obejmują kierowanie żądań do odpowiedniego punktu końcowego, zmianę formatu wiadomości, egzekwowanie kontroli dostępu, wywoływanie usług zdalnych w celu uzyskania dodatkowych informacji, maskowanie danych wrażliwych przed użytkownikami zewnętrznymi, badanie treści wiadomości pod kątem potencjalnych zagrożeń, buforowanie typowych odpowiedzi w celu zwiększenia wydajności itp. Zasady mogą być warunkowo wykonywane na podstawie treści lub kontekstu żądania lub wiadomości z odpowiedzią. Jeśli na przykład wiadomość z żądaniem została wysłana ze smartfona, może zostać uruchomiona zasada przekształcenia, aby dostosować format odpowiedzi.
programista opłacający abonament Jest deweloperem, który jest rozliczany co miesiąc (na podstawie faktury) za korzystanie z usług API. Deweloper płaci za korzystanie z usług API zgodnie z warunkami płatności określonymi w abonamentach uwzględnionych na fakturze. Deweloperzy mogą mieć przypisany stan płatności po wykonaniu usługi lub przedpłaconej przez dostawcę interfejsu API.
pułapy cenowe Zakres możliwych cen, w których produkt może być sprzedawany.
plan arkusza stawek Plan stawek, w którym deweloper płaci stałą lub zmienną stawkę za każdą transakcję dotyczącą usługi API generującej przychody.
abonament Specyfikacja opłat, innych obciążeń i udziału w przychodach za korzystanie z usług API oferowanych w pakiecie generującym przychody.
ścieżka
zasobu
Pojęcie typu REST oznacza, że ścieżka zasobu to identyfikator URI określający ścieżkę sieciową do danego zasobu.
plan stawek udziału w przychodach Plan stawek, w którym procent przychodów wygenerowanych z każdej transakcji z wykorzystaniem usługi API generującej przychody jest dzielony deweloperowi aplikacji, która wysłała żądanie.
udział w przychodach oraz plan w arkuszu stawek Plan stawek, w którym procent przychodów wygenerowanych z każdej transakcji z wykorzystaniem usługi API generującej przychody jest dzielony deweloperowi aplikacji, która wysłała żądanie. Deweloper płaci też stałą lub zmienną opłatę za każdą transakcję.
faktura rozliczana samodzielnie Dokument finansowy generowany zamiast sprawozdania z udziału w przychodach. Zawiera on szczegółowe informacje na temat kwoty należnej deweloperowi i stanowi fakturę dla dostawcy interfejsu API w imieniu dewelopera.
abonament standardowy Abonament dostępny dla wszystkich deweloperów.
tax Całkowity podatek naliczany od opłat za użytkowanie i opłaty dewelopera.
doładowanie Działanie wykonane przez programistę dokonującego przedpłaty, aby dodać środki do salda przedpłaty.
Zasady rejestrowania transakcji Mechanizm, który umożliwia generowanie przychodu z przechwytywanie parametrów transakcji i atrybutów niestandardowych. Te informacje są potrzebne do przetwarzania przychodów, na przykład do stosowania planów stawek do żądań i odpowiedzi interfejsu API na podstawie atrybutów niestandardowych rejestrowanych w każdej transakcji.
nieupoważniony agent Organizacja (lub operator), która zajmuje się dostarczaniem aplikacji, w taki sposób, że zostanie ona uznana za zakup treści w imieniu dewelopera (tylko w celach podatkowych). Jako nieujawniony agent organizacja (lub operator) może pobierać i rozliczać podatki należne od użytkowników. Ten stan ma znaczenie tylko do celów podatkowych – nie ma wpływu na status prawny dewelopera w łańcuchu dostaw.
Nieujawniony model podatkowy Model podatkowy, w którym dostawca interfejsu API odejmuje podatek pobierany od użytkowników i płaci go lokalnym urzędom podatkowym.
wersja Wersja interfejsu API dla programistów. Na przykład pivotaltracker.com/services/v3 lub api.enterprise.apigee.com/v1. Termin ten różni się od „wersji”, czyli ponumerowanego pakietu zawierającego konfigurację i zasady z kontrolą wersji wchodzące w skład serwera proxy interfejsu API. Krótko mówiąc, interfejsy API mają różne wersje, a serwery proxy interfejsów API mają różne wersje.