Przedmowa (9)

1. Możliwości interfejsów API (13)

• Dlaczego napisano tę książkę? (15)
• Dla kogo przeznaczona jest ta książka? (17)
• Czym jest interfejs API? (17)
  • Czym interfejs API różni się od witryny internetowej? (18)
  • Interfejsy API i witryny internetowe mają jednakże wiele wspólnego (20)
• Kto korzysta z interfejsu API? (21)
• Typy interfejsów API (21)
• Dlaczego teraz? (23)

2. Interfejsy API jako strategia biznesowa (25)

• Rozwój interfejsów API (28)
• Dlaczego interfejs API może okazać się potrzebny? (30)
  • Potrzebujesz drugiej aplikacji dla urządzeń przenośnych (30)
  • Klienci lub partnerzy pytają o interfejs API (31)
  • Witryna internetowa zaczyna być używana do wyodrębniania wyświetlanych danych (32)
  • Wymagasz większej elastyczności w zakresie udostępniania treści (32)
  • Istnieją dane, które mają zostać udostępnione (33)
  • Konkurencja z branży korzysta z interfejsu API (33)
  • Chcesz umożliwić potencjalnym partnerom poznanie nowości (34)
  • Wymagasz skalowania integracji z klientami i partnerami (34)
  • Interfejs API ulepsza architekturę techniczną (36)

3. Łańcuch wartości interfejsu API (37)

• Definiowanie łańcucha wartości: zadawanie kluczowych pytań (38)
• Tworzenie łańcucha wartości prywatnego interfejsu API (41)
  • Metody użycia prywatnego interfejsu API (42)
  • Zalety prywatnych interfejsów API (45)
  • Zagrożenia związane z prywatnymi interfejsami API (46)
• Tworzenie łańcucha wartości publicznych interfejsów API (47)
  • Metody wykorzystania publicznego interfejsu API (48)
  • Zalety publicznych interfejsów API (51)
  • Zagrożenia związane z publicznymi interfejsami API (52)
• Przemiana: publiczny interfejs API zamiast prywatnego, prywatny interfejs zamiast publicznego (53)
  • Netflix: zamiana publicznego interfejsu API na prywatny (54)
• Modele biznesowe z interfejsami API używane do współpracy z partnerami (56)
  • Zwiększanie zasięgu: więcej aplikacji, więcej platform (56)
  • Osiąganie pośredniego dochodu (57)
  • Zwiększanie innowacji we współpracy z partnerami (58)
  • Zwiększanie wartości aplikacji poprzez integrację (58)
  • Wariant użycia po części darmowy, a po części płatny (59)
• Postrzeganie modeli biznesowych interfejsów API przez firmę ProgrammableWeb.com (60)

4. Przygotowywanie strategii produktów z interfejsami API (65)

• Określanie jasnego celu biznesowego (66)
• Określenie wizji dotyczącej interfejsu API (66)
• Podstawy strategii dotyczącej interfejsu API (68)
  • Interfejsy API wymagają sponsora biznesowego (69)
• Typy strategii związanych z interfejsami API (70)
  • Strategie dotyczące prywatnych interfejsów API (71)
  • Strategie dotyczące publicznych interfejsów API (72)
• Tworzenie zespołu (73)
  • Promotor projektantów (74)
• Zastrzeżenia dotyczące interfejsów API (76)

5. Kluczowe zasady projektowania interfejsów API (81)

• Projektowanie interfejsów API dla konkretnych grup odbiorców (82)
  • Projektowanie pod kątem projektantów (83)
  • Projektowanie pod kątem użytkowników aplikacji (85)
• Najlepsze praktyki związane z projektem interfejsów API (85)
  • Odróżnij własny interfejs API (86)
  • Zapewnij łatwość testowania i używania interfejsu API (87)
  • Zapewnij łatwość zrozumienia interfejsu API (88)
  • Nie rób niczego dziwnego (89)
  • Mniej znaczy więcej (90)
  • Ukierunkowanie na konkretny segment projektantów (91)
• Kwestie techniczne projektu interfejsów API (91)
  • Usługa REST (92)
  • Przykład: projektowanie z wykorzystaniem pragmatycznej usługi REST (97)
  • Kontrola wersji i projekt interfejsu API (100)
• Projektowanie infrastruktury dla interfejsów API (106)
  • Centrum danych czy chmura? (106)
  • Strategie buforowania (107)
  • Kontrolowanie ruchu sieciowego generowanego przez interfejsy API (109)

6. Zabezpieczenia interfejsów API i zarządzanie użytkownikami (111)

• Zarządzanie użytkownikami (112)
  • Czy niezbędne jest rozpoczynanie od podstaw? (113)
  • Pytania, które należy zadać odnośnie do zarządzania użytkownikami (113)
• Identyfikacja (114)
• Uwierzytelnianie: potwierdzanie tożsamości użytkownika (116)
  • Nazwy użytkowników i hasła (116)
  • Uwierzytelnianie oparte na sesji (117)
  • Inne metody uwierzytelniania (118)
  • Protokół OAuth (118)
  • Ulepszanie uwierzytelniania za pomocą protokołu SSL (120)
• Szyfrowanie (122)
• Wykrywanie zagrożeń i zapobieganie im (123)
  • "Wstrzykiwanie" kodu SQL (124)
  • Ataki z wykorzystaniem formatów XML i JSON (124)
  • Maskowanie danych (125)
• Ogólne zalecenia (126)
  • Zalecenia dotyczące ochrony danych interfejsu API (126)
  • Zalecenia dotyczące zabezpieczeń interfejsów API (126)

7. Kwestie prawne związane ze strategią interfejsu API (129)

• Zarządzanie prawami (130)
  • Praktyka: zarządzanie prawami w organizacji NPR (130)
• Umowy i warunki użytkowania (133)
• Zasady prywatności (135)
• Zasady utrzymywania danych (136)
• Przypisywanie właściciela treści i budowanie świadomości marki (137)
• Reagowanie na niewłaściwe użycie (137)

8. Obsługa interfejsu API i zarządzanie nim (139)

• Obsługa interfejsu API (140)
  • Informacje operacyjne na żądanie: strona statusu interfejsu API (141)
  • Radzenie sobie z problemami operacyjnymi (142)
  • Umowy SLA (143)
  • Zarządzanie problemami (143)
  • Monitorowanie i wsparcie operacyjne (144)
  • Dokumentowanie interfejsu API (145)
  • Zestaw procedur operacyjnych (147)
• Metody zarządzania ruchem sieciowym (148)
  • Zarządzanie ruchem sieciowym na poziomie biznesowym (148)
  • Operacyjne zarządzanie ruchem sieciowym (152)
  • Zarządzanie ruchem sieciowym i skalowalność (154)
  • Bramy interfejsów API (155)

9. Określanie miary sukcesu interfejsu API (159)

• Obsługa metryk interfejsów API (160)
  • Dlaczego gromadzone są wzorce wykorzystania na potrzeby metryk? (161)
  • Żądania i odpowiedzi (162)
  • Wyświetlenia (162)
  • Lojalność (163)
• Metryki operacyjne (164)
  • Metryki związane z efektywnością (166)
  • Metryki związane z wydajnością (166)
• Kluczowe pytania związane z wydajnością interfejsów API (167)

10. Angażowanie projektantów w proces adaptacji (173)

• Co motywuje projektantów? (174)
• Kluczowe elementy programu dla projektantów (174)
  • Produkt (czyli najpierw musisz dysponować znakomitym interfejsem API!) (175)
  • Dostęp do interfejsu API i jego twórcy (175)
  • Warunki biznesowe i oczekiwania względem umów SLA (176)
  • Treść (177)
  • Świadomość istnienia interfejsu API (177)
  • Skoncentruj się na pełnym komforcie pracy projektantów (178)
  • Społeczność (179)
• Anatomia portalu projektantów (179)
• Działania zalecane i niezalecane w procesie angażowania projektantów (184)
  • Działania zalecane (184)
  • Działania niezalecane (188)

11. Epilog: to dopiero początek (191)

Skorowidz (193)

• Title: Interfejs API. Strategia programisty
• Author: Daniel Jacobson, Greg Brail, Dan Woods
• Original title: APIs: A Strategy Guide
• Translation: Piotr Pilch
• ISBN: 978-83-283-0556-4, 9788328305564
• Date of issue: 2015-06-10
• Format: Ebook
• Item ID: inapst
• Publisher: Helion