- Add nonce endpoint doc
- Add registration endpoint
- Update some param docs to "query parameters" instead of incorrect/misleading "query parameters".
- Update postpassword docs with much more detail
- Update post object doc
@ -1039,7 +1039,7 @@ Returns a list of board banner file names. Full path of a banner is `/banner/{bo
`GET https://fatchan.org/{board}/banners.json`
### Query Parameters
### URL Parameters
Parameter | Description
--------- | -----------
@ -1104,7 +1104,7 @@ Returns some publicly available board settings.
`GET https://fatchan.org/{board}/settings.json`
### Query Parameters
### URL Parameters
Parameter | Description
--------- | -----------
@ -1257,13 +1257,14 @@ name | string | Name
message | string | Message
subject | string | Subject
email | string | Email, or special values such as 'sage'.
postpassword | string | Password required to delete the post later.
postpassword | string | Post password lets users action posts e.g. delete, spoiler, remove files after posting. It's useful to let anonymous users manage their own posts without requiring an account. Users can set it manually, or if they have JavaScript enabled one is randomly generated and storedin localstorage. If the post password is left empty, the post can only be actioned by staff. Staff can also action any post without needing the post password. The ability for anonymous users to action their posts can be disabled on a per-board level.
file | file(s) | One or more files, multipart form data.
spoiler | array(string) | Array of sha256 hash of files to be spoilered.
spoiler_all | boolean | Whether to spoiler all files.
strip_filename | array(string) | Array of sha256 hash of files to have filenames stripped.. The sha256 hash will be used instead. Note: the server will still receive the original filenames before stripping.
customflag | string or null | Name of custom flag to be used. If null, will use no flag unless the board also has geoip flags enabled, then it will use the geo flag.
captcha | array(number) or string | See <a href='#captcha-block-bypass'>Captcha/block bypass</a>
signature | string | Signature output of a web3 eth personal_sign request with the content of the `message` parameter. Will add a signature and the recovered address to the bottom of the post.
## Post actions (delete, report, etc)
@ -1288,7 +1289,7 @@ checkedposts | array(number) | Array of `postId`'s to action against.
delete | boolean | Delete the selected posts.
spoiler | boolean | Spoiler all files in the selected posts.
unlink_file | boolean | Unlink files from the selected posts. If there are other copies of the file in other posts, or the global settings do not immediately prune unlinked files, the file may remain on disk.
postpassword | string | Password for anonymous users, the same one used to create the posts.
postpassword | string | Post password lets users action posts e.g. delete, spoiler, remove files after posting. It's useful to let anonymous users manage their own posts without requiring an account. Users can set it manually, or if they have JavaScript enabled one is randomly generated and stored in localstorage. If the post password is left empty, the post can only be actioned by staff. Staff can also action any post without needing the post password. The ability for anonymous users to action their posts can be disabled on a per-board level.
report | boolean | Report the selected posts to board staff.
global_report | boolean | Report the selected posts to global staff.
report_reason | string | Reason for reporting, if report or global_report.
@ -1324,7 +1325,7 @@ name | string | Name
message | string | Message
subject | string | Subject
email | string | Email, or special values such as 'sage'.
postpassword | string | Password required to delete the post later.
postpassword | string | Post password lets users action posts e.g. delete, spoiler, remove files after posting. It's useful to let anonymous users manage their own posts without requiring an account. Users can set it manually, or if they have JavaScript enabled one is randomly generated and storedin localstorage. If the post password is left empty, the post can only be actioned by staff. Staff can also action any post without needing the post password. The ability for anonymous users to action their posts can be disabled on a per-board level.
file | file(s) | One or more files, multipart form data.
spoiler | array(string) | Array of sha256 hash of files to be spoilered.
spoiler_all | boolean | Whether to spoiler all files.
spoiler | boolean | Spoiler all files in the selected posts.
unlink_file | boolean | Unlink files from the selected posts. If there are other copies of the file in other posts, or the global settings do not immediately prune unlinked files, the file may remain on disk.
delete_file | boolean | Forcefully delete files from the selected posts, ignoring other references or server settings for delayed file pruning.
postpassword | string | Password for anonymous users, the same one used to create the posts.
postpassword | string | Post password lets users action posts e.g. delete, spoiler, remove files after posting. It's useful to let anonymous users manage their own posts without requiring an account. Users can set it manually, or if they have JavaScript enabled one is randomly generated and stored in localstorage. If the post password is left empty, the post can only be actioned by staff. Staff can also action any post without needing the post password. The ability for anonymous users to action their posts can be disabled on a per-board level.
report | boolean | Report the selected posts to board staff.
global_report | boolean | Report the selected posts to global staff.
report_reason | string | Reason for reporting, if report or global_report.
@ -1442,6 +1443,12 @@ Returns a list of the most recent posts made on a specific board.
@ -2251,6 +2318,8 @@ postId | number | The post number, increasing by 1 for each post.
thread | number of null | For threads, null. For replies, a number equal to the `postId` of the thread.
email | string or null | The poster email. Not necessarily an email, can be any string or special values like "sage" meaning the post will not bump a thread.
spoiler | boolean | Whether all files in a post are spoilered.
signature | string or null | Web3 eth personal_sign signature of signed message content.
address | string or null | Recovered ethereum address from web3 signature.
banmessage | string or null | The public ban message attached to a post, optionally set when a staff member bans the poster without deleting the post.
userId | string or null | The user ID which is a substring of a hash of poster IP + server side per-thread secret e.g. substring(hash(poster IP + thread secret)).
files | array(<a href='#file'>File</a>) | Array of files, explained in the File subsection