Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
W Apigee jest kilka koncepcji, które są wspólnymi pomysłami o wyjątkowym znaczeniu.
| Termin | Definicja |
|---|---|
| Interfejs API | Proxy, które pełni funkcję fasady dla istniejącego interfejsu API. Zamiast wywoływać istniejący interfejs API, programiści zaczynają wywoływać nowy interfejs API wygenerowany przez Apigee. Ta fasada odłącza interfejs publiczny od interfejsu API na zapleczu, chroniąc programistów przed zmianami na zapleczu i umożliwiając Ci wprowadzanie innowacji na krawędzi bez wpływu na wewnętrzne zespoły programistów. Gdy wprowadzasz zmiany w systemie backendowym, deweloperzy nadal mogą korzystać z tego samego interfejsu API. W bardziej zaawansowanych scenariusach Apigee umożliwia udostępnianie wielu interfejsów tego samego interfejsu API, co pozwala na dostosowywanie sygnatury interfejsu API do potrzeb różnych nisz programistycznych jednocześnie. |
| Ścieżka i zasoby podstawowe interfejsu API | Interfejs API składa się z ścieżki podstawowej i zbioru zasobów (zwanych też ścieżkami zasobów). W przypadku każdego interfejsu API definiujesz 1 adres URL głównego i wiele ścieżek zasobów. Interfejs API możesz traktować jako zestaw identyfikatorów URI, które mają wspólną ścieżkę podstawową. Aby ułatwić zarządzanie interfejsami API, Apigee rozszerza te surowe identyfikatory URI o wyświetlane nazwy i opisy. |
| Konsument interfejsu API | Synonim „programisty aplikacji”, który używa interfejsów API utworzonych przez dostawcę interfejsu API. |
| Twórca interfejsu API | programista w organizacji dostawcy interfejsu API, który tworzy interfejsy API; Te interfejsy API są używane przez programistów aplikacji (użytkowników interfejsu API) do tworzenia aplikacji. |
| Pakiet interfejsu API | Kolekcja usług interfejsu API, które są prezentowane deweloperom jako pakiet i są zazwyczaj powiązane z planem cen. |
| Usługa API | Kolekcja zasobów interfejsu API (identyfikatorów URI) połączona z planem usługi i prezentowana deweloperom jako pakiet. Interfejs API może też zawierać metadane dotyczące Twojej firmy, które są potrzebne do monitorowania lub analizowania. Zarabianie na zasobach może polegać na uwzględnieniu ich w produkcie interfejsu API, który można następnie umieścić w pakiecie interfejsu API w celu zarabiania. |
| Dostawca interfejsu API | Dostawca interfejsu API tworzy interfejsy API (za pomocą Edge) na potrzeby użytkowników interfejsu API (programistów aplikacji). |
| deweloper aplikacji | W Edge deweloperzy aplikacji rejestrują swoje aplikacje u dostawcy interfejsu API, aby uzyskać klucze interfejsu API potrzebne do wywołania serwerów proxy interfejsu API dostawcy. |
| aplikacji | Twoi programiści używają aplikacji do uzyskiwania dostępu do zasobów w Twoich usługach API. Podczas tworzenia aplikacji wybierasz produkt interfejsu API, który 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 umożliwiają kontrolowanie, kto może korzystać z Twoich zasobów. Możesz kontrolować, kto ma dostęp do Twoich usług interfejsu API, odwołując i odświeżając klucz aplikacji. Możesz też kontrolować dostęp do pakietów zasobów, odwołując lub usuwając dostęp do produktów w aplikacji. |
| Szczegóły salda | W przypadku dewelopera korzystającego z przedpłaconego abonamentu saldo na jego koncie. |
| sfinalizowane dostosowanie | korekta zastosowana w opublikowanych dokumentach rozliczeniowych. |
| zamknięty miesiąc rozliczeniowy | Pełny miesiąc kalendarzowy, w którym zostały opublikowane dokumenty rozliczeniowe. |
| limit niestandardowy | Limit (np. limit liczby transakcji w usłudze interfejsu API), który możesz skonfigurować za pomocą zarabiania. Inna nazwa to limit dokładny. |
| Plan stawek dla deweloperów | Plan cen, który obowiązuje wszystkich deweloperów w konkretnej kategorii i jest dostępny do zakupu przez wszystkich deweloperów w tej kategorii. |
| plan stawek dla deweloperów | Plan cen, który obowiązuje w przypadku konkretnego dewelopera i jest dostępny do zakupu tylko przez tego dewelopera. |
| ujawniony agent | W prawie handlowym osoba upoważniona do działania w imieniu innej osoby (zwanej „mocodawcą”) w celu nawiązania stosunku prawnego z osobą trzecią. W ramach zarabiania możesz skonfigurować model podatkowy w planie współdzielonych przychodów, aby dostawca interfejsu API działał jako agent dewelopera, który zbiera przychody (i ewentualnie podatki od sprzedaży) w imieniu dewelopera. |
| ujawniony model podatkowy | Model podatkowy, w którym dostawca interfejsu API działa jako wyznaczony agent dewelopera. |
| środowisko | Kontekst wykonywania interfejsów API. Zanim interfejs API będzie dostępny w czasie wykonywania, musi zostać wdrożony do środowiska. Domyślnie organizacje w Apigee są konfigurowane z 2 środowiskami: „test” i „prod”. Środowisko „test” jest zwykle używane do wdrażania interfejsów API, które są testowane. Środowisko „prod” jest zwykle używane do wdrażania interfejsów API na potrzeby produkcji. |
| hybrydowy model podatkowy | Model podatkowy, w którym dostawca interfejsu API działa jako wyznaczony agent dewelopera. Jednak dostawca interfejsu API płaci podatek od sprzedaży pobrany od subskrybentów lokalnym organom podatkowym w imieniu dewelopera. |
| niejawny limit | Limit (np. limit salda przedpłaconego dewelopera) ustawiony przez zarabianie. |
| zarabianie | Komponent usług dla programistów Apigee Edge, który zapewnia łatwy i elastyczny sposób na zarabianie na usługach API. |
| miesięczna wykorzystana kwota | Łączna liczba minut wykorzystanych przez dewelopera w danym miesiącu, która obejmuje opłatę za konfigurację + opłatę za transakcję + opłatę cykliczną. |
| płatności miesięczne | Płatności cykliczne dokonywane przez dewelopera na podstawie zakupionych abonamentów. Opłaty abonamentowe mogą mieć opłaty cykliczne naliczane deweloperowi co miesiąc niezależnie od wykorzystania. |
| oświadczenie o zwrotach | Dokument finansowy przedstawiający salda netto między fakturami a zestawieniami przychodów. |
| otwórz ustawienia | Korekta, która nie została jeszcze zastosowana w opublikowanych dokumentach rozliczeniowych. |
| otwórz miesiąc rozliczeniowy | Pełny miesiąc kalendarzowy, w którym nie zostały opublikowane „ostateczne” dokumenty rozliczeniowe. |
| organizacja | Kontenery dla wszystkich obiektów na koncie Apigee, w tym interfejsów API, produktów interfejsów API, pakietów interfejsów API, aplikacji i deweloperów. W przypadku każdej organizacji, której jesteś członkiem, wymagane jest konto użytkownika. (większość użytkowników będzie mieć konto tylko w jednej organizacji). Musisz podać swoje dane logowania (nazwę użytkownika i hasło) oraz nazwę organizacji w każdym żądaniu interfejsu API, które przesyłasz. |
| katalog pakietów | Lista pakietów interfejsu API. Każdy pakiet jest wymieniony wraz z interfejsami API i taryfami. |
| saldo z przedpłaty | Kwota pieniędzy dostępna dla dewelopera korzystającego z abonamentu przedpłaconego na opłacenie z góry pakietów interfejsu API. |
| programista przedpłaconego | deweloper, który płaci z wyprzedzeniem za korzystanie z interfejsu API; Środki są odliczane od salda dewelopera korzystającego z abonamentu przedpłaconego, gdy używa on interfejsu API. Deweloperzy muszą mieć saldo przedpłacone wystarczające na zakup produktu API. Deweloperom przypisuje się stan przedpłacony lub abonamentowy przez dostawcę interfejsu API. |
| zasady | Krok przetwarzania, który jest wykonywany jako niepodzielny, wielokrotnie użyteczny element logiki w ramach przepływu interfejsu API. Typowe zasady obejmują kierowanie żądań do odpowiedniego punktu końcowego, przekształcanie formatu wiadomości, egzekwowanie kontroli dostępu, wywoływanie usług zdalnych w celu uzyskania dodatkowych informacji, maskowanie poufnych danych przed użytkownikami zewnętrznymi, sprawdzanie treści wiadomości pod kątem potencjalnych zagrożeń, buforowanie typowych odpowiedzi w celu poprawy wydajności itp. Zasady mogą być warunkowo wykonywane na podstawie treści lub kontekstu żądania lub odpowiedzi. Jeśli wiadomość z prośbą została wysłana ze smartfona, może zostać wykonana zasada przekształcenia w celu dostosowania formatu odpowiedzi. |
| programista postpaid | deweloper, który otrzymuje miesięczne faktury (za pośrednictwem faktury) za korzystanie z usług interfejsu API; Deweloperzy płacą za korzystanie z produktów API na podstawie warunków płatności określonych w planach uwzględnionych na fakturze. Dostawca interfejsu API przypisuje deweloperom stan abonamentu postpaid lub prepaid. |
| pułapy cenowe | Zakres możliwych cen, za które można sprzedawać dany produkt. |
| plan dotyczący stawek w arkuszu stawek | Plan opłat, w którym deweloperowi jest naliczana stała lub zmienna stawka za każdą transakcję związaną z monetyzacją produktu API. |
| taryfa | Specyfikacja opłat, innych opłat i udziału w przychodach za korzystanie z produktów interfejsu API oferowanych w pakiecie z możliwością zarabiania. |
| ścieżka zasobu |
Ścieżka zasobu to koncepcja RESTful, która jest identyfikatorem URI (Uniform Resource Identifier) wskazujący ścieżkę sieciową do danego zasobu. |
| plan udziału w przychodach | Plan stawek, w którym procent przychodów wygenerowanych z każdej transakcji dotyczącej produktu zarabiającego na interfejsie API jest dzielony z deweloperem aplikacji, która wysyła żądanie. |
| udział w przychodach i plan dotyczący stawek | Plan stawek, w którym procent przychodów wygenerowanych z każdej transakcji dotyczącej produktu zarabiającego na interfejsie API jest dzielony z deweloperem aplikacji, która wysyła żądanie. Deweloperowi jest też naliczana stała lub zmienna opłata za każdą transakcję. |
| faktura samoobsługowa | Dokument finansowy generowany zamiast oświadczenia o udziale w przychodach. Zawiera ona szczegóły kwoty należnej deweloperowi i działa jako faktura dla dostawcy interfejsu API w imieniu dewelopera. |
| plan o standardowej stawce | Pakiet cen, który mogą kupić wszyscy deweloperzy. |
| tax | Łączny podatek naliczany za korzystanie z usługi i opłaty dla dewelopera. |
| doładowanie | Działanie podjęte przez dewelopera w celu dodania środków do salda przedpłaconego. |
| zasady rejestrowania transakcji | Mechanizm, który umożliwia zarabianiu rejestrowanie parametrów transakcji i atrybutów niestandardowych. Funkcja zarabiania potrzebuje tych informacji do przetwarzania zarabiania, takich jak stosowanie planów cenowych do żądań i odpowiedzi interfejsu API na podstawie atrybutów niestandardowych zarejestrowanych w każdej transakcji. |
| nieujawniony agent | Organizacja (lub operator) uczestnicząca w dostarczaniu aplikacji, która jest uznawana za kupującego treści w imieniu dewelopera (tylko na potrzeby podatkowe). Jako nieujawniony agent organizacja (lub operator) może pobierać podatki od użytkowników i rozliczać z nich należne kwoty. Ten stan ma znaczenie tylko na potrzeby podatkowe – nie ma wpływu na status prawny dewelopera w łańcuchu dostaw. |
| nieujawniony model podatkowy | Model podatkowy, w którym dostawca interfejsu API odlicza podatek od użytkowników i wnosi go do lokalnych organów podatkowych. |
| wersja | Wersja interfejsu API dla deweloperów. Na przykład pivotaltracker.com/services/v3 lub api.enterprise.apigee.com/v1. (Ten termin odróżnia się od terminu „wersja”, który oznacza numerowane pakiety z konfiguracją i zasadami kontrolowanymi przez wersję, które są połączone z proxy interfejsu API). Krótko mówiąc, interfejsy API mają wersje, a proxy interfejsów API mają wersje. |