Interfejs API. Strategia programisty

Poznaj potencjał interfejsów API!

Internet to gigantyczna sieć urządzeń połączonych ze sobą. Jego potencjał wykorzystują wszyscy i każdy jest świadom tego, że pojedyncze urządzenie bez połączenia z siecią nic nie znaczy. Podobnie jest z systemami informatycznymi. Możliwość integracji z siecią, tworzenia rozszerzeń oraz wymiany danych pomaga twórcom aplikacji rozwinąć skrzydła i odnieść sukces na szeroką skalę. Zastanawiasz się, jak otworzyć Twój system na świat? Interfejs API to jedyna droga!

Sięgnij po tę książkę i przekonaj się, jak przygotować wygodny interfejs API, z którego programiści będą korzystali z przyjemnością. Na kolejnych stronach znajdziesz kluczowe zasady projektowania interfejsów API, sposoby zabezpieczania API oraz zarządzania użytkownikami. Ponadto dowiesz się, jak zarządzać ruchem sieciowym, obsługiwać interfejs API oraz mierzyć sukces Twojego API.

Na sam koniec zobaczysz, jak zaangażować projektantów w proces adaptacji. Ta książka jest doskonałym źródłem informacji dla wszystkich osób chcących zrozumieć, czym są interfejsy API, jak wykorzystać drzemiący w nich potencjał oraz jak uniknąć typowych zagrożeń i problemów. Twoja lektura obowiązkowa!

• Dowiedz się o rozwoju interfejsów API, a także dlaczego Twoja firma może ich wymagać.
• Zaznajom się z rolami właścicieli zasobów, dostawców i projektantów w łańcuchu wartości interfejsu API.
• Opracuj strategie związane z projektowaniem, implementowaniem i wprowadzeniem produktu na rynek.
• Opracuj efektywny proces na potrzeby zarządzaniami zabezpieczeniami i użytkownikami.
• Rozwiąż problemy natury prawnej, takie jak zarządzanie prawami i warunki użytkowania.
• Zarządzaj ruchem sieciowym i komfortem pracy użytkowników za pomocą pewnego modelu operacyjnego.
• Określ metryki wymagane do ustalenia skali powodzenia interfejsu API.

Wszystko, co powinieneś wiedzieć o interfejsach API!

Spis treści:

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)