Kiedy mówisz, że chcesz zaimplementować tę funkcję w "jednej transakcji", zakładam, że już wiesz, że powinieneś łączyć generowanie nowych faktur i usuwanie starego w jedno wywołanie API; co jest właściwym podejściem. Z usługami sieciowymi chcesz zmniejszyć rozmowę i prawdopodobnie istnieje pewna logika biznesowa dotycząca sposobu, w jaki ta funkcja wygeneruje nowe faktury i usunie starą. Zakładam więc, że kiedy zapytasz, jak zaprojektować to w RESTOWNOWY sposób, zastanawiasz się, który czasownik HTTP użyć (tj. GET, POST, PUT lub DELETE) dla tej nowej metody API. Zwykle te czasowniki map do operacji typu CRUD w następujący sposób:
- Create -> POST
- Odczyt -> GET
- Aktualizacja -> PUT
- Usuń -> Usuń
Więc który czasownik należy użyć, gdy twoja funkcja zarówno tworzy, jak i usuwa rekordy. Ogólna reguła z REST API polega na tym, że nie ma wyraźnego odwzorowania na CRUD, a następnie użyj POST, jeśli jest zmiana stanu serwera i GET, jeśli właśnie zwracasz informacje, które nie zmieniają stanu serwera. Więc w tym przypadku pójdę z POST.
Jeśli poszukujesz dodatkowych wskazówek na temat tego projektowania, prosimy o bardziej szczegółowe informacje o tym, czego szukasz, a ja postaram się pomóc.
Cześć Kevin, można zaproponować w jaki sposób url powinien wyglądać dla tych operacji dzielenia/łączących? –