Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
We wtorek 2 czerwca 2015 r. udostępniliśmy nową wersję Apigee Edge w chmurze.
Jeśli masz pytania, odwiedź stronę pomocy Apigee.
Listę wszystkich informacji o wersjach Apigee Edge znajdziesz w artykule Informacje o wersjach Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz nowe funkcje i udoskonalenia w tej wersji.
Ogólna dostępność SmartDocs
SmartDocs przechodzi z wersji beta do wersji ogólnodostępnej. Aktualizacje i nowe funkcje:
- Obsługa Swagger 2.0, w tym importowanie za pomocą pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowych nazwach.
- Ulepszenia wizualne w szablonach, które generują dokumenty inteligentne.
- Ulepszenia dotyczące użyteczności i procesów w portalu dla deweloperów, dostępne w menu Treści > SmartDocs w Drupalu.
- Metoda uwierzytelniania „Token niestandardowy” została teraz zastąpiona metodą „Klucz API”.
- Obiekty „security” uwierzytelniania zdefiniowane na poziomie poprawki.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują żadnych wstępnie skonfigurowanych danych logowania klienta SmartDocs.
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 serwera proxy API kliknij link „Uzyskaj dostęp do wersji beta”. Możesz przełączać się między edytorami „klasycznym” i „beta”.
Nowa zasada OAuth V2
Nowe zasady DeleteOAuthV2Info umożliwiają usuwanie kodów autoryzacji i tokenów dostępu. Więcej informacji znajdziesz w zasadach dotyczących usuwania informacji OAuth 2.
Nowe typy encji w zasadach dostępu
Zasady dotyczące dostępu do obiektów zapewniają dostęp do tych nowych obiektów: consumerkey-scopes, authorizationcode, requesttoken i verifier. Więcej informacji znajdziesz w zasadach dotyczących dostępu do jednostek.
wyświetlanie certyfikatów SSL, które wkrótce wygasną;
Strona Certyfikaty SSL w interfejsie zarządzania (Administracja > Certyfikaty SSL) wskazuje, kiedy kończy się ważność certyfikatów SSL w ciągu 10, 15, 30 lub 90 dni, w zależności od wybranej opcji w polu menu Nowy termin ważności.
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 Aplikacja 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 nazw wewnętrznych na potrzeby rozwiązywania problemów i zarządzania interfejsem API.
Usunięcie klasycznej wersji raportów niestandardowych z interfejsu zarządzania
Opcjonalna klasyczna wersja niestandardowych raportów analitycznych nie jest już dostępna w interfejsie zarządzania.
Proces przekształcania SmartDocs
Jeśli korzystasz już z SmartDocs w wersji beta, nowe funkcje i możliwości w wersji ogólnodostępnej wymagają uaktualnienia SmartDocs na portalu deweloperskim.
Strony SmartDocs, które zostały już opublikowane w portalu deweloperskim, będą nadal działać, ale przed edytowaniem lub opublikowaniem zmian na istniejących lub nowych stronach musisz wykonać proces aktualizacji.
Pamiętaj, że chociaż możesz renderować i publikować dokumenty SmartDocs w portalu dewelopera, dokumenty te są generowane na podstawie modelu interfejsu API, który znajduje się w usłudze zarządzania interfejsem API na krawędzi od firmy Apigee. Wszelkie zmiany wprowadzone w modelu interfejsu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak deweloperzy w różnych środowiskach Pantheon).
Aby przejść z wersji beta SmartDocs do wersji ogólnodostępnej
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach rozwojowym lub testowym w Pantheon.
- Utwórz nowy model, aby zastąpić dowolny dotychczasowy model interfejsu API, którego używasz.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
- Jeśli model interfejsu API był aktualizowany 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ść >
SmartDocs > model wybierz Ustawienia zabezpieczeń.
- Sprawdź dowolną wstępnie skonfigurowaną metodę uwierzytelniania na stronie ustawień modelu (Treści >
SmartDocs) przez kliknięcie Ustawień w kolumnie Operacje.
- Zaktualizuj wszystkie szablony niestandardowe, aby używały zasobów CSS i JS w wersji 6. Wprowadź zmiany, aby uwzględnić nowe nazwy obiektów, np. authSchemes i apiSchema. Informacje o aktualizowaniu szablonów SmartDocs znajdziesz w artykule Używanie SmartDocs do dokumentowania interfejsów API.
- Ponownie wyrenderuj i opublikuj zaktualizowany model.
- Po zweryfikowaniu 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 aktualizacji, wyślij e-maila na adresy marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie skorzystaj z społeczności Apigee, aby uzyskać najlepszą odpowiedź.
Naprawione błędy
W tej wersji naprawiliśmy te błędy:
| Identyfikator problemu | Opis |
|---|---|
| TBD-72 | Problem z zasadami dotyczącymi rejestrowania wiadomości |
| MGMT-2124 | Uprawnienia roli klienta są resetowane po zapisaniu uprawnień w interfejsie użytkownika |
| MGMT-2048 | Użytkownik z niestandardową rolą, która ogranicza uprawnienia do wdrażania do jednego środowiska, może wdrażać w innych środowiskach |
| MGMT-2041 | Usuwanie 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 | Błąd podczas pobierania WSDL: „Błąd podczas pobierania WSDL: błąd przetwarzania WSDL”. |
| MGMT-1812 | Dodaj weryfikację punktu końcowego docelowego podczas importowania Podobnie jak w przypadku punktu końcowego pośredniczącego, podczas importowania pośredniczącego punktu końcowego API sprawdzamy poprawność schematu i wyrażeń używanych w warunkach. |
| MGMT-1345 | Importowanie pliku WSDL z wieloma przestrzeniami nazw powoduje nieprawidłowy wynik tworzenia SOAP Krok |
| MGMT-800 | Tworzenie zasobu o nazwie „default” powoduje nieprawidłowe działanie interfejsu użytkownika |
| MGMT-602 | Widok tworzenia serwera proxy interfejsu API: dodawanie zasady dotyczącej pamięci podręcznej odpowiedzi, gdy punkt końcowy nie ma błędu spowodowanego przez PreFlow/PostFlow |
| MGMT-460 | Zmiana nazwy zasady powoduje nieprawidłowe działanie i powtarzanie się zasad, których nie można usunąć |
| DEVRT-1565 | 15-minutowe przerwy na ładowanie |
| AXAPP-1728 | Ignorowanie w statystykach zmiennych zarabiania |
| AXAPP-1690 | „Nieprawidłowy błąd interfejsu API” w raportach niestandardowych |
| AXAPP-1533 | Wywołanie metody Geomap w Analytics zwraca błąd nieprawidłowego wywołania interfejsu API |
| APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi dla wielu interfejsów API jest pusty |