Wyświetlasz dokumentację Apigee Edge.
Otwórz 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 wydaniach Apigee Edge znajdziesz w artykule Informacje o wydaniach Apigee.
Nowe funkcje i ulepszenia
Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.
Ogólna dostępność SmartDocs
SmartDocs wychodzi z wersji beta i staje się ogólnodostępne. Aktualizacje i nowe funkcje:
- Obsługa Swagger 2.0, w tym importowanie według pliku lub adresu URL, oraz obsługa obiektów zabezpieczeń o nazwach niestandardowych.
- Ulepszenia wyglądu szablonów, które generują SmartDocs.
- Ulepszenia dotyczące użyteczności i przepływu pracy w portalu dewelopera, dostępne w Drupalu w menu Content > SmartDocs (Treść > SmartDocs).
- Uwierzytelnianie „Custom Token” (Token niestandardowy) nosi teraz nazwę „API Key” (Klucz interfejsu API).
- Obiekty „security” (zabezpieczenia) uwierzytelniania zdefiniowane na poziomie wersji.
- Konfiguracja uwierzytelniania klienta na poziomie szablonu. Nowe wersje nie resetują już wstępnie skonfigurowanych danych logowania klienta SmartDocs.
Więcej informacji o funkcjach znajdziesz w tym poście na blogu.
Dokumentację SmartDocs znajdziesz w artykule Dokumentowanie interfejsów API za pomocą SmartDocs.
Nowa wersja beta edytora proxy interfejsu API
Dostępna jest nowa wersja beta edytora proxy interfejsu API. Aby uzyskać dostęp, podczas edytowania istniejącego serwera proxy interfejsu API kliknij link „Access the Beta Version” (Uzyskaj dostęp do wersji beta). Możesz przełączać się między "klasycznym" i "beta" edytorami.
Nowa zasada OAuthV2
Nowa zasada DeleteOAuthV2Info umożliwia usuwanie kodów autoryzacji i tokenów dostępu. Więcej informacji znajdziesz w artykule Zasada Delete OAuthV2 Info.
Nowe encje w zasadzie Access Entity policy
Zasada Access Entity zapewnia dostęp do tych nowych encji: consumerkey-scopes, authorizationcode, requesttoken i verifier. Więcej informacji znajdziesz w artykule Zasada Access Entity.
Wyświetlanie certyfikatów SSL , których ważność wkrótce wygaśnie
Strona Certyfikaty SSL w interfejsie zarządzania (Administracja > Certyfikaty SSL) wskazuje, kiedy certyfikaty SSL wygasną w ciągu 10, 15, 30 lub 90 dni, w zależności od wyboru w nowym polu listy rozwijanej 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żna zmienić. Na stronie aplikacji dewelopera w interfejsie zarządzania (Publikowanie > 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.
Usuwanie 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 uaktualniania SmartDocs
Jeśli korzystasz już ze SmartDocs w wersji beta, nowe funkcje i możliwości w wersji ogólnej dostępności wymagają uaktualnienia SmartDocs w portalu dla programistów.
Wszystkie strony SmartDocs, które zostały już opublikowane w portalu dla programistów, 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ć SmartDocs w portalu dla programistów, są one generowane na podstawie modelu interfejsu API, który znajduje się w usługach zarządzania interfejsem API Edge firmy Apigee. Wszelkie zmiany wprowadzone w modelu interfejsu API w Edge będą takie same we wszystkich środowiskach Pantheon (podobnie jak deweloperzy w środowiskach Pantheon).
Aby przejść z wersji beta SmartDocs na wersję ogólnodostępną:
- Zaktualizuj i przetestuj wersję 15.05.27 w środowiskach dev lub test 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 utrzymujesz model interfejsu API za pomocą modułu SmartDocs, wyeksportuj go jako SmartDocs JSON i zaimportuj do nowego modelu za pomocą załącznika.
- Ustaw właściwości zabezpieczeń wersji modelu. Na stronie Content >
SmartDocs > model kliknij Security Settings.
- Sprawdź wstępnie skonfigurowane uwierzytelnianie na stronie ustawień modelu (Content >
SmartDocs (Treść > SmartDocs)) i kliknij Settings (Ustawienia) w kolumnie Operations (Operacje).
- Zaktualizuj wszystkie szablony niestandardowe, aby używać zasobów CSS i JS w wersji 6, i wprowadź zmiany, aby odzwierciedlić 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 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 adres marsh@apigee.com i cnovak@apigee.com. W przeciwnym razie skorzystaj ze społeczności Apigee.
Naprawione 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 wdrożenia do jednego środowiska, może wdrażać 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 proxy interfejsu API, nie jest już automatycznie dodawany podczas tworzenia serwerów proxy interfejsu API ani dodawania zasad. |
| MGMT-2034 | Pobieranie WSDL zwraca błąd: "Fetch WSDL Error: Error processing WSDL." |
| MGMT-1812 | Dodawanie weryfikacji TargetEndpoint podczas importowania Podobnie jak w przypadku ProxyEndpoint, TargetEndpoint będzie weryfikowany pod kątem prawidłowego schematu i wyrażeń używanych w warunkach podczas importowania proxy interfejsu API. |
| MGMT-1345 | Importowanie WSDL z wieloma przestrzeniami nazw powoduje nieprawidłowy krok Build SOAP Step |
| MGMT-800 | Utworzenie zasobu o nazwie „default” powoduje uszkodzenie interfejsu |
| MGMT-602 | Widok Develop (Tworzenie) proxy interfejsu API: dodanie zasady Response Cache (Pamięć podręczna odpowiedzi), gdy punkt końcowy nie ma 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 interwały dla opłat |
| AXAPP-1728 | Ignorowanie zmiennych zarabiania w Analytics |
| AXAPP-1690 | „Invalid API Error” (Nieprawidłowy błąd interfejsu API) w raportach niestandardowych |
| AXAPP-1533 | Geomapa Analytics zwraca błąd „Invalid API Call” (Nieprawidłowe wywołanie interfejsu API) |
| APIRT-52 | Raporty niestandardowe: kod stanu odpowiedzi dla wielu interfejsów API ma wartość null |