API nowoczesnej strony WWW. Usługi sieciowe w PHP

Description

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......Page 4 Wstęp......Page 8 Konwencje typograficzne......Page 9 Podziękowania......Page 10 1. HTTP......Page 12 Klient i serwer......Page 14 Wysyłanie żądań HTTP......Page 15 Curl......Page 16 Narzędzia przeglądarki internetowej......Page 19 PHP......Page 20 Wysyłanie żądań GET......Page 24 Wysyłanie żądań POST......Page 26 Inne czasowniki HTTP......Page 29 3. Nagłówki......Page 32 Najczęściej używane nagłówki HTTP......Page 33 Nagłówek User-Agent......Page 34 Nagłówki do negocjacji treści......Page 35 Zabezpieczanie żądań za pomocą nagłówka Authorization......Page 39 Nagłówki niestandardowe......Page 41 Zasada działania ciasteczek......Page 44 Praca z ciasteczkami w PHP......Page 47 5. Format JSON......Page 50 Kiedy używać formatu JSON......Page 51 Praca z formatem JSON z poziomu PHP......Page 52 Format JSON w istniejących interfejsach API......Page 53 6. Format XML......Page 58 XML w PHP......Page 60 XML w istniejących interfejsach API......Page 61 Usługi RPC......Page 64 Usługi SOAP......Page 66 Klient SOAP w języku PHP......Page 68 Serwer SOAP w języku PHP......Page 69 Generowanie pliku WSDL z poziomu języka PHP......Page 70 Klient i serwer PHP z WSDL......Page 72 8. REST......Page 74 Struktura zasobów i hipermedia......Page 75 Typy danych i mediów......Page 79 Tworzenie zasobów......Page 80 Odczytywanie rekordów......Page 81 Aktualizowanie rekordów......Page 82 Nagłówki autoryzacyjne......Page 83 Nagłówki buforowania......Page 85 Technologia RESTful a przydatność......Page 86 9. Diagnozowanie usterek w usługach sieciowych......Page 88 Dzienniki......Page 89 Diagnozowanie spoza aplikacji......Page 91 Wireshark......Page 92 Charles......Page 95 Znajdź odpowiednie narzędzie......Page 98 10. Projektowanie usług......Page 100 Wybór typu usługi......Page 101 Wybór formatów danych......Page 102 Opcje konfiguracyjne......Page 103 Ustawienia domyślne......Page 104 Najważniejsza jest jednolitość......Page 106 Zasady weryfikacji danych......Page 107 Przewidywalność struktur......Page 108 Solidność......Page 109 Format wyjściowy......Page 110 Konstruktywne powiadomienia o błędach......Page 113 Co robić, gdy napotka się błąd......Page 115 Dokumentacja ogólna......Page 116 Dokumentacja API......Page 117 Dokumentacja interaktywna......Page 118 Samouczki i szerszy ekosystem......Page 120 A. Przewodnik po najczęściej używanych kodach statusu......Page 122 B. Najczęściej używane nagłówki HTTP......Page 124 Skorowidz......Page 126 Kolofon......Page 131