API nowoczesnej strony WWW. Usługi sieciowe w PHP

Twój klucz do doskonałego API!

Za sukcesem i siłą najpopularniejszych serwisów w sieci często stoi decyzja o szerokim udostępnieniu API (ang. Application Programming Interface). Dzięki temu programiści z całego świata mogą tworzyć rozwiązania oparte na istniejących usługach, integrować różne systemy oraz tworzyć rozszerzenia. Sięgnij po tę książkę, naucz się korzystać z udostępnionego API i zbuduj własne.

Poznaj tajniki budowania przyjaznego interfejsu API. Ta książka pomoże Ci zorientować się, jak działa protokół HTTP, jakie metody udostępnia oraz jakie informacje możesz znaleźć w nagłówkach. Po opanowaniu podstaw przejdziesz do najpopularniejszych formatów wymiany informacji pomiędzy systemami — JSON oraz XML.

Zaznajomisz się też z usługami SOAP, RPC i REST. Na sam koniec dowiesz się, jak projektować niezawodne usługi oraz obsługiwać błędy. Jeżeli chcesz, żeby Twoje API zainteresowało innych programistów, musisz zadbać o jego dobrą dokumentację. Zdobądź niezbędną wiedzę o PHP!

• Poznasz protokół HTTP, czasowniki cyklu żądań i odpowiedzi oraz nagłówki i ciasteczka.
• Dowiesz się, kiedy lepiej jest użyć formatu JSON, a kiedy XML.
• Nauczysz się tworzyć usługi typu RPC, SOAP i RESTful.
• Poznasz wiele narzędzi i technik diagnozowania usług sieciowych HTTP.
• Nauczysz się wybierać najlepszy rodzaj usługi dla swoich aplikacji i dowiesz się, jak tworzyć niezawodne usługi sieciowe.
• Nauczysz się dokumentować swoje interfejsy API — oraz projektować w nich mechanizmy obsługi błędów.

Zbuduj API zgodne z oczekiwaniami innych programistów.

Spis treści:

1. HTTP (11)

• Klient i serwer (13)
• Wysyłanie żądań HTTP (14)
  • Curl (15)
  • Narzędzia przeglądarki internetowej (18)
  • PHP (19)

2. Czasowniki protokołu HTTP (23)

• Wysyłanie żądań GET (23)
• Wysyłanie żądań POST (25)
• Inne czasowniki HTTP (28)

3. Nagłówki (31)

• Nagłówki żądań i odpowiedzi (32)
• Najczęściej używane nagłówki HTTP (32)
  • Nagłówek User-Agent (33)
  • Nagłówki do negocjacji treści (34)
  • Zabezpieczanie żądań za pomocą nagłówka Authorization (38)
• Nagłówki niestandardowe (40)

4. Dane cookie (43)

• Zasada działania ciasteczek (43)
• Praca z ciasteczkami w PHP (46)

5. Format JSON (49)

• Kiedy używać formatu JSON (50)
• Praca z formatem JSON z poziomu PHP (51)
• Format JSON w istniejących interfejsach API (52)

6. Format XML (57)

• Kiedy używać formatu XML (59)
• XML w PHP (59)
• XML w istniejących interfejsach API (60)

7. Usługi RPC i SOAP (63)

• Usługi RPC (63)
• Usługi SOAP (65)
  • Język WSDL (67)
  • Klient SOAP w języku PHP (67)
  • Serwer SOAP w języku PHP (68)
  • Generowanie pliku WSDL z poziomu języka PHP (69)
  • Klient i serwer PHP z WSDL (71)

8. REST (73)

• Adresy URL w usługach typu RESTful (74)
• Struktura zasobów i hipermedia (74)
• Typy danych i mediów (78)
• Elementy HTTP w REST (79)
  • Tworzenie zasobów (79)
  • Odczytywanie rekordów (80)
  • Aktualizowanie rekordów (81)
  • Usuwanie rekordów (82)
• Dodatkowe nagłówki w usługach typu RESTful (82)
  • Nagłówki autoryzacyjne (82)
  • Nagłówki buforowania (84)
• Technologia RESTful a przydatność (85)

9. Diagnozowanie usterek w usługach sieciowych (87)

• Diagnozowanie danych wyjściowych (88)
• Dzienniki (88)
• Diagnozowanie spoza aplikacji (90)
  • Wireshark (91)
  • Charles (94)
• Znajdź odpowiednie narzędzie (97)

10. Projektowanie usług (99)

• Wybór typu usługi (100)
• Wybór formatów danych (101)
• Opcje konfiguracyjne (102)
• Ustawienia domyślne (103)

11. Tworzenie niezawodnych usług (105)

• Najważniejsza jest jednolitość (105)
  • Spójność i znaczenie nazw (106)
  • Zasady weryfikacji danych (106)
  • Przewidywalność struktur (107)
• Solidność (108)

12. Obsługa błędów w interfejsach API (109)

• Format wyjściowy (109)
• Konstruktywne powiadomienia o błędach (112)
• Co robić, gdy napotka się błąd (114)

13. Dokumentacja (115)

• Dokumentacja ogólna (115)
• Dokumentacja API (116)
• Dokumentacja interaktywna (117)
• Samouczki i szerszy ekosystem (119)

A Przewodnik po najczęściej używanych kodach statusu (121)

B Najczęściej używane nagłówki HTTP (123)