JavaScript отключён. Чтобы полноценно использовать наш сайт, включите JavaScript в своём браузере.
key
string
The API attachment key
attachments
Attachment []
List of matching attachments.
key
string
The API attachment key to associated with
attachment
file
The attachment file
attachment
Attachment
The attachment record of the successful upload
attachment_key_user_wrong
Triggered if the user making the request does not match the user that created the attachment key.
type
string
The content type of the attachment. Default types include post, conversation_message. Add-ons may add more.
context
string[]
Key-value pairs representing the context of the attachment. This will vary depending on content type and the action being taken. See relevant actions for further details.
attachment
file
The first attachment to be associated with the new key.
key
string
The attachment key created. This should be used to upload additional files or to associate uploaded attachments with other content.
attachment
Attachment
If a file was provided and the upload was successful, this will describe the new attachment.
data
binary
The binary data is output directly, not JSON.
url
string
The URL to the thumbnail is returned via a 301 redirect's Location header.
not_found
Not found if the attachment does not have a thumbnail
login
string
The username or email address of the user to test
password
string
The password of the user
limit_ip
string
The IP that should be considered to be making the request. If provided, this will be used to prevent brute force attempts.
user
User
If successful, the user record of the matching user
conversation_id
integer
message
string
attachment_key
string
API attachment key to upload files. Attachment key content type must be conversation_message with context[conversation_id] set to this conversation ID.
message
string
The new message content
attachment_key
string
API attachment key to upload files. Attachment key content type must be conversation_message with context[message_id] set to this message ID.
reaction_id
integer
ID of the reaction to use. Use the current reaction ID to undo.
success
true
action
string
"insert" or "delete" based on whether the reaction was added or removed.
recipient_ids
integer[]
List of user IDs to send the conversation to
title
string
Conversation title
message
string
Conversation message body
attachment_key
string
API attachment key to upload files. Attachment key content type must be conversation_message with no context.
conversation_open
bool
If false, no replies may be made to this conversation.
open_invite
bool
If true, any member of the conversation may add others
with_messages
bool
If specified, the response will include a page of messages.
page
integer
The page of messages to include
title
string
Conversation title
open_invite
bool
If true, any member of the conversation can add others
conversation_open
bool
If false, no further replies are allowed.
ignore
bool
If true, further replies to this conversation will be ignored. (Otherwise, replies will restore this conversation to the list.)
recipient_ids
integer[]
List of user IDs to invite
messages
ConversationMessage []
List of messages on the requested page
pagination
pagination
Pagination details
star
bool
If provided, sets the star status as specified. If not provided, toggles the status.
with_threads
bool
If true, gets a page of threads in this forum
page
integer
forum
Forum
threads
Thread []
Threads on this page
pagination
pagination
Pagination information
sticky
Thread []
If on page 1, a list of sticky threads in this forum. Does not count towards the per page limit.
threads
Thread []
Threads on this page
pagination
pagination
Pagination information
sticky
Thread []
If on page 1, a list of sticky threads in this forum. Does not count towards the per page limit.
version_id
integer
XenForo version ID
site_title
string
Title of the site this API relates to
base_url
string
The base URL of the XenForo install this API relates to
api_url
string
The base API URL
key[type]
string
Type of the API key accessing the API (guest, user or super)
key[user_id]
integer|null
If a user key, the ID of the user the key is for; null otherwise
key[allow_all_scopes]
bool
If true, all scopes can be accessed
key[scopes]
string[]
A list of scopes this key can access (if not allowed to access all scopes)
option[creation_watch_state]
string
option[interaction_watch_state]
string
option[content_show_signature]
bool
option[email_on_conversation]
bool
option[push_on_conversation]
bool
option[receive_admin_email]
bool
option[show_dob_year]
bool
option[show_dob_date]
bool
profile[location]
string
profile[website]
string
profile[about]
string
profile[signature]
string
privacy[allow_view_profile]
string
privacy[allow_post_profile]
string
privacy[allow_receive_news_feed]
string
privacy[allow_send_personal_conversation]
string
privacy[allow_view_identities]
string
visible
bool
activity_visible
bool
timezone
string
custom_title
string
custom_fields[<name>]
string
avatar
file
The uploaded new avatar
current_password
string
email
string
success
true
confirmation_required
bool
True if email confirmation is required for this change
current_password
string
new_password
string
tree_map
array
A mapping that connects node parent IDs to a list of their child node IDs
nodes
Node []
List of all nodes
node[title]
string
node[node_name]
string
node[description]
string
node[parent_node_id]
integer
node[display_order]
integer
type_data
array
Type-specific node data. The available options will vary based on the node type involved.
node_type_id
string
node
Node
Information about the created node
nodes_flat
array
An array. Each entry contains keys of "node" and "depth"
node[title]
string
node[node_name]
string
node[description]
string
node[parent_node_id]
integer
node[display_order]
integer
type_data
array
Type-specific node data. The available options will vary based on the node type involved.
node
Node
The updated node information
delete_children
bool
If true, child nodes will be deleted. Otherwise, they will be connected to this node's parent.
thread_id
integer
ID of the thread to reply to.
message
string
attachment_key
string
API attachment key to upload files. Attachment key context type must be post with context[thread_id] set to this thread ID.
message
string
silent
bool
If true and permissions allow, this edit will not be updated with a "last edited" indication
clear_edit
bool
If true and permissions allow, any "last edited" indication will be removed. Requires "silent".
author_alert
bool
author_alert_reason
string
attachment_key
string
API attachment key to upload files. Attachment key context type must be post with context[post_id] set to this post ID.
hard_delete
bool
reason
string
author_alert
bool
author_alert_reason
string
reaction_id
integer
ID of the reaction to use. Use the current reaction ID to undo.
success
true
action
string
"insert" or "delete" based on whether the reaction was added or removed.
profile_post_id
integer
The ID of the profile post this comment will be attached to.
message
string
message
string
author_alert
bool
author_alert_reason
bool
hard_delete
bool
reason
string
author_alert
bool
author_alert_reason
string
reaction_id
integer
ID of the reaction to use. Use the current reaction ID to undo.
success
true
action
string
"insert" or "delete" based on whether the reaction was added or removed.
user_id
integer
The ID of the user whose profile this will be posted on.
with_comments
bool
If specified, the response will include a page of comments.
page
integer
The page of comments to include
message
string
author_alert
bool
author_alert_reason
bool
hard_delete
bool
reason
string
author_alert
bool
author_alert_reason
string
comments
ProfilePostComment []
List of comments on the requested page
pagination
pagination
Pagination details
reaction_id
integer
ID of the reaction to use. Use the current reaction ID to undo.
success
true
action
string
"insert" or "delete" based on whether the reaction was added or removed.
threads
Thread []
pagination
pagination
node_id
integer
ID of the forum to create the thread in.
title
string
Title of the thread.
message
string
Body of the first post in the thread.
prefix_id
integer
ID of the prefix to apply to the thread. If not valid in the selected forum, will be ignored.
tags
string[]
Array of tag names to apply to the thread.
custom_fields[<name>]
string
Value to apply to the custom field with the specified name.
discussion_open
bool
sticky
bool
attachment_key
string
API attachment key to upload files. Attachment key context type must be post with context[node_id] set to the ID of the forum this is being posted in.
no_permission
No permission error.
with_posts
bool
If specified, the response will include a page of posts.
page
integer
The page of posts to include
thread
Thread
posts
Post []
List of posts on the requested page
pagination
pagination
Pagination details
prefix_id
integer
title
string
discussion_open
bool
sticky
bool
custom_fields[<name>]
string
add_tags
array
remove_tags
array
hard_delete
bool
reason
string
starter_alert
bool
starter_alert_reason
string
posts
Post []
List of posts on the requested page
pagination
pagination
Pagination details
users
User []
pagination
pagination
option[creation_watch_state]
string
option[interaction_watch_state]
string
option[content_show_signature]
bool
option[email_on_conversation]
bool
option[push_on_conversation]
bool
option[receive_admin_email]
bool
option[show_dob_year]
bool
option[show_dob_date]
bool
profile[location]
string
profile[website]
string
profile[about]
string
profile[signature]
string
privacy[allow_view_profile]
string
privacy[allow_post_profile]
string
privacy[allow_receive_news_feed]
string
privacy[allow_send_personal_conversation]
string
privacy[allow_view_identities]
string
visible
bool
activity_visible
bool
timezone
string
custom_title
string
option[is_discouraged]
bool
username
string
email
string
user_group_id
integer
secondary_group_ids
integer[]
user_state
string
is_staff
bool
message_count
integer
reaction_score
integer
trophy_points
integer
password
string
dob[day]
integer
dob[month]
integer
dob[year]
integer
custom_fields[<name>]
string
username
string
[required]
exact
User |null
The user that matched the given username exactly
recommendations
User []
A list of users that match the prefix of the username (but not exactly)
with_posts
bool
If specified, the response will include a page of profile posts.
page
integer
The page of comments to include
user
User
profile_posts
ProfilePost []
List of profile posts on the requested page
pagination
pagination
Pagination details
option[creation_watch_state]
string
option[interaction_watch_state]
string
option[content_show_signature]
bool
option[email_on_conversation]
bool
option[push_on_conversation]
bool
option[receive_admin_email]
bool
option[show_dob_year]
bool
option[show_dob_date]
bool
profile[location]
string
profile[website]
string
profile[about]
string
profile[signature]
string
privacy[allow_view_profile]
string
privacy[allow_post_profile]
string
privacy[allow_receive_news_feed]
string
privacy[allow_send_personal_conversation]
string
privacy[allow_view_identities]
string
visible
bool
activity_visible
bool
timezone
string
custom_title
string
option[is_discouraged]
bool
username
string
email
string
user_group_id
integer
secondary_group_ids
integer[]
user_state
string
is_staff
bool
message_count
integer
reaction_score
integer
trophy_points
integer
password
string
dob[day]
integer
dob[month]
integer
dob[year]
integer
custom_fields[<name>]
string
rename_to
string
If specified, the user will be renamed before deletion
avatar
file
The uploaded new avatar
profile_posts
ProfilePost []
List of profile posts on the requested page
pagination
pagination
Pagination details
filename
string
file_size
integer
height
integer
width
integer
thumbnail_url
string
video_url
string
attachment_id
integer
content_type
string
content_id
integer
attach_date
integer
view_count
integer
username
string
Name of the user that started the conversation
recipients
object
Key-value pair of recipient user IDs and names
is_starred
bool
True if the viewing user starred the conversation
can_edit
bool
can_reply
bool
can_invite
bool
can_upload_attachment
bool
conversation_id
integer
title
string
user_id
integer
start_date
integer
open_invite
bool
conversation_open
bool
reply_count
integer
recipient_count
integer
first_message_id
integer
last_message_date
integer
last_message_id
integer
last_message_user_id
integer
Starter
User
username
string
can_edit
bool
can_react
bool
Conversation
Conversation
If requested by context, the conversation this message is part of.
Attachments
Attachment []
If there are attachments to this message, a list of attachments.
is_reacted_to
bool
True if the viewing user has reacted to this content
visitor_reaction_id
integer
If the viewer reacted, the ID of the reaction they used
message_id
integer
conversation_id
integer
message_date
integer
user_id
integer
message
string
attach_count
integer
reaction_score
integer
User
User
allow_posting
bool
allow_poll
bool
require_prefix
bool
min_tags
integer
link_url
string
redirect_count
integer
breadcrumbs
array
A list of breadcrumbs for this node, including the node_id, title, and node_type_id
type_data
object
Data related to the specific node type this represents. Contents will vary significantly.
node_id
integer
title
string
node_name
string
description
string
node_type_id
string
parent_node_id
integer
display_order
integer
display_in_list
bool
publish_date
integer
view_count
integer
username
string
is_first_post
bool
is_last_post
bool
can_edit
bool
can_soft_delete
bool
can_hard_delete
bool
can_react
bool
can_view_attachments
bool
Thread
Thread
If requested by context, the thread this post is part of.
Attachments
Attachment []
Attachments to this post, if it has any.
is_reacted_to
bool
True if the viewing user has reacted to this content
visitor_reaction_id
integer
If the viewer reacted, the ID of the reaction they used
post_id
integer
thread_id
integer
user_id
integer
post_date
integer
message
string
message_state
string
attach_count
integer
warning_message
string
position
integer
last_edit_date
integer
reaction_score
integer
User
User
username
string
can_edit
bool
can_soft_delete
bool
can_hard_delete
bool
can_react
bool
ProfileUser
User
If requested by context, the user this profile post was left for.
LatestComments
ProfilePostComment []
If requested, the most recent comments on this profile post.
is_reacted_to
bool
True if the viewing user has reacted to this content
visitor_reaction_id
integer
If the viewer reacted, the ID of the reaction they used
profile_post_id
integer
profile_user_id
integer
user_id
integer
post_date
integer
message
string
message_state
string
warning_message
string
comment_count
integer
first_comment_date
integer
last_comment_date
integer
reaction_score
integer
User
User
username
string
can_edit
bool
can_soft_delete
bool
can_hard_delete
bool
can_react
bool
ProfilePost
ProfilePost
If requested by context, the profile post this comment relates to.
is_reacted_to
bool
True if the viewing user has reacted to this content
visitor_reaction_id
integer
If the viewer reacted, the ID of the reaction they used
profile_post_comment_id
integer
profile_post_id
integer
user_id
integer
comment_date
integer
message
string
message_state
string
warning_message
string
reaction_score
integer
User
User
username
string
is_watching
bool
If accessing as a user, true if they are watching this thread
visitor_post_count
integer
If accessing as a user, the number of posts they have made in this thread
custom_fields
object
Key-value pairs of custom field values for this thread
tags
array
prefix
string
Present if this thread has a prefix. Printable name of the prefix.
can_edit
bool
can_edit_tags
bool
can_reply
bool
can_soft_delete
bool
can_hard_delete
bool
can_view_attachments
bool
Forum
Node
If requested by context, the forum this thread was posted in.
thread_id
integer
node_id
integer
title
string
reply_count
integer
view_count
integer
user_id
integer
post_date
integer
sticky
bool
discussion_state
string
discussion_open
bool
discussion_type
string
first_post_id
integer
last_post_date
integer
last_post_id
integer
last_post_user_id
integer
last_post_username
string
first_post_reaction_score
integer
prefix_id
integer
User
User
field_id
string
title
string
description
string
display_order
integer
field_type
string
field_choices
object
For choice types, an ordered list of choices, with "option" and "name" keys for each.
match_type
string
match_params
array
max_length
integer
required
bool
display_group
string
If this field type supports grouping, the group this field belongs to.
prefix_id
integer
title
string
is_usable
bool
True if the acting user can use (select) this prefix.
prefix_group_id
integer
display_order
integer
materialized_order
integer
Effective order, taking group ordering into account.
about
string
activity_visible
bool
age
integer
The user's current age. Only included if available.
alert_optout
array
allow_post_profile
string
allow_receive_news_feed
string
allow_send_personal_conversation
string
allow_view_identities
string
allow_view_profile
string
avatar_urls
object
Maps from size types to URL.
can_ban
bool
can_converse
bool
can_edit
bool
can_follow
bool
can_ignore
bool
can_post_profile
bool
can_view_profile
bool
can_view_profile_posts
bool
can_warn
bool
content_show_signature
bool
creation_watch_state
string
custom_fields
object
Map of custom field keys and values.
custom_title
string
Will have a value if a custom title has been specifically set; prefer user_title instead.
dob
object
Date of birth with year, month and day keys.
email
string
email_on_conversation
bool
gravatar
string
interaction_watch_state
bool
is_admin
bool
is_banned
bool
is_discouraged
bool
is_followed
bool
True if the visitor is following this user. Only included if visitor is not a guest.
is_ignored
bool
True if the visitor is ignoring this user. Only included if visitor is not a guest.
is_moderator
bool
is_super_admin
bool
last_activity
integer
Unix timestamp of user's last activity, if available.
location
string
push_on_conversation
bool
push_optout
array
receive_admin_email
bool
secondary_group_ids
array
show_dob_date
bool
show_dob_year
bool
signature
string
timezone
string
use_tfa
array
user_group_id
integer
user_state
string
user_title
string
visible
bool
warning_points
integer
Current warning points.
website
string
user_id
integer
username
string
message_count
integer
register_date
integer
trophy_points
integer
is_staff
bool
reaction_score
integer
field_id
string
title
string
description
string
display_order
integer
field_type
string
field_choices
object
For choice types, an ordered list of choices, with "option" and "name" keys for each.
match_type
string
match_params
array
max_length
integer
required
bool
display_group
string
If this field type supports grouping, the group this field belongs to.