Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
We wtorek 2 czerwca 2015 r. udostępniliśmy nową wersję chmurową Apigee Edge.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Apigee Edge.
Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w informacjach o wersjach Apigee.
Nowe funkcje i ulepszenia
Oto nowe funkcje i ulepszenia w tej wersji.
Ogólna dostępność SmartDocs
SmartDocs wychodzi z wersji beta i staje się ogólnie dostępny. Aktualizacje i nowe funkcje obejmują:
- Obsługa Swaggera 2.0, w tym importowanie według pliku lub adresu URL, a także obsługa obiektów zabezpieczeń o niestandardowych nazwach.
- Ulepszenia projektu wizualnego w szablonach, które generują dokumenty Smart Docs.
- Ulepszenia dotyczące użyteczności i przepływu pracy w portalu dla deweloperów, dostępne w menu Treści > SmartDocs w Drupalu.
- Uwierzytelnianie za pomocą „tokena niestandardowego” nosi teraz nazwę „klucz interfejsu API”.
- Obiekty „bezpieczeństwa” uwierzytelniania zdefiniowane na poziomie wersji.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już wstępnie skonfigurowanych danych logowania klienta Smart Docs.
Więcej informacji o funkcjach znajdziesz w tym poście na blogu.
Dokumentację SmartDocs znajdziesz w artykule Używanie SmartDocs do dokumentowania interfejsów API.
Nowy edytor proxy interfejsu API w wersji beta
Dostępna jest nowa wersja beta edytora proxy interfejsu API. Aby uzyskać dostęp, podczas edytowania istniejącego proxy interfejsu API kliknij link „Uzyskaj dostęp do wersji beta”. Możesz przełączać się między edytorami „klasycznym” i „beta”.
Nowa zasada OAuthV2
Nowa zasada DeleteOAuthV2Info umożliwia usuwanie kodów autoryzacji i tokenów dostępu. Więcej informacji znajdziesz w artykule Usuwanie zasad dotyczących informacji OAuthV2.
Nowe podmioty w zasadach Access Entity
Zasady Access Entity zapewniają dostęp do tych nowych elementów: consumerkey-scopes, authorizationcode, requesttoken i verifier. Więcej informacji znajdziesz w artykule Zasady dotyczące podmiotów mających dostęp.
Wyświetlanie certyfikatów SSL, które wkrótce wygasną
Na stronie Certyfikaty SSL w interfejsie zarządzania (Administracja > Certyfikaty SSL) znajdziesz informacje o tym, kiedy certyfikaty SSL wygasną w ciągu 10, 15, 30 lub 90 dni, w zależności od wyboru w nowym polu menu wygasania.
Nazwa aplikacji dewelopera wyświetlana w interfejsie zarządzania
Aplikacje dewelopera w Edge mają zarówno wewnętrzną nazwę, która się nie zmienia, jak i wyświetlaną nazwę, którą możesz zmienić. Na stronie aplikacji dewelopera w interfejsie zarządzania (Opublikuj > Aplikacje dewelopera > nazwa aplikacji) wyświetlana jest wewnętrzna „Nazwa” aplikacji wraz z „Wyświetlaną nazwą”, co ułatwia wizualne identyfikowanie aplikacji według ich wewnętrznych nazw na potrzeby rozwiązywania problemów i zarządzania interfejsem API.
Usunięcie z interfejsu zarządzania klasycznej wersji raportów niestandardowych
Opcjonalna klasyczna wersja niestandardowych raportów analitycznych nie jest już dostępna w interfejsie zarządzania.
Proces uaktualniania Smart Docs
Jeśli korzystasz już z SmartDocs w okresie beta, nowe funkcje i możliwości w wersji ogólnej dostępności wymagają uaktualnienia SmartDocs w portalu dla deweloperów.
Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla programistów, będą nadal działać, ale przed edytowaniem lub publikowaniem zmian na istniejących lub nowych stronach musisz przejść proces aktualizacji.
Pamiętaj, że dokumenty SmartDocs możesz renderować i publikować w portalu dla programistów, ale są one generowane na podstawie modelu API, który znajduje się w usługach zarządzania interfejsami API Edge od Apigee. Wszelkie zmiany wprowadzone w modelu interfejsu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak w przypadku deweloperów w środowiskach Pantheon).
Aby przejść z wersji beta SmartDocs na wersję ogólnodostępną
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach programistycznym lub testowym w Pantheonie.
- Utwórz nowy model, który zastąpi dotychczasowy model API.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
- Jeśli model interfejsu API był utrzymywany za pomocą modułu SmartDocs, wyeksportuj go jako plik JSON SmartDocs i zaimportuj do nowego modelu za pomocą załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treści > SmartDocs > model kliknij Ustawienia zabezpieczeń.
- Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treści > SmartDocs), klikając Ustawienia w kolumnie Operacje.
- Zaktualizuj wszystkie szablony niestandardowe, aby korzystały z wersji 6 zasobów CSS i JS, i wprowadź zmiany odzwierciedlające nowe nazwy obiektów, takie jak authSchemes i apiSchema. Informacje o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.
- Ponownie wyrenderuj i opublikuj zmienioną wersję modelu.
- Po sprawdzeniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.
Jeśli jesteś klientem Edge Enterprise i masz pytania lub wątpliwości dotyczące procesu uaktualniania, wyślij e-maila na adresy marsh@apigee.com i cnovak@apigee.com. W innych przypadkach najlepszą odpowiedź uzyskasz na forum społeczności Apigee.
Poprawione błędy
W tej wersji naprawiliśmy te błędy:
| Identyfikator problemu | Opis |
|---|---|
| TBD-72 | Problem z zasadami logowania wiadomości |
| MGMT-2124 | Uprawnienia roli klienta są resetowane podczas zapisywania uprawnień w interfejsie |
| MGMT-2048 | Użytkownik z rolą niestandardową, która ogranicza uprawnienia do wdrażania do jednego środowiska, może wdrażać w innych środowiskach |
| MGMT-2041 | Usunięcie elementu FaultRules z domyślnego szablonu załącznika Element FaultRules, który nie jest używany w zasadach ani krokach serwera proxy interfejsu API, nie jest już automatycznie dodawany podczas tworzenia serwerów proxy interfejsu API ani dodawania zasad. |
| MGMT-2034 | Pobieranie pliku WSDL nie powiodło się: „Fetch WSDL Error: Error processing WSDL." |
| MGMT-1812 | Dodawanie weryfikacji TargetEndpoint podczas importowania Podobnie jak w przypadku ProxyEndpoint, podczas importowania proxy interfejsu API punkt TargetEndpoint będzie weryfikowany pod kątem prawidłowego schematu i wyrażeń używanych w warunkach. |
| MGMT-1345 | Importowanie pliku WSDL z wieloma przestrzeniami nazw powoduje nieprawidłowe działanie kroku Tworzenie SOAP |
| MGMT-800 | Utworzenie zasobu o nazwie „default” powoduje uszkodzenie interfejsu |
| MGMT-602 | Widok programowania serwera proxy interfejsu API: dodanie zasady pamięci podręcznej odpowiedzi, gdy punkt końcowy nie ma przepływu PreFlow/PostFlow, powoduje błąd |
| MGMT-460 | Zmiana nazwy zasady powoduje nieprawidłowe działanie i duplikowanie zasady, której nie można usunąć |
| DEVRT-1565 | 15-minutowe odstępy w przypadku OPŁAT |
| AXAPP-1728 | Ignorowanie zmiennych zarabiania w statystykach |
| AXAPP-1690 | Błąd „Nieprawidłowy interfejs API” w raportach niestandardowych |
| AXAPP-1533 | Mapa geograficzna w Analytics zwraca błąd nieprawidłowego wywołania interfejsu API |
| APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi dla wielu interfejsów API ma wartość null |