nextcloud / forms

📝 Simple form & survey app for Nextcloud
https://apps.nextcloud.com/apps/forms
GNU Affero General Public License v3.0
311 stars 95 forks source link

Way to Forms 5 #2041

Open Chartman123 opened 3 months ago

Chartman123 commented 3 months ago

This is a collection of tasks needed for preparation/release of Forms v5.

4.3 release:

5.0 release:

susnux commented 2 months ago

How about unifying our API? Currently there is not really a pattern in the API routes - especially logical nesting.

For example for forms:

What Current New
Get forms GET /forms GET /forms
New form POST /form POST /forms :exclamation:
Get form GET /form/:id: GET /forms/:id:
Clone form POST /form/clone/:id: POST /forms/:id:/clone
Update form PATCH /form/update PATCH /forms/:id:
Transfer ownership POST /form/transfer - (just use the patch)
Delete form DELETE /form/:id: DELETE /forms/:id:

This is just an example, but I think it would make the API more logical

Chartman123 commented 2 months ago

Yes I think this would definitely make sense... This was always something illogical to me

susnux commented 2 months ago

I do not see any use case for the hash other than the legacy link, probably we can also remove that with v5?

Chartman123 commented 2 months ago

Should we add the newly organized endpoints already in 4.3 so that users of the API can already adapt to the new structure?

And regarding the hash: If we remove it, our internal links/URLs would only have the id, right? I think we should at least have a look at the APIs so that we don't mix it there (sometimes hash is needed, sometimes the id).

susnux commented 2 months ago

And regarding the hash: If we remove it, our internal links/URLs would only have the id, right? I think we should at least have a look at the APIs so that we don't mix it there (sometimes hash is needed, sometimes the id).

Yes I would just use the form id, like for files. if you use the internal share link it is just the file id.