Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info
We wtorek 2 czerwca 2015 r. udostępniliśmy nową wersję Apigee Edge w chmurze.
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
Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.
Ogólna dostępność Smart Docs
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 SmartDocs.
- 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 znane dotychczas jako „Token niestandardowy” nosi teraz nazwę „Klucz interfejsu API”.
- Obiekty „security” 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 serwera proxy 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 dostępu do podmiotów
Zasady Access Entity zapewniają dostęp do tych nowych podmiotó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) wyświetla się informacja 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 deweloperskie w Edge mają wewnętrzną nazwę, która się nie zmienia, oraz nazwę wyświetlaną, 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 interfejsami 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 SmartDocs
Jeśli korzystasz już z SmartDocs w okresie testów beta, nowe funkcje i możliwości w wersji ogólnodostępnej wymagają uaktualnienia SmartDocs w portalu dewelopera.
Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla deweloperó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 deweloperów, ale są one generowane na podstawie modelu interfejsu API, który znajduje się w usługach zarządzania interfejsami API Edge od Apigee. Wszelkie zmiany wprowadzone w modelu 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 Pantheon.
- Utwórz nowy model, który zastąpi dotychczasowy model interfejsu 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 korporacyjnym Edge 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 skorzystaj z społeczności Apigee, aby uzyskać najlepszą odpowiedź.
Usunięte 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 niestandardową rolą, która ogranicza uprawnienia do wdrażania do jednego środowiska, może wdrażać w innych |
| 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 zwraca błąd: „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 PreFlow/PostFlow, powoduje błąd |
| MGMT-460 | Zmiana nazwy zasady powoduje nieprawidłowe działanie i powielenie zasady, której nie można usunąć |
| DEVRT-1565 | 15-minutowe odstępy między OPŁATAMI |
| AXAPP-1728 | Ignorowanie zmiennych zarabiania w statystykach |
| AXAPP-1690 | Błąd „Nieprawidłowy interfejs API” w raportach niestandardowych |
| AXAPP-1533 | Błąd „Nieprawidłowe wywołanie interfejsu API” w mapie geograficznej Analytics |
| APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi w przypadku wielu interfejsów API ma wartość null |