Kilka pytań dotyczących Rest API

Odpowiedz Nowy wątek
2018-12-27 09:34
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"

Pozostało 580 znaków

2018-12-27 14:45
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 :)

edytowany 2x, ostatnio: Desu, 2018-12-27 14:49
i jak zapytasz stu deweloperów, to każdy Ci powie coś innego prawda :) - czysteskarpety 2019-01-02 17:32

Pozostało 580 znaków

2019-01-02 15:14
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 ?

Pozostało 580 znaków

2019-01-02 15:47
1

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

Pozostało 580 znaków

2019-01-02 17:14
Wesoły Kura

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

Pozostało 580 znaków

Odpowiedz
Liczba odpowiedzi na stronę

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