Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
We wtorek 2 czerwca 2015 roku opublikowaliśmy nową wersję Apigee Edge w chmurze.
Jeśli masz pytania, skontaktuj się z obsługą klienta Apigee.
Listę wszystkich informacji o wersji Apigee Edge znajdziesz w artykule Informacje o wersji Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz opis nowych funkcji i ulepszeń wprowadzanych w tej wersji.
Ogólna dostępność SmartDokumentacja
Przekształcamy wersję beta funkcji SmartDokumenty w ogólne. Aktualizacje i nowe funkcje obejmują:
- Obsługa Swagger 2.0, w tym możliwość importu według pliku lub adresu URL, w tym obsługa obiektów zabezpieczeń o niestandardowych nazwach.
- Ulepszenia wizualne w szablonach do generowania SmartDokumentów.
- Ulepszenia w zakresie łatwości obsługi i przepływów pracy w Portalu dla programistów dostępne w menu Treści > Inteligentne dokumenty w Drupal
- Uwierzytelnianie, które było znane jako „token niestandardowy”, nosi teraz nazwę „klucz interfejsu API”.
- Obiekty „zabezpieczeń” uwierzytelniania zdefiniowane na poziomie wersji.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już żadnych wstępnie skonfigurowanych danych logowania klienta SmartDokumentacja.
Więcej opisów funkcji znajdziesz w tym poście na blogu.
Dokumentację SmartDokumentacja znajdziesz w artykule Używanie SmartDokumentów do dokumentowania interfejsów API.
Nowy edytor proxy interfejsu API w wersji beta
Dostępna jest nowa wersja beta edytora serwerów proxy interfejsu API. Aby uzyskać dostęp, kliknij link „Dostęp do wersji beta” podczas edytowania istniejącego serwera proxy interfejsu API. Możesz przełączać się między edytorami „klasycznym” i „beta”.
Nowa zasada OAuthV2
Nowa zasada DeleteOAuthV2Info pozwala usuwać kody autoryzacji i tokeny dostępu. Więcej informacji znajdziesz w artykule o usuwaniu zasad informacji dotyczących protokołu OAuthV2.
Nowe encje w zasadzie encji dostępu
Zasada dotycząca jednostki dostępu zapewnia dostęp do tych nowych elementów: zakresy kluczy klienta, kod autoryzacji, requesttoken i weryfikator. Więcej informacji znajdziesz w artykule o zasadach dotyczących jednostek dostępu.
Wyświetlam certyfikaty SSL, które wkrótce wygasną
Strona Certyfikaty SSL w interfejsie zarządzania (Administrator > Certyfikaty SSL) wskazuje, kiedy certyfikaty SSL wygasają w ciągu 10, 15, 30 lub 90 dni, w zależności od wyboru w polu nowego okresu ważności.
Nazwa aplikacji dewelopera wyświetlana w interfejsie zarządzania
Aplikacje dla programistów w Edge mają zarówno nazwę wewnętrzną, która się nie zmienia, oraz nazwę wyświetlaną, którą możesz zmienić. Na stronie aplikacji dewelopera w interfejsie zarządzania (Publikowanie > Aplikacje dla deweloperów > nazwa aplikacji) jest wyświetlana wewnętrzna „Nazwa” aplikacji wraz z „wyświetlaną nazwą”, co ułatwia wizualizację aplikacji na podstawie ich wewnętrznych nazw na potrzeby rozwiązywania problemów i zarządzania interfejsem API.
Klasyczna wersja raportów niestandardowych usuwana z interfejsu zarządzania
Opcjonalna klasyczna wersja niestandardowych raportów analitycznych nie jest już dostępna w interfejsie zarządzania.
Proces uaktualniania SmartDokument
Jeśli korzystasz już z SmartDokumentów w wersji beta, nowe funkcje i możliwości dostępne w wersji ogólnodostępnej wymagają uaktualnienia tej funkcji w portalu dla programistów.
Wszystkie strony w Dokumentach inteligentnych, które zostały już opublikowane w portalu dla deweloperów, będą nadal działać, ale zanim zaczniesz edytować lub opublikować jakiekolwiek zmiany na istniejących lub nowych stronach, musisz przeprowadzić proces aktualizacji.
Pamiętaj, że chociaż w portalu dla programistów możesz renderować i publikować dokumenty SmartDokumenty, są one generowane na podstawie modelu interfejsu API działającego w ramach usług zarządzania interfejsem Edge API Apigee. Wszystkie zmiany wprowadzone w modelu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie do programistów w środowiskach Pantheon).
Aby przejść z wersji beta Dokumentów Google na wersję ogólnodostępną
- Zaktualizuj i przetestuj wersję 15.05.27 w środowisku dev lub dev Pantheon.
- Utwórz nowy model, który zastąpi dotychczasowy model interfejsu API, którego używasz.
- Jeśli importujesz dokumenty Swagger lub WADL, zaimportuj je ponownie do nowej wersji.
- Jeśli Twój model interfejsu API był utrzymywany za pomocą modułu SmartDokumentacja, wyeksportuj go w formacie JSON Dokumentów i zaimportuj do nowego modelu za pomocą załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Treść >
SmartDokumenty > Model wybierz Ustawienia zabezpieczeń.
- Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Treść > SmartDokumenty), klikając Ustawienia w kolumnie Operacje.
- Zaktualizuj wszystkie szablony niestandardowe, aby używać wersji 6 zasobów CSS i JS, i wprowadź zmiany, aby odzwierciedlały nowe nazwy obiektów, takie jak authSchemes i apiSchema. Więcej informacji o aktualizowaniu szablonów SmartDokumentacja znajdziesz w artykule o używaniu SmartDokumentów do tworzenia dokumentów w interfejsach API.
- Ponownie wyrenderuj i opublikuj wersję modelu.
- Po sprawdzeniu nowej dokumentacji zaktualizuj portal produkcyjny do wersji 15.05.27.
Jeśli korzystasz z Edge Enterprise i masz pytania lub wątpliwości dotyczące procesu uaktualniania, wyślij e-maila na adres marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie skontaktuj się z społecznością Apigee, aby uzyskać najlepszą odpowiedź.
Naprawione błędy
Poprawiliśmy w niej wymienione niżej błędy.
| Identyfikator problemu | Opis |
|---|---|
| TBD-72 | Problem z zasadami rejestrowania wiadomości |
| MGMT-2124 | Uprawnienia roli klienta są resetowane po zapisaniu uprawnień w interfejsie |
| MGMT-2048 | Użytkownik z rolą niestandardową, która ogranicza uprawnienia wdrożeniowe do jednego środowiska, może wdrażać je w innych |
| 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 lub dodawania zasad. |
| MGMT-2034 | Błąd pobierania WSDL: błąd pobierania WSDL: błąd podczas przetwarzania WSDL. |
| MGMT-1812 | Dodawanie weryfikacji punktu końcowego docelowego podczas importowania Podobnie jak w przypadku punktu ProxyEndpoint punkt końcowy docelowy zostanie zweryfikowany pod kątem właściwego schematu i wyrażeń używanych w warunkach podczas importu serwera proxy interfejsu API. |
| MGMT-1345 | Import WSDL z wieloma przestrzeniami nazw powoduje nieprawidłowy krok kompilacji SOAP |
| MGMT-800 | Tworzenie zasobu o nazwie „default” powoduje uszkodzenie interfejsu |
| MGMT-602 | Widok tworzenia serwera proxy interfejsu API: dodaj zasadę pamięci podręcznej odpowiedzi, gdy punkt końcowy nie ma funkcji PreFlow/PostFlow powoduje błąd |
| MGMT-460 | Zmiana nazwy zasady powoduje zakłócenie działania i zduplikowaną zasadę, której nie można usunąć |
| DEVRT-1565 | Odstępy 15-minutowe dla OBCIĄŻEŃ |
| AXAPP-1728 | Ignorowanie zmiennych zarabiania w Analytics |
| AXAPP-1690 | „Nieprawidłowy błąd interfejsu API” w raportach niestandardowych |
| AXAPP-1533 | Geomapa Analytics zgłasza błąd nieprawidłowego wywołania interfejsu API |
| APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi dla wielu interfejsów API ma wartość null |