Jaka powinna być struktura API?

0

Cześć.

Dla ćwiczeń i nauki robię API w Springu udostępniające dane o miastach w województwach i województwach w krajach i mam kilka pytań dotyczących dobrych praktyk.
Planuję zrobić następujące serwisy:
/countries - udostępniający kraje z danymi - id, name
/country/{id} - udostępniający kraj z danymi - id, name, provinces
/provinces - udostępniający województwa z danymi - id, name
/province/{id} - udostępniający województwo z danymi - id, name, cities, country
/cities - udostępniający miasta z danymi - id, name
/city/{id} - udostępniający miasto z danymi - id, name, province

I tu moje pytanie czy jest to dobre podejście, czy dane są udostępniane w dobry sposób?
Czy powinienem np. w miastach dodać informacje o krajach itp?

0

Nie /country/{id} tylko /countries/{id}. Poza tym poczytaj o HATEOAS

0

A w przypadku, w który można dodawać i usuwać dane dobre byłyby następujące adresy?

/country/get
/country/get/{id}
/country/add
/country/edit
/country/delete

A jeśli nie, to jak to rozwiązać?

0

A jeśli nie, to jak to rozwiązać?

/country (metoda GET)
/country/{id} (metoda GET)
/country (metoda PUT)
/country (metoda POST)
/country (metoda DELETE)

Do poczytania:
http://www.restapitutorial.com/lessons/httpmethods.html

2

Ja bym zrobił
/countries/{country_id}/provinces
/countries/{country_id}/provinces/{province_id}

0
scibi92 napisał(a):

Ja bym zrobił
/countries/{country_id}/provinces
/countries/{country_id}/provinces/{province_id}

No dobra, ale co w przypadku jak ktoś by chciał listę wszystkich województw na świecie?

0

W zadaniu było napisane: "województwach w krajach" więc nie chciał.

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