Interfejs_API_Strategia_programisty_inapst.pdf

(818 KB) Pobierz
Tytuł oryginału: APIs: A Strategy Guide
Tłumaczenie: Piotr Pilch
ISBN: 978-83-283-0555-7
© 2015 Helion S.A.
Authorized Polish translation of the English edition of APIs: A Strategy Guide, ISBN
9781449308926 © 2012 Evolved Media.
This translation is published and sold by permission of O’Reilly Media, Inc., which owns or
controls all rights to publish and sell the same.
All rights reserved. No part of this book may be reproduced or transmitted in any form
or by any means, electronic or mechanical, including photocopying, recording or by any
information storage retrieval system, without permission from the Publisher.
Wszelkie prawa zastrzeżone. Nieautoryzowane rozpowszechnianie całości lub fragmentu
niniejszej publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą
kserograficzną, fotograficzną, a także kopiowanie książki na nośniku filmowym,
magnetycznym lub innym powoduje naruszenie praw autorskich niniejszej publikacji.
Wszystkie znaki występujące w tekście są zastrzeżonymi znakami firmowymi bądź
towarowymi ich właścicieli.
Autor oraz Wydawnictwo HELION dołożyli wszelkich starań, by zawarte w tej książce
informacje były kompletne i rzetelne. Nie biorą jednak żadnej odpowiedzialności ani za ich
wykorzystanie, ani za związane z tym ewentualne naruszenie praw patentowych lub
autorskich. Autor oraz Wydawnictwo HELION nie ponoszą również żadnej odpowiedzialności
za ewentualne szkody wynikłe z wykorzystania informacji zawartych w książce.
Wydawnictwo HELION
ul. Kościuszki 1c, 44-100 GLIWICE
tel. 32 231 22 19, 32 230 98 63
e-mail:
helion@helion.pl
WWW:
http://helion.pl
(księgarnia internetowa, katalog książek)
Drogi Czytelniku!
Jeżeli chcesz ocenić tę książkę, zajrzyj pod adres
http://helion.pl/user/opinie/inapst
Możesz tam wpisać swoje uwagi, spostrzeżenia, recenzję.
Printed in Poland.
Kup książkę
Poleć książkę
Oceń książkę
Księgarnia internetowa
Lubię to! » Nasza społeczność
Spis tre ci
Przedmowa ...................................................................................... 9
1. Mo liwo ci interfejsów API .......................................................... 13
Dlaczego napisano t ksi k ?
Dla kogo przeznaczona jest ta ksi ka?
Czym jest interfejs API?
Czym interfejs API ró ni si od witryny internetowej?
Interfejsy API i witryny internetowe
maj jednak e wiele wspólnego
Kto korzysta z interfejsu API?
Typy interfejsów API
Dlaczego teraz?
Rozwój interfejsów API
Dlaczego interfejs API mo e okaza si potrzebny?
Potrzebujesz drugiej aplikacji dla urz dze przeno nych
Klienci lub partnerzy pytaj o interfejs API
Witryna internetowa zaczyna by u ywana
do wyodr bniania wy wietlanych danych
Wymagasz wi kszej elastyczno ci
w zakresie udost pniania tre ci
Istniej dane, które maj zosta udost pnione
Konkurencja z bran y korzysta z interfejsu API
Chcesz umo liwi potencjalnym partnerom poznanie nowo ci
Wymagasz skalowania integracji z klientami i partnerami
Interfejs API ulepsza architektur techniczn
15
17
17
18
20
21
21
23
28
30
30
31
32
32
33
33
34
34
36
38
41
42
45
46
3
2. Interfejsy API jako strategia biznesowa ....................................... 25
3.
a cuch warto ci interfejsu API ................................................... 37
Definiowanie a cucha warto ci: zadawanie kluczowych pyta
Tworzenie a cucha warto ci prywatnego interfejsu API
Metody u ycia prywatnego interfejsu API
Zalety prywatnych interfejsów API
Zagro enia zwi zane z prywatnymi interfejsami API
Kup książkę
Poleć książkę
Tworzenie a cucha warto ci publicznych interfejsów API
Metody wykorzystania publicznego interfejsu API
Zalety publicznych interfejsów API
Zagro enia zwi zane z publicznymi interfejsami API
Przemiana: publiczny interfejs API zamiast prywatnego,
prywatny interfejs zamiast publicznego
Netflix: zamiana publicznego interfejsu API na prywatny
Modele biznesowe z interfejsami API
u ywane do wspó pracy z partnerami
Zwi kszanie zasi gu: wi cej aplikacji, wi cej platform
Osi ganie po redniego dochodu
Zwi kszanie innowacji we wspó pracy z partnerami
Zwi kszanie warto ci aplikacji poprzez integracj
Wariant u ycia po cz ci darmowy, a po cz ci p atny
Postrzeganie modeli biznesowych interfejsów API przez firm
ProgrammableWeb.com
Okre lanie jasnego celu biznesowego
Okre lenie wizji dotycz cej interfejsu API
Podstawy strategii dotycz cej interfejsu API
Interfejsy API wymagaj sponsora biznesowego
Typy strategii zwi zanych z interfejsami API
Strategie dotycz ce prywatnych interfejsów API
Strategie dotycz ce publicznych interfejsów API
Tworzenie zespo u
Promotor projektantów
Zastrze enia dotycz ce interfejsów API
Projektowanie interfejsów API dla konkretnych grup odbiorców
Projektowanie pod k tem projektantów
Projektowanie pod k tem u ytkowników aplikacji
Najlepsze praktyki zwi zane z projektem interfejsów API
Odró nij w asny interfejs API
Zapewnij atwo testowania i u ywania interfejsu API
Zapewnij atwo zrozumienia interfejsu API
Nie rób niczego dziwnego
Mniej znaczy wi cej
Ukierunkowanie na konkretny segment projektantów
47
48
51
52
53
54
56
56
57
58
58
59
60
66
66
68
69
70
71
72
73
74
76
82
83
85
85
86
87
88
89
90
91
4. Przygotowywanie strategii produktów z interfejsami API .........65
5. Kluczowe zasady projektowania interfejsów API ....................... 81
4
Spis tre ci
Kup książkę
Poleć książkę
Kwestie techniczne projektu interfejsów API
Us uga REST
Przyk ad: projektowanie z wykorzystaniem
pragmatycznej us ugi REST
Kontrola wersji i projekt interfejsu API
Projektowanie infrastruktury dla interfejsów API
Centrum danych czy chmura?
Strategie buforowania
Kontrolowanie ruchu sieciowego generowanego
przez interfejsy API
91
92
97
100
106
106
107
109
6. Zabezpieczenia interfejsów API
i zarz dzanie u ytkownikami ...................................................... 111
Zarz dzanie u ytkownikami
Czy niezb dne jest rozpoczynanie od podstaw?
Pytania, które nale y zada odno nie do zarz dzania
u ytkownikami
Identyfikacja
Uwierzytelnianie: potwierdzanie to samo ci u ytkownika
Nazwy u ytkowników i has a
Uwierzytelnianie oparte na sesji
Inne metody uwierzytelniania
Protokó OAuth
Ulepszanie uwierzytelniania za pomoc protoko u SSL
Szyfrowanie
Wykrywanie zagro e i zapobieganie im
„Wstrzykiwanie” kodu SQL
Ataki z wykorzystaniem formatów XML i JSON
Maskowanie danych
Ogólne zalecenia
Zalecenia dotycz ce ochrony danych interfejsu API
Zalecenia dotycz ce zabezpiecze interfejsów API
Zarz dzanie prawami
Praktyka: zarz dzanie prawami w organizacji NPR
Umowy i warunki u ytkowania
Zasady prywatno ci
Zasady utrzymywania danych
Przypisywanie w a ciciela tre ci i budowanie wiadomo ci marki
Reagowanie na niew a ciwe u ycie
Spis tre ci
112
113
113
114
116
116
117
118
118
120
122
123
124
124
125
126
126
126
130
130
133
135
136
137
137
5
7. Kwestie prawne zwi zane ze strategi interfejsu API .............. 129
Kup książkę
Poleć książkę
Zgłoś jeśli naruszono regulamin