Open csfore opened 1 year ago
@csfore some endpoints are indeed quite specific to the SaaS version and aren't useful for a self hosting instance and that's why they aren't documented. For example, the /apple/update_notification
endpoint is only useful for the Apple in-app purchase integration or /setting/unlink_proton_account
is only used in the SimpleLogin-Proton integration.
Prerequisites
Bug report
Describe the bug
While looking through the API code, I discovered some undocumented endpoints.
Mailbox Endpoints
There are two undocumented API endpoints:
/mailboxes
and/v2/mailboxes
, here, that use a GET method and are not mentioned in the mailbox documentation.Settings Endpoints
In the Settings endpoint,
/setting/unlink_proton_account
using DELETE is undocumented./setting/domains
is also undocumented.Notification Endpoint
There is a typo in the documentation that uses
/notifications/<int:notification_id>
when in the code it uses/notifications/<int:notification_id>/read
.Misc Endpoints
The endpoint
/apple/update_notification
(POST) is undocumented.Expected behavior Example JSON structures and appropriate headers for the endpoints in the documentation.
Screenshots Undocumented Mailbox endpoint:
Undocumented Settings endpoint:
Notification Endpoint Typo:
![image](https://user-images.githubusercontent.com/81275816/197646294-416c06e6-0154-4c61-a3a2-3e74df4e15bb.png)