Kilka pytań dotyczących Rest API

0
  1. Czy Rest Api to jest to samo co REST full API
  2. Urle mogą wyglądać w ten sposób /products/view/1/kategoria/jakisparametr/4 itd"
2
  1. Tak, to jest to samo, ale jeżeli chcemy być bardzo poprawni, to jest mała różnica. REST, to pewien z styl, nazwa architektury, zbiór reguł, a "restful", to przymiotnik określający rzecz, która jest wykonana zgodnie z tym pierwszym.

  2. Nie wiem, czy to pytanie, czy stwierdzenie, ale ten url raczej nie jest restowy. W sumie tych reguł jest dużo i jak zapytasz stu deweloperów, to każdy Ci powie coś innego, ale generalna zasada jest taka, że w url'u nie powinieneś mieć czasowników. U Ciebie jest to "view". Taka akcja powinna być sterowana za pomocą metod http. Ogólny, najprostszy schemat dla podstawowych operacji CRUD może być taki:

  • GET /products -> zwraca listę
  • GET /products/1 -> zwraca konkretny produkt o id 1
  • POST /products -> dodaje do kolekcji produktów jeden produkt, dane są w body
  • PATCH/PUT /products/1 -> aktualizuje produkt o id 1, dane są w body
  • DELETE /products/1 -> usuwa produkt o id 1

Czasami nie ma co się za bardzo tych zasad trzymać, bo powstanie API, które jest cholernie trudne w użyciu, a jeszcze trudniejsze w utrzymaniu. Natomiast zaletą trzymania się podstawowych reguł jest łatwość użycia :)

0

a jeśli api będzie dość rozbudowane to wypadałoby napisać jakiś spis treści do akcji czy są gotowe dokumentatory do api jakie polecacie ?

1

Swagger - system do dokumentacji API, testowania i ew. generowania klientów nawet.

1

Jest też http://apidocjs.com/ który jest odpowiednikiem po części phpDocumentora.

1 użytkowników online, w tym zalogowanych: 0, gości: 1