.
*
@@ -21,20 +21,109 @@
package es.cadox8.xenapi;
-import es.cadox8.xenapi.api.Me;
-import es.cadox8.xenapi.api.User;
+import de.jupf.staticlog.Log;
+import de.jupf.staticlog.core.LogLevel;
+import es.cadox8.xenapi.api.commons.Errors;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.ApiResponse;
+import es.cadox8.xenapi.net.Response;
+import es.cadox8.xenapi.net.XenForoClient;
+import es.cadox8.xenapi.updater.UpdateChecker;
+import es.cadox8.xenapi.utils.Utils;
+import es.cadox8.xenapi.utils.Version;
+import lombok.NonNull;
+import org.apache.hc.core5.http.NameValuePair;
-public interface XenAPI {
+import java.io.File;
+import java.util.ArrayList;
+import java.util.List;
+
+public class XenAPI {
+
+ private final XenForoClient client;
+ private final String url;
+
+
+ /**
+ * Constructor for the XenAPI Builder
+ *
+ * @param url the url where XenForo is installed at
+ * @param token The token you have to access
+ *
+ * You need to pass the user param if the token is for superuser
+ */
+ public XenAPI(final String url, final String token) {
+ this(url, token, -1);
+ }
+
+
+ /**
+ * Constructor for the XenAPI Builder
+ *
+ * @param url the url where XenForo is installed at
+ * @param token The token you have to access
+ * @param user_id The user of the generated token
+ *
+ * You need to pass the user param if the token is for superuser
+ */
+ public XenAPI(final String url, final String token, int user_id) {
+ this.url = url.contains("/api") ? url : url + "/api";
+ this.client = new XenForoClient(token, user_id);
+
+ this.enableDebug(false);
+
+ final Version version = new Version(2, 0, 0, "10-SNAPSHOT");
+ final UpdateChecker updateChecker = new UpdateChecker(version, true);
+ updateChecker.sendVersionUpdate();
+ updateChecker.scheduleCheckVersion();
+
+ Log.info("Started XenAPI client! Version: " + version, "XenforoClient");
+ }
/**
- * Gets the info about the current user (token user)
+ * Sets the library to debug mode to see all logs. By default, this is False
*
- * @return The user information
- * @see User
+ * @param debug true/false
*/
- Me me();
+ public void enableDebug(boolean debug) {
+ Log.setLogLevel(debug ? LogLevel.DEBUG : LogLevel.INFO);
+ }
+
+ /**
+ * Method to send the request to the XenForo API
+ *
+ * @param request The ApiRequest Class
+ * @param The ApiResponse Class from the ApiRequest
+ * @return If success, the ApiResponse Class, if error an #Errors class with the errors from XenForo
+ * @see Response
+ * @see Errors
+ */
+ public Response send(@NonNull final ApiRequest request) {
+ final String url = Utils.createUrl(this.url, request.getPath());
+
+ final List realParams = new ArrayList<>();
+ switch (request.getMethod()) {
+ case GET: {
+ request.params().forEach(p -> realParams.add(p.generate()));
+ return this.client.get(url, request.response(), request.query(), realParams);
+ }
+ case POST: {
+ request.body().forEach(p -> realParams.add(p.generate()));
- User findUserById();
+ if (request.containsFile()) {
+ final File file = (File) request.params().get(0).getValue();
+ return this.client.postFile(url, request.response(), request.query(), realParams, file);
+ }
- User findUserById(int id);
+ return this.client.post(url, request.response(), request.query(), realParams);
+ }
+/* case PUT:
+ return client.putForObject(url, request.getBody(), request.getResponseType(), request.getQueryParams());*/
+ case DELETE:
+ request.body().forEach(p -> realParams.add(p.generate()));
+ return this.client.delete(url, request.response(), request.query(), realParams);
+ default:
+ throw new IllegalArgumentException("Unsupported HTTP method: " + request.getMethod());
+ }
+ }
}
diff --git a/src/es/cadox8/xenapi/XenAPIBuilder.java b/src/es/cadox8/xenapi/XenAPIBuilder.java
deleted file mode 100644
index 0a81519..0000000
--- a/src/es/cadox8/xenapi/XenAPIBuilder.java
+++ /dev/null
@@ -1,113 +0,0 @@
-/*
- * Copyright (c) 2021.
- *
- * This file is part of XenAPI .
- *
- * XenAPI is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Lesser General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * XenAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this program. If not, see or
- */
-
-package es.cadox8.xenapi;
-
-import es.cadox8.xenapi.api.Me;
-import es.cadox8.xenapi.api.User;
-import es.cadox8.xenapi.api.XenForoEntity;
-import es.cadox8.xenapi.net.XenForoClient;
-import es.cadox8.xenapi.net.XenForoUrl;
-
-import java.io.File;
-import java.util.Arrays;
-import java.util.List;
-import java.util.function.Supplier;
-import java.util.stream.Collectors;
-
-public class XenAPIBuilder implements XenAPI {
-
- private final XenForoClient httpClient;
- private final String url;
-
- /**
- * Constructor for the XenAPI Builder
- *
- * @param url the url where XenForo is installed at
- * @param token The token you have to access
- */
- public XenAPIBuilder(String url, String token) {
- this(url, token, "");
- }
-
- /**
- * Constructor for the XenAPI Builder
- *
- * @param url the url where XenForo is installed at
- * @param token The token you have to access
- * @param user The user of the generated token
- *
- * You need to pass the user param if the token is for superuser
- */
- public XenAPIBuilder(String url, String token, String user) {
- this.url = url + "/api";
- this.httpClient = new XenForoClient(token, user);
- }
-
- //
-
- @Override
- public Me me() {
- final Me me = get(XenForoUrl.createUrl(this.url, XenForoUrl.GET_ME), Me.class);
- me.setInternalXenAPI(this);
- return me;
- }
-
- @Override
- public User findUserById() {
- final User user = get(XenForoUrl.createUrl(this.url, XenForoUrl.GET_USERS), User.class);
- user.setInternalXenAPI(this);
- return user;
- }
-
- @Override
- public User findUserById(int id) {
- final User user = get(XenForoUrl.createUrl(this.url, XenForoUrl.GET_USERS_ID), User.class, String.valueOf(id));
- user.setInternalXenAPI(this);
- return user;
- }
-
- /* internal methods */
-
- private T postFileForObject(String url, File file, Class objectClass, String... params) {
- return httpClient.postFileForObject(url, file, objectClass, params);
- }
-
- private T post(String url, Object object, Class objectClass, String... params) {
- return httpClient.postForObject(url, object, objectClass, params);
- }
-
- private T get(String url, Class objectClass, String... params) {
- return httpClient.get(url, objectClass, params);
- }
-
- private T put(String url, Object object, Class objectClass, String... params) {
- return httpClient.putForObject(url, object, objectClass, params);
- }
-
- private T delete(String url, Class responseType, String... params) {
- return httpClient.delete(url, responseType, params);
- }
-
- private List asList(Supplier responseSupplier) {
- return Arrays.stream(responseSupplier.get()).peek(t -> t.setInternalXenAPI(this)).collect(Collectors.toList());
- }
-}
diff --git a/src/es/cadox8/xenapi/api/Me.java b/src/es/cadox8/xenapi/api/Me.java
deleted file mode 100644
index 170bfa1..0000000
--- a/src/es/cadox8/xenapi/api/Me.java
+++ /dev/null
@@ -1,39 +0,0 @@
-/*
- * Copyright (c) 2021-2021.
- *
- * This file is part of XenAPI .
- *
- * XenAPI is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Lesser General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * XenAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this program. If not, see or
- */
-
-package es.cadox8.xenapi.api;
-
-import es.cadox8.xenapi.api.user.AvatarUrls;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-
-import java.util.Date;
-import java.util.Map;
-
-@EqualsAndHashCode(callSuper = true)
-@Data
-public class Me extends User {
-
- public Me(String about, boolean activity_visible, int age, Object[] alert_optout, String allow_post_profile, String allow_receive_news_feed, String allow_send_personal_conversation, String allow_view_identities, String allow_view_profile, AvatarUrls[] avatar_urls, Object[] profile_banner_urls, boolean can_ban, boolean can_converse, boolean can_edit, boolean can_follow, boolean can_ignore, boolean can_post_profile, boolean can_view_profile, boolean can_view_profile_posts, boolean can_warn, boolean content_show_signature, String creation_watch_state, Map custom_fields, String custom_title, Date dob, String email, boolean email_on_conversation, String gravatar, boolean interaction_watch_state, boolean is_admin, boolean is_banned, boolean is_discouraged) {
- super(about, activity_visible, age, alert_optout, allow_post_profile, allow_receive_news_feed, allow_send_personal_conversation, allow_view_identities, allow_view_profile, avatar_urls, profile_banner_urls, can_ban, can_converse, can_edit, can_follow, can_ignore, can_post_profile, can_view_profile, can_view_profile_posts, can_warn, content_show_signature, creation_watch_state, custom_fields, custom_title, dob, email, email_on_conversation, gravatar, interaction_watch_state, is_admin, is_banned, is_discouraged);
- }
-}
diff --git a/src/es/cadox8/xenapi/api/User.java b/src/es/cadox8/xenapi/api/User.java
deleted file mode 100644
index 7219537..0000000
--- a/src/es/cadox8/xenapi/api/User.java
+++ /dev/null
@@ -1,78 +0,0 @@
-/*
- * Copyright (c) 2021.
- *
- * This file is part of XenAPI .
- *
- * XenAPI is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Lesser General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * XenAPI is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this program. If not, see or
- */
-
-package es.cadox8.xenapi.api;
-
-import es.cadox8.xenapi.api.user.AvatarUrls;
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-
-import java.util.Date;
-import java.util.Map;
-
-/**
- * User class
- */
-@EqualsAndHashCode(callSuper = true)
-@Data
-@AllArgsConstructor
-public class User extends XenForoEntity {
-
- private String about;
- private boolean activity_visible;
- private int age;
- private Object[] alert_optout;
- private String allow_post_profile;
- private String allow_receive_news_feed;
- private String allow_send_personal_conversation;
- private String allow_view_identities;
- private String allow_view_profile;
-
- private AvatarUrls[] avatar_urls;
- private Object[] profile_banner_urls;
-
- private boolean can_ban;
- private boolean can_converse;
- private boolean can_edit;
- private boolean can_follow;
- private boolean can_ignore;
- private boolean can_post_profile;
- private boolean can_view_profile;
- private boolean can_view_profile_posts;
- private boolean can_warn;
- private boolean content_show_signature;
-
- private String creation_watch_state;
- private Map custom_fields;
- private String custom_title;
- private Date dob;
-
- private String email;
- private boolean email_on_conversation;
-
- private String gravatar;
-
- private boolean interaction_watch_state;
- private boolean is_admin;
- private boolean is_banned;
- private boolean is_discouraged;
-}
diff --git a/src/es/cadox8/xenapi/api/alerts/AlertResponse.java b/src/es/cadox8/xenapi/api/alerts/AlertResponse.java
new file mode 100644
index 0000000..3e6e4f1
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/AlertResponse.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class AlertResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("action")
+ private String action;
+ @Expose
+ @SerializedName("alert_id")
+ private int alertId;
+ @Expose
+ @SerializedName("alert_text")
+ private String alertText;
+ @Expose
+ @SerializedName("alert_url")
+ private String alertUrl;
+ @Expose
+ @SerializedName("alerted_user_id")
+ private int alertedUserId;
+ @Expose
+ @SerializedName("auto_read")
+ private boolean autoRead;
+ @Expose
+ @SerializedName("content_id")
+ private int contentId;
+ @Expose
+ @SerializedName("content_type")
+ private String contentType;
+ @Expose
+ @SerializedName("event_date")
+ private long eventDate;
+ @Expose
+ @SerializedName("read_date")
+ private long readDate;
+ @Expose
+ @SerializedName("User")
+ private UserResponse user;
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+ @Expose
+ @SerializedName("username")
+ private String username;
+ @Expose
+ @SerializedName("view_date")
+ private long viewDate;
+}
\ No newline at end of file
diff --git a/src/es/cadox8/xenapi/api/alerts/AllAlertResponse.java b/src/es/cadox8/xenapi/api/alerts/AllAlertResponse.java
new file mode 100644
index 0000000..b9475b7
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/AllAlertResponse.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.commons.Pagination;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+public class AllAlertResponse implements ApiResponse {
+ @SerializedName("alerts")
+ @Expose
+ private List alerts;
+
+ @SerializedName("pagination")
+ @Expose
+ private Pagination pagination;
+}
diff --git a/src/es/cadox8/xenapi/api/alerts/GetAlerts.java b/src/es/cadox8/xenapi/api/alerts/GetAlerts.java
new file mode 100644
index 0000000..433f2c9
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/GetAlerts.java
@@ -0,0 +1,92 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class GetAlerts implements ApiRequest {
+
+ /**
+ *
+ */
+ private final int page;
+ /**
+ * Unix timestamp of the oldest alert to include. Note that unread or unviewed alerts are always included.
+ */
+ private final int cutoff;
+ /**
+ * If true, gets only unviewed alerts. Unviewed alerts have not been seen (in the standard UI).
+ */
+ private final boolean unviewed;
+ /**
+ * If true, gets only unread alerts. Unread alerts may have been seen but the content they relate to has not been viewed.
+ */
+ private final boolean unread;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ALERTS;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.GET;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ final List params = new ArrayList<>();
+
+ if (this.cutoff > 0)
+ params.add(new XenNameValuePair("cutoff", this.cutoff));
+
+ if (this.page > 0)
+ params.add(new XenNameValuePair("page", this.page));
+
+ params.add(new XenNameValuePair("unviewed", this.unviewed));
+ params.add(new XenNameValuePair("unread", this.unread));
+ return params;
+ }
+
+ @Override
+ public List body() {
+ return new ArrayList<>();
+ }
+
+ @Override
+ public Class response() {
+ return AllAlertResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/alerts/GetOneAlert.java b/src/es/cadox8/xenapi/api/alerts/GetOneAlert.java
new file mode 100644
index 0000000..4d778c7
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/GetOneAlert.java
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class GetOneAlert implements ApiRequest {
+
+ private final int id;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ALERT;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.GET;
+ }
+
+ @Override
+ public Object query() {
+ return this.id;
+ }
+
+ @Override
+ public List params() {
+ return new ArrayList<>();
+ }
+
+ @Override
+ public List body() {
+ return new ArrayList<>();
+ }
+
+ @Override
+ public Class response() {
+ return OneAlertResponse.class;
+ }
+}
\ No newline at end of file
diff --git a/src/es/cadox8/xenapi/api/alerts/MarkAllAlerts.java b/src/es/cadox8/xenapi/api/alerts/MarkAllAlerts.java
new file mode 100644
index 0000000..4809339
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/MarkAllAlerts.java
@@ -0,0 +1,76 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import es.cadox8.xenapi.api.commons.Success;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class MarkAllAlerts implements ApiRequest {
+
+ private final boolean read;
+ private final boolean viewed;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ALERTS_MARK;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List params = new ArrayList<>();
+
+ if (this.read)
+ params.add(new XenNameValuePair("read", true));
+ if (this.viewed)
+ params.add(new XenNameValuePair("viewed", true));
+
+ return params;
+ }
+
+ @Override
+ public Class response() {
+ return Success.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/alerts/MarkOneAlert.java b/src/es/cadox8/xenapi/api/alerts/MarkOneAlert.java
new file mode 100644
index 0000000..a7601a6
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/MarkOneAlert.java
@@ -0,0 +1,81 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import es.cadox8.xenapi.api.commons.Success;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class MarkOneAlert implements ApiRequest {
+
+ private final String id;
+
+ private final boolean read;
+ private final boolean unread;
+ private final boolean viewed;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ALERT_MARK;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return this.id;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List params = new ArrayList<>();
+
+ if (this.read)
+ params.add(new XenNameValuePair("read", true));
+ if (this.unread)
+ params.add(new XenNameValuePair("unread", true));
+ if (this.viewed)
+ params.add(new XenNameValuePair("viewed", true));
+
+ return params;
+ }
+
+ @Override
+ public Class response() {
+ return Success.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/alerts/OneAlertResponse.java b/src/es/cadox8/xenapi/api/alerts/OneAlertResponse.java
new file mode 100644
index 0000000..18f76a3
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/OneAlertResponse.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class OneAlertResponse implements ApiResponse {
+ @SerializedName("alert")
+ @Expose
+ private AlertResponse alert;
+}
diff --git a/src/es/cadox8/xenapi/api/alerts/PostAlert.java b/src/es/cadox8/xenapi/api/alerts/PostAlert.java
new file mode 100644
index 0000000..22cc236
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/alerts/PostAlert.java
@@ -0,0 +1,96 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.alerts;
+
+import es.cadox8.xenapi.api.commons.Success;
+import es.cadox8.xenapi.exceptions.XenForoMissingArgsException;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class PostAlert implements ApiRequest {
+
+ /**
+ * Required. ID of the user to receive the alert
+ */
+ @Builder.Default private final int to_user_id = -1;
+ /**
+ * Required. Text of the alert. May use the placeholder "{link}" to have the link automatically inserted.
+ */
+ @Builder.Default private final String alert = "";
+ /**
+ * If provided, the user to send the alert from. Otherwise, uses the current API user. May be 0 for an anonymous alert.
+ */
+ private final int from_user_id;
+ private final String link_url;
+ private final String link_title;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ALERTS;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List params = new ArrayList<>();
+
+ if (this.to_user_id == -1 || this.alert.isEmpty())
+ throw new XenForoMissingArgsException("to_user_id or alert!");
+
+ params.add(new XenNameValuePair("to_user_id", this.to_user_id));
+ params.add(new XenNameValuePair("alert", this.alert));
+ params.add(new XenNameValuePair("from_user_id", this.from_user_id));
+
+ if (this.link_url != null)
+ params.add(new XenNameValuePair("link_url", this.link_url));
+ if (this.link_title != null)
+ params.add(new XenNameValuePair("link_title", this.link_title));
+
+ return params;
+ }
+
+ @Override
+ public Class response() {
+ return Success.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/AllAttachmentResponse.java b/src/es/cadox8/xenapi/api/attachment/AllAttachmentResponse.java
new file mode 100644
index 0000000..06b673c
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/AllAttachmentResponse.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2024-2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+
+@Getter
+@ToString
+public class AllAttachmentResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("attachments")
+ private List attachments;
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/AttachmentResponse.java b/src/es/cadox8/xenapi/api/attachment/AttachmentResponse.java
new file mode 100644
index 0000000..e8d024f
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/AttachmentResponse.java
@@ -0,0 +1,85 @@
+/*
+ * Copyright (c) 2024-2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+@Getter
+@ToString
+public class AttachmentResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("filename")
+ private String filename;
+
+ @Expose
+ @SerializedName("file_size")
+ private int fileSize;
+
+ @Expose
+ @SerializedName("height")
+ private int height;
+
+ @Expose
+ @SerializedName("width")
+ private int width;
+
+ @Expose
+ @SerializedName("thumbnail_url")
+ private String thumbnailUrl;
+
+ @Expose
+ @SerializedName("direct_url")
+ private String directUrl;
+
+ @Expose
+ @SerializedName("is_video")
+ private boolean isVideo;
+
+ @Expose
+ @SerializedName("is_audio")
+ private boolean isAudio;
+
+ @Expose
+ @SerializedName("attachment_id")
+ private int attachmentId;
+
+ @Expose
+ @SerializedName("content_type")
+ private String contentType;
+
+ @Expose
+ @SerializedName("content_id")
+ private int contentId;
+
+ @Expose
+ @SerializedName("attach_date")
+ private int attachDate;
+
+ @Expose
+ @SerializedName("view_count")
+ private int viewCount;
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/GetAttachments.java b/src/es/cadox8/xenapi/api/attachment/GetAttachments.java
new file mode 100644
index 0000000..67ccc3a
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/GetAttachments.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.util.List;
+
+@Builder
+public class GetAttachments implements ApiRequest {
+
+ private final String key;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ATTACHMENTS;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.GET;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of(new XenNameValuePair("key", this.key));
+ }
+
+ @Override
+ public List body() {
+ return List.of();
+ }
+
+ @Override
+ public Class response() {
+ return AllAttachmentResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/NewKeyAttachment.java b/src/es/cadox8/xenapi/api/attachment/NewKeyAttachment.java
new file mode 100644
index 0000000..e9e15d1
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/NewKeyAttachment.java
@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+public class NewKeyAttachment {
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/OneAttachmentResponse.java b/src/es/cadox8/xenapi/api/attachment/OneAttachmentResponse.java
new file mode 100644
index 0000000..1bdac57
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/OneAttachmentResponse.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2024-2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+@Getter
+@ToString
+public class OneAttachmentResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("attachment")
+ private AttachmentResponse attachment;
+}
diff --git a/src/es/cadox8/xenapi/api/attachment/UploadAttachment.java b/src/es/cadox8/xenapi/api/attachment/UploadAttachment.java
new file mode 100644
index 0000000..5751d9f
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/attachment/UploadAttachment.java
@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.attachment;
+
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import lombok.Builder;
+
+import java.io.File;
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class UploadAttachment implements ApiRequest {
+
+ private final String key;
+ private final File attachment;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.ATTACHMENTS;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List body = new ArrayList<>();
+ body.add(new XenNameValuePair("key", this.key));
+ body.add(new XenNameValuePair("attachment", this.attachment));
+ return body;
+ }
+
+ @Override
+ public Class response() {
+ return OneAttachmentResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/auth/AuthTokenResponse.java b/src/es/cadox8/xenapi/api/auth/AuthTokenResponse.java
new file mode 100644
index 0000000..8ef8765
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/auth/AuthTokenResponse.java
@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.auth;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class AuthTokenResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("login_token")
+ private String loginToken;
+
+ @Expose
+ @SerializedName("login_url")
+ private String loginUrl;
+
+ @Expose
+ @SerializedName("expiry_date")
+ private Integer expiryDate;
+}
diff --git a/src/es/cadox8/xenapi/api/auth/PostAuth.java b/src/es/cadox8/xenapi/api/auth/PostAuth.java
new file mode 100644
index 0000000..acac898
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/auth/PostAuth.java
@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.auth;
+
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class PostAuth implements ApiRequest {
+
+ private final String login;
+ private final String password;
+ private final String limit_ip;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.AUTH;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List body = new ArrayList<>();
+
+ body.add(new XenNameValuePair("login", this.login));
+ body.add(new XenNameValuePair("password", this.password));
+
+ if (this.limit_ip != null)
+ body.add(new XenNameValuePair("limit_ip", this.limit_ip));
+
+ return body;
+ }
+
+ @Override
+ public Class response() {
+ return UserResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/auth/PostAuthSession.java b/src/es/cadox8/xenapi/api/auth/PostAuthSession.java
new file mode 100644
index 0000000..fad5bc3
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/auth/PostAuthSession.java
@@ -0,0 +1,80 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.auth;
+
+import es.cadox8.xenapi.exceptions.XenForoMissingArgsException;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class PostAuthSession implements ApiRequest {
+
+ private final String sessionId;
+ private final String rememberCookie;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.AUTH_SESSION;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List list = new ArrayList<>();
+
+ if (this.sessionId == null || this.sessionId.isEmpty())
+ throw new XenForoMissingArgsException("sessionId");
+
+ if (this.rememberCookie == null || this.rememberCookie.isEmpty())
+ throw new XenForoMissingArgsException("rememberCookie");
+
+ list.add(new XenNameValuePair("session_id", this.sessionId));
+ list.add(new XenNameValuePair("remember_cookie", this.rememberCookie));
+
+ return list;
+ }
+
+ @Override
+ public Class response() {
+ return UserResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/auth/PostAuthToken.java b/src/es/cadox8/xenapi/api/auth/PostAuthToken.java
new file mode 100644
index 0000000..014cae4
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/auth/PostAuthToken.java
@@ -0,0 +1,88 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.auth;
+
+import es.cadox8.xenapi.exceptions.XenForoMissingArgsException;
+import es.cadox8.xenapi.net.ApiRequest;
+import es.cadox8.xenapi.net.HttpMethod;
+import es.cadox8.xenapi.utils.XenNameValuePair;
+import es.cadox8.xenapi.utils.XenforoPaths;
+import lombok.Builder;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Builder
+public class PostAuthToken implements ApiRequest {
+
+ private final Integer userId;
+ private final String limitIP;
+ private final String returnUrl;
+ private final Boolean force;
+ @Builder.Default private final Boolean remember = true;
+
+ @Override
+ public XenforoPaths getPath() {
+ return XenforoPaths.LOGIN_TOKEN;
+ }
+
+ @Override
+ public HttpMethod getMethod() {
+ return HttpMethod.POST;
+ }
+
+ @Override
+ public Object query() {
+ return null;
+ }
+
+ @Override
+ public List params() {
+ return List.of();
+ }
+
+ @Override
+ public List body() {
+ final List list = new ArrayList<>();
+
+ if (this.userId == null)
+ throw new XenForoMissingArgsException("userId");
+
+ if (this.limitIP != null && !this.limitIP.isEmpty())
+ list.add(new XenNameValuePair("limit_ip", this.limitIP));
+
+ if (this.returnUrl != null && !this.returnUrl.isEmpty())
+ list.add(new XenNameValuePair("return_url", this.returnUrl));
+
+ if (this.force != null)
+ list.add(new XenNameValuePair("force", this.force));
+
+ list.add(new XenNameValuePair("remember", this.remember));
+
+ return list;
+ }
+
+ @Override
+ public Class response() {
+ return AuthTokenResponse.class;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/auth/UserResponse.java b/src/es/cadox8/xenapi/api/auth/UserResponse.java
new file mode 100644
index 0000000..2f29b30
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/auth/UserResponse.java
@@ -0,0 +1,306 @@
+/*
+ * Copyright (c) 2021-2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.auth;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.commons.AvatarUrls;
+import es.cadox8.xenapi.api.commons.ProfileBannerUrls;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * User class
+ */
+@Data
+@AllArgsConstructor
+public class UserResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("success")
+ private boolean success;
+
+ @Expose
+ @SerializedName("user")
+ private UserData user;
+
+ @Data
+ @AllArgsConstructor
+ public static class UserData {
+
+ @Expose
+ @SerializedName("about")
+ private String about;
+
+ @Expose
+ @SerializedName("activity_visible")
+ private boolean activityVisible;
+
+ @Expose
+ @SerializedName("age")
+ private int age;
+
+ @Expose
+ @SerializedName("alert_optout")
+ private List alertOptout;
+
+ @Expose
+ @SerializedName("allow_post_profile")
+ private String allowPostProfile;
+
+ @Expose
+ @SerializedName("allow_receive_news_feed")
+ private String allowReceiveNewsFeed;
+
+ @Expose
+ @SerializedName("allow_send_personal_conversation")
+ private String allowSendPersonalConversation;
+
+ @Expose
+ @SerializedName("allow_view_identities")
+ private String allowViewIdentities;
+
+ @Expose
+ @SerializedName("allow_view_profile")
+ private String allowViewProfile;
+
+ @Expose
+ @SerializedName("avatar_urls")
+ private AvatarUrls avatarUrls;
+
+ @Expose
+ @SerializedName("can_ban")
+ private boolean canBan;
+
+ @Expose
+ @SerializedName("can_converse")
+ private boolean canConverse;
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_follow")
+ private boolean canFollow;
+
+ @Expose
+ @SerializedName("can_ignore")
+ private boolean canIgnore;
+
+ @Expose
+ @SerializedName("can_post_profile")
+ private boolean canPostProfile;
+
+ @Expose
+ @SerializedName("can_view_profile")
+ private boolean canViewProfile;
+
+ @Expose
+ @SerializedName("can_view_profile_posts")
+ private boolean canViewProfilePosts;
+
+ @Expose
+ @SerializedName("can_warn")
+ private boolean canWarn;
+
+ @Expose
+ @SerializedName("content_show_signature")
+ private boolean contentShowSignature;
+
+ @Expose
+ @SerializedName("creation_watch_state")
+ private String creationWatchState;
+
+ @Expose
+ @SerializedName("custom_fields")
+ private Map customFields;
+
+ @Expose
+ @SerializedName("custom_title")
+ private String customTitle;
+
+ @Expose
+ @SerializedName("email")
+ private String email;
+
+ @Expose
+ @SerializedName("email_on_conversation")
+ private boolean emailOnConversation;
+
+ @Expose
+ @SerializedName("gravatar")
+ private String gravatar;
+
+ @Expose
+ @SerializedName("interaction_watch_state")
+ private String interactionWatchState;
+
+ @Expose
+ @SerializedName("is_admin")
+ private boolean isAdmin;
+
+ @Expose
+ @SerializedName("is_banned")
+ private boolean isBanned;
+
+ @Expose
+ @SerializedName("is_discouraged")
+ private boolean isDiscouraged;
+
+ @Expose
+ @SerializedName("is_followed")
+ private boolean isFollowed;
+
+ @Expose
+ @SerializedName("is_ignored")
+ private boolean isIgnored;
+
+ @Expose
+ @SerializedName("is_moderator")
+ private boolean isModerator;
+
+ @Expose
+ @SerializedName("is_staff")
+ private boolean isStaff;
+
+ @Expose
+ @SerializedName("is_super_admin")
+ private boolean isSuperAdmin;
+
+ @Expose
+ @SerializedName("last_activity")
+ private long lastActivity;
+
+ @Expose
+ @SerializedName("location")
+ private String location;
+
+ @Expose
+ @SerializedName("message_count")
+ private int messageCount;
+
+ @Expose
+ @SerializedName("profile_banner_urls")
+ private ProfileBannerUrls profileBannerUrls;
+
+ @Expose
+ @SerializedName("push_on_conversation")
+ private boolean pushOnConversation;
+
+ @Expose
+ @SerializedName("push_optout")
+ private List pushOptout;
+
+ @Expose
+ @SerializedName("question_solution_count")
+ private int questionSolutionCount;
+
+ @Expose
+ @SerializedName("reaction_score")
+ private int reactionScore;
+
+ @Expose
+ @SerializedName("receive_admin_email")
+ private boolean receiveAdminEmail;
+
+ @Expose
+ @SerializedName("register_date")
+ private long registerDate;
+
+ @Expose
+ @SerializedName("secondary_group_ids")
+ private List secondaryGroupIds;
+
+ @Expose
+ @SerializedName("show_dob_date")
+ private boolean showDobDate;
+
+ @Expose
+ @SerializedName("show_dob_year")
+ private boolean showDobYear;
+
+ @Expose
+ @SerializedName("signature")
+ private String signature;
+
+ @Expose
+ @SerializedName("timezone")
+ private String timezone;
+
+ @Expose
+ @SerializedName("trophy_points")
+ private int trophyPoints;
+
+ @Expose
+ @SerializedName("usa_tfa")
+ private boolean usaTfa;
+
+ @Expose
+ @SerializedName("use_tfa")
+ private boolean useTfa;
+
+ @Expose
+ @SerializedName("user_group_id")
+ private int userGroupId;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("user_state")
+ private String userState;
+
+ @Expose
+ @SerializedName("user_title")
+ private String userTitle;
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("visible")
+ private boolean visible;
+
+ @Expose
+ @SerializedName("vote_score")
+ private int voteScore;
+
+ @Expose
+ @SerializedName("warning_points")
+ private int warningPoints;
+
+ @Expose
+ @SerializedName("website")
+ private String website;
+ }
+}
diff --git a/src/es/cadox8/xenapi/api/user/AvatarUrls.java b/src/es/cadox8/xenapi/api/commons/AvatarUrls.java
similarity index 93%
rename from src/es/cadox8/xenapi/api/user/AvatarUrls.java
rename to src/es/cadox8/xenapi/api/commons/AvatarUrls.java
index df6c98a..e07f070 100644
--- a/src/es/cadox8/xenapi/api/user/AvatarUrls.java
+++ b/src/es/cadox8/xenapi/api/commons/AvatarUrls.java
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2021-2021.
+ * Copyright (c) 2021-2024
*
* This file is part of XenAPI .
*
@@ -19,7 +19,7 @@
* If you have any question feel free to ask at or
*/
-package es.cadox8.xenapi.api.user;
+package es.cadox8.xenapi.api.commons;
import lombok.Data;
diff --git a/src/es/cadox8/xenapi/api/commons/Conversation.java b/src/es/cadox8/xenapi/api/commons/Conversation.java
new file mode 100644
index 0000000..d577b7d
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Conversation.java
@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import kotlin.Pair;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+
+@Getter
+@ToString
+public class Conversation {
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("recipients")
+ private List> recipients;
+
+ @Expose
+ @SerializedName("is_starred")
+ private boolean isStarred;
+
+ @Expose
+ @SerializedName("is_unread")
+ private boolean isUnread;
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_reply")
+ private boolean canReply;
+
+ @Expose
+ @SerializedName("can_invite")
+ private boolean canInvite;
+
+ @Expose
+ @SerializedName("can_upload_attachment")
+ private boolean canUploadAttachment;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("conversation_id")
+ private int conversationId;
+
+ @Expose
+ @SerializedName("title")
+ private String title;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("start_date")
+ private int startDate;
+
+ @Expose
+ @SerializedName("open_invite")
+ private boolean openInvite;
+
+ @Expose
+ @SerializedName("conversation_open")
+ private boolean conversationOpen;
+
+ @Expose
+ @SerializedName("reply_count")
+ private int replyCount;
+
+ @Expose
+ @SerializedName("recipient_count")
+ private int recipientCount;
+
+ @Expose
+ @SerializedName("first_message_id")
+ private int firstMessageId;
+
+ @Expose
+ @SerializedName("last_message_date")
+ private int lastMessageDate;
+
+ @Expose
+ @SerializedName("last_message_id")
+ private int lastMessageId;
+
+ @Expose
+ @SerializedName("last_message_user_id")
+ private int lastMessageUserId;
+
+ @Expose
+ @SerializedName("starter")
+ private UserResponse starter;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/ConversationMessage.java b/src/es/cadox8/xenapi/api/commons/ConversationMessage.java
new file mode 100644
index 0000000..9492ebd
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/ConversationMessage.java
@@ -0,0 +1,109 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.attachment.AttachmentResponse;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+
+@ToString
+@Getter
+public class ConversationMessage implements ApiResponse {
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("is_unread")
+ private boolean isUnread;
+
+ @Expose
+ @SerializedName("message_parsed")
+ private String messageParsed;
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_react")
+ private boolean canReact;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("Conversation")
+ private Conversation conversation;
+
+ @Expose
+ @SerializedName("Attachments")
+ private List attachments;
+
+ @Expose
+ @SerializedName("is_reacted_to")
+ private boolean isReactedTo;
+
+ @Expose
+ @SerializedName("visitor_reaction_id")
+ private int visitorReactionId;
+
+ @Expose
+ @SerializedName("message_id")
+ private int messageId;
+
+ @Expose
+ @SerializedName("conversation_id")
+ private int conversationId;
+
+ @Expose
+ @SerializedName("message_date")
+ private int messageDate;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("message")
+ private String message;
+
+ @Expose
+ @SerializedName("attach_count")
+ private int attachCount;
+
+ @Expose
+ @SerializedName("reaction_score")
+ private int reactionScore;
+
+ @Expose
+ @SerializedName("User")
+ private UserResponse user;
+}
diff --git a/src/es/cadox8/xenapi/api/XenForoEntity.java b/src/es/cadox8/xenapi/api/commons/Errors.java
similarity index 59%
rename from src/es/cadox8/xenapi/api/XenForoEntity.java
rename to src/es/cadox8/xenapi/api/commons/Errors.java
index 0b536f2..3e58020 100644
--- a/src/es/cadox8/xenapi/api/XenForoEntity.java
+++ b/src/es/cadox8/xenapi/api/commons/Errors.java
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2021.
+ * Copyright (c) 2024
*
* This file is part of XenAPI .
*
@@ -19,24 +19,29 @@
* If you have any question feel free to ask at or
*/
-package es.cadox8.xenapi.api;
+package es.cadox8.xenapi.api.commons;
import com.google.gson.annotations.Expose;
-import es.cadox8.xenapi.XenAPI;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.ToString;
-public class XenForoEntity {
+import java.util.List;
- @Expose(serialize = false, deserialize = false)
- protected XenAPI xenAPIService;
- @SuppressWarnings("unchecked")
- public T setInternalXenAPI(XenAPI xenAPIService) {
- this.xenAPIService = xenAPIService;
- return (T) this;
- }
+@Getter
+@ToString
+public class Errors implements ApiResponse {
+
+ @Expose private List errors;
- protected XenAPI getXenAPIService() {
- if (xenAPIService == null) throw new IllegalStateException("The xenAPI not initialized. Please call setInternalXenAPI before.");
- return xenAPIService;
+ @Getter
+ @ToString
+ @Builder
+ public static class ErrorData {
+ @Expose private String code;
+ @Expose private String message;
+ @Expose private List params;
}
}
diff --git a/src/es/cadox8/xenapi/api/commons/Forum.java b/src/es/cadox8/xenapi/api/commons/Forum.java
new file mode 100644
index 0000000..00e6964
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Forum.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import lombok.Getter;
+import lombok.ToString;
+
+@ToString
+@Getter
+public class Forum {
+
+ @Expose
+ @SerializedName("forum_type_id")
+ private String forumTypeId;
+
+ @Expose
+ @SerializedName("allow_posting")
+ private boolean allowPosting;
+
+ @Expose
+ @SerializedName("require_prefix")
+ private boolean requirePrefix;
+
+ @Expose
+ @SerializedName("min_tags")
+ private int minTags;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/Node.java b/src/es/cadox8/xenapi/api/commons/Node.java
new file mode 100644
index 0000000..a168f4b
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Node.java
@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+
+@ToString
+@Getter
+public class Node implements ApiResponse {
+
+ @Expose
+ @SerializedName("breadcrumbs")
+ private List breadcrumbs;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("node_id")
+ private int nodeId;
+
+ @Expose
+ @SerializedName("title")
+ private String title;
+
+ @Expose
+ @SerializedName("node_name")
+ private String nodeName;
+
+ @Expose
+ @SerializedName("description")
+ private String description;
+
+ @Expose
+ @SerializedName("node_type_id")
+ private TypeNodeId nodeTypeId;
+
+ @Expose
+ @SerializedName("parent_node_id")
+ private int parentNodeId;
+
+ @Expose
+ @SerializedName("display_order")
+ private int displayOrder;
+
+ @Expose
+ @SerializedName("display_in_list")
+ private boolean displayInList;
+
+ @ToString
+ @Getter
+ public static class Breadcrumbs {
+ @Expose
+ @SerializedName("node_id")
+ private int nodeId;
+
+ @Expose
+ @SerializedName("title")
+ private String title;
+
+ @Expose
+ @SerializedName("node_type_id")
+ private TypeNodeId nodeTypeId;
+ }
+}
diff --git a/src/es/cadox8/xenapi/exceptions/NotFoundException.java b/src/es/cadox8/xenapi/api/commons/Order.java
similarity index 70%
rename from src/es/cadox8/xenapi/exceptions/NotFoundException.java
rename to src/es/cadox8/xenapi/api/commons/Order.java
index 5d607c9..d951815 100644
--- a/src/es/cadox8/xenapi/exceptions/NotFoundException.java
+++ b/src/es/cadox8/xenapi/api/commons/Order.java
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2021.
+ * Copyright (c) 2025
*
* This file is part of XenAPI .
*
@@ -19,16 +19,19 @@
* If you have any question feel free to ask at or
*/
-package es.cadox8.xenapi.exceptions;
+package es.cadox8.xenapi.api.commons;
-import es.cadox8.xenapi.api.XenForoEntity;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
-public class NotFoundException extends XenForoBadRequestException {
- public NotFoundException(String message, Throwable cause) {
- super(message, cause);
- }
+@Getter
+@RequiredArgsConstructor
+public enum Order {
+ TITLE("title"),
+ REPLIES("reply_count"),
+ VIEWS("view_count"),
+ VOTES("vote_score"),
+ SCORE("first_post_reaction_score");
- public NotFoundException(String message) {
- super(message);
- }
+ private final String order;
}
diff --git a/src/es/cadox8/xenapi/exceptions/NotAuthorizedException.java b/src/es/cadox8/xenapi/api/commons/Pagination.java
similarity index 67%
rename from src/es/cadox8/xenapi/exceptions/NotAuthorizedException.java
rename to src/es/cadox8/xenapi/api/commons/Pagination.java
index 700589a..ce4e26e 100644
--- a/src/es/cadox8/xenapi/exceptions/NotAuthorizedException.java
+++ b/src/es/cadox8/xenapi/api/commons/Pagination.java
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2021.
+ * Copyright (c) 2024
*
* This file is part of XenAPI .
*
@@ -19,18 +19,19 @@
* If you have any question feel free to ask at or
*/
-package es.cadox8.xenapi.exceptions;
+package es.cadox8.xenapi.api.commons;
-public class NotAuthorizedException extends XenForoBadRequestException {
- public NotAuthorizedException(String message) {
- super(message);
- }
+import com.google.gson.annotations.Expose;
+import lombok.Getter;
+import lombok.ToString;
- public NotAuthorizedException() {
- this("Not authorized");
- }
+@ToString
+@Getter
+public class Pagination {
- public NotAuthorizedException(String response, Throwable cause) {
- super(response, cause);
- }
+ @Expose private int current_page;
+ @Expose private int last_page;
+ @Expose private int per_page;
+ @Expose private int shown;
+ @Expose private int total;
}
diff --git a/src/es/cadox8/xenapi/api/commons/Post.java b/src/es/cadox8/xenapi/api/commons/Post.java
new file mode 100644
index 0000000..4f6c50f
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Post.java
@@ -0,0 +1,160 @@
+/*
+ * Copyright (c) 2-125
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.attachment.AttachmentResponse;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Data
+public class Post implements ApiResponse {
+
+ @Expose
+ @SerializedName("username")
+ private String username = "";
+
+ @Expose
+ @SerializedName("is_first_post")
+ private Boolean isFirstPost = false;
+
+ @Expose
+ @SerializedName("is_last_post")
+ private Boolean isLastPost = false;
+
+ @Expose
+ @SerializedName("is_unread")
+ private Boolean isUnread = false;
+
+ @Expose
+ @SerializedName("message_parsed")
+ private String htmlMessage = "";
+
+ @Expose
+ @SerializedName("can_edit")
+ private Boolean canEdit = false;
+
+ @Expose
+ @SerializedName("can_soft_delete")
+ private Boolean canSoftDelete = false;
+
+ @Expose
+ @SerializedName("can_hard_delete")
+ private Boolean canHardDelete = false;
+
+ @Expose
+ @SerializedName("can_react")
+ private Boolean canReact = false;
+
+ @Expose
+ @SerializedName("can_view_attachments")
+ private Boolean canViewAttachments = false;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl = "";
+
+ @Expose
+ @SerializedName("Thread")
+ private Thread thread;
+
+ @Expose
+ @SerializedName("Attachments")
+ private List attachments = new ArrayList<>();
+
+ @Expose
+ @SerializedName("is_reacted_to")
+ private Boolean hasReactedTo = false;
+
+ @Expose
+ @SerializedName("visitor_reaction_id")
+ private Integer visitorReactionId = -1;
+
+ @Expose
+ @SerializedName("vote_score")
+ private Integer voteScore = -1;
+
+ @Expose
+ @SerializedName("can_content_vote")
+ private Boolean canVote = false;
+
+ @Expose
+ @SerializedName("allowed_content_vote_types")
+ private List allowedContentVoteTypes = new ArrayList<>();
+
+ @Expose
+ @SerializedName("is_content_voted")
+ private Boolean isContentVoted = false;
+
+ @Expose
+ @SerializedName("visitor_content_vote")
+ private String visitorContentVote = "";
+
+ @Expose
+ @SerializedName("post_id")
+ private Integer postId = -1;
+
+ @Expose
+ @SerializedName("thread_id")
+ private Integer threadId = -1;
+
+ @Expose
+ @SerializedName("user_id")
+ private Integer userId = -1;
+
+ @Expose
+ @SerializedName("post_date")
+ private Integer postDate = -1;
+
+ @Expose
+ @SerializedName("message")
+ private String message = "";
+
+ @Expose
+ @SerializedName("message_state")
+ private String messageState = "";
+
+ @Expose
+ @SerializedName("attach_count")
+ private Integer attachCount = -1;
+
+ @Expose
+ @SerializedName("warning_message")
+ private String warningMessage = "";
+
+ @Expose
+ @SerializedName("position")
+ private Integer position = -1;
+
+ @Expose
+ @SerializedName("reaction_score")
+ private Integer reactionScore = -1;
+
+ @Expose
+ @SerializedName("User")
+ private UserResponse.UserData user = null;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/ProfileBannerUrls.java b/src/es/cadox8/xenapi/api/commons/ProfileBannerUrls.java
new file mode 100644
index 0000000..1e9b188
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/ProfileBannerUrls.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+
+@Data
+public class ProfileBannerUrls {
+ @Expose
+ @SerializedName("l")
+ private String l;
+
+ @Expose
+ @SerializedName("m")
+ private String m;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/ProfilePost.java b/src/es/cadox8/xenapi/api/commons/ProfilePost.java
new file mode 100644
index 0000000..7dbc913
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/ProfilePost.java
@@ -0,0 +1,135 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.attachment.AttachmentResponse;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+import java.util.List;
+
+@Data
+public class ProfilePost implements ApiResponse {
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("message_parsed")
+ private String messageParsed;
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_soft_delete")
+ private boolean canSoftDelete;
+
+ @Expose
+ @SerializedName("can_hard_delete")
+ private boolean canHardDelete;
+
+ @Expose
+ @SerializedName("can_react")
+ private boolean canReact;
+
+ @Expose
+ @SerializedName("can_view_attachments")
+ private boolean canViewAttachments;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("ProfileUser")
+ private UserResponse profileUser;
+
+ @Expose
+ @SerializedName("Attachments")
+ private List attachments;
+
+ @Expose
+ @SerializedName("LatestComments")
+ private List latestComments;
+
+ @Expose
+ @SerializedName("is_reacted_to")
+ private boolean isReactedTo;
+
+ @Expose
+ @SerializedName("visitor_reaction_id")
+ private int visitorReactionId;
+
+ @Expose
+ @SerializedName("profile_post_id")
+ private int profilePostId;
+
+ @Expose
+ @SerializedName("profile_user_id")
+ private int profileUserId;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("post_date")
+ private int postDate;
+
+ @Expose
+ @SerializedName("message")
+ private String message;
+
+ @Expose
+ @SerializedName("message_state")
+ private String messageState;
+
+ @Expose
+ @SerializedName("warning_message")
+ private String warningMessage;
+
+ @Expose
+ @SerializedName("comment_count")
+ private int commentCount;
+
+ @Expose
+ @SerializedName("first_comment_date")
+ private int firstCommentDate;
+
+ @Expose
+ @SerializedName("last_comment_date")
+ private int lastCommentDate;
+
+ @Expose
+ @SerializedName("reaction_score")
+ private int reactionScore;
+
+ @Expose
+ @SerializedName("User")
+ private UserResponse user;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/ProfilePostComment.java b/src/es/cadox8/xenapi/api/commons/ProfilePostComment.java
new file mode 100644
index 0000000..3ccc3ec
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/ProfilePostComment.java
@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.attachment.AttachmentResponse;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class ProfilePostComment implements ApiResponse {
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("message_parsed")
+ private String messageParsed;
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_soft_delete")
+ private boolean canSoftDelete;
+
+ @Expose
+ @SerializedName("can_hard_delete")
+ private boolean canHardDelete;
+
+ @Expose
+ @SerializedName("can_react")
+ private boolean canReact;
+
+ @Expose
+ @SerializedName("can_view_attachments")
+ private boolean canViewAttachments;
+
+ @Expose
+ @SerializedName("Attachments")
+ private AttachmentResponse[] attachments;
+
+ @Expose
+ @SerializedName("ProfilePost")
+ private ProfilePost profilePost;
+
+ @Expose
+ @SerializedName("is_reacted_to")
+ private boolean isReactedTo;
+
+ @Expose
+ @SerializedName("visitor_reaction_id")
+ private int visitorReactionId;
+
+ @Expose
+ @SerializedName("profile_post_comment_id")
+ private int profilePostCommentId;
+
+ @Expose
+ @SerializedName("profile_post_id")
+ private int profilePostId;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("comment_date")
+ private int commentDate;
+
+ @Expose
+ @SerializedName("message")
+ private String message;
+
+ @Expose
+ @SerializedName("message_state")
+ private String messageState;
+
+ @Expose
+ @SerializedName("warning_message")
+ private String warningMessage;
+
+ @Expose
+ @SerializedName("reaction_score")
+ private int reactionScore;
+
+ @Expose
+ @SerializedName("User")
+ private UserResponse user;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/ReactResponse.java b/src/es/cadox8/xenapi/api/commons/ReactResponse.java
new file mode 100644
index 0000000..a87244f
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/ReactResponse.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class ReactResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("success")
+ private Boolean success;
+
+ @Expose
+ @SerializedName("action")
+ private String action;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/Sort.java b/src/es/cadox8/xenapi/api/commons/Sort.java
new file mode 100644
index 0000000..c4b339e
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Sort.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2025
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum Sort {
+ // Oldest firsts
+ ASC("asc"),
+ // Newest firsts
+ DESC("desc");
+
+ private final String direction;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/Success.java b/src/es/cadox8/xenapi/api/commons/Success.java
new file mode 100644
index 0000000..26e5dd7
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Success.java
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Data;
+
+@Data
+public class Success implements ApiResponse {
+
+ @Expose
+ @SerializedName("success")
+ private boolean success;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/Thread.java b/src/es/cadox8/xenapi/api/commons/Thread.java
new file mode 100644
index 0000000..5409684
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/Thread.java
@@ -0,0 +1,208 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.auth.UserResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+import java.util.Map;
+
+@ToString
+@Getter
+public class Thread {
+
+ @Expose
+ @SerializedName("username")
+ private String username;
+
+ @Expose
+ @SerializedName("is_watching")
+ private boolean isWatching = false;
+
+ @Expose
+ @SerializedName("visitor_post_count")
+ private int visitorPostCount = 0;
+
+ @Expose
+ @SerializedName("is_unread")
+ private boolean isUnread = false;
+
+ @Expose
+ @SerializedName("custom_fields")
+ private Map customFields;
+
+ @Expose
+ @SerializedName("tags")
+ private List tags;
+
+ @Expose
+ @SerializedName("prefix")
+ private String prefix = "";
+
+ @Expose
+ @SerializedName("can_edit")
+ private boolean canEdit;
+
+ @Expose
+ @SerializedName("can_edit_tags")
+ private boolean canEditTags;
+
+ @Expose
+ @SerializedName("can_reply")
+ private boolean canReply;
+
+ @Expose
+ @SerializedName("can_soft_delete")
+ private boolean canSoftDelete;
+
+ @Expose
+ @SerializedName("can_hard_delete")
+ private boolean canHardDelete;
+
+ @Expose
+ @SerializedName("can_view_attachments")
+ private boolean canViewAttachments;
+
+ @Expose
+ @SerializedName("view_url")
+ private String viewUrl;
+
+ @Expose
+ @SerializedName("is_first_post_pinned")
+ private boolean isFirstPostPinned;
+
+ @Expose
+ @SerializedName("highlighted_post_ids")
+ private List highlightedPostIds;
+
+ @Expose
+ @SerializedName("is_search_engine_indexable")
+ private boolean isSearchEngineIndexable;
+
+ @Expose
+ @SerializedName("index_state")
+ private String indexState = "";
+
+ @Expose
+ @SerializedName("Forum")
+ private Node forum;
+
+ @Expose
+ @SerializedName("vote_score")
+ private int voteScore = 0;
+
+ @Expose
+ @SerializedName("can_content_vote")
+ private boolean canContentVote = false;
+
+ @Expose
+ @SerializedName("allowed_content_vote_types")
+ private List allowedContentVoteTypes;
+
+ @Expose
+ @SerializedName("is_content_voted")
+ private boolean isContentVoted = false;
+
+ @Expose
+ @SerializedName("visitor_content_vote")
+ private String visitorContentVote = "";
+
+ @Expose
+ @SerializedName("thread_id")
+ private int threadId;
+
+ @Expose
+ @SerializedName("node_id")
+ private int nodeId;
+
+ @Expose
+ @SerializedName("title")
+ private String title;
+
+ @Expose
+ @SerializedName("reply_count")
+ private int replyCount;
+
+ @Expose
+ @SerializedName("view_count")
+ private int viewCount;
+
+ @Expose
+ @SerializedName("user_id")
+ private int userId;
+
+ @Expose
+ @SerializedName("post_date")
+ private int postDate;
+
+ @Expose
+ @SerializedName("sticky")
+ private boolean sticky;
+
+ @Expose
+ @SerializedName("discussion_state")
+ private String discussionState;
+
+ @Expose
+ @SerializedName("discussion_open")
+ private boolean discussionOpen;
+
+ @Expose
+ @SerializedName("discussion_type")
+ private String discussionType;
+
+ @Expose
+ @SerializedName("first_post_id")
+ private int firstPostId;
+
+ @Expose
+ @SerializedName("last_post_date")
+ private int lastPostDate;
+
+ @Expose
+ @SerializedName("last_post_id")
+ private int lastPostId;
+
+ @Expose
+ @SerializedName("last_post_user_id")
+ private int lastPostUserId;
+
+ @Expose
+ @SerializedName("last_post_username")
+ private String lastPostUsername;
+
+ @Expose
+ @SerializedName("first_post_reaction_score")
+ private int firstPostReactionScore;
+
+ @Expose
+ @SerializedName("prefix_id")
+ private int prefixId;
+
+ @Expose
+ @SerializedName("User")
+ private UserResponse user;
+}
diff --git a/src/es/cadox8/xenapi/api/commons/TypeNodeId.java b/src/es/cadox8/xenapi/api/commons/TypeNodeId.java
new file mode 100644
index 0000000..6b76f93
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/TypeNodeId.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum TypeNodeId {
+ @SerializedName("Forum") FORUM("Forum"),
+ @SerializedName("Category") CATEGORY("Category"),
+ @SerializedName("LinkForum") LINK_FORUM("LinkForum"),
+ @SerializedName("SearchForum") SEARCH_FORUM("SearchForum"),
+ @SerializedName("Page") PAGE("Page");
+
+ private final String nodeType;
+}
\ No newline at end of file
diff --git a/src/es/cadox8/xenapi/api/commons/UpdateEmail.java b/src/es/cadox8/xenapi/api/commons/UpdateEmail.java
new file mode 100644
index 0000000..6238724
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/commons/UpdateEmail.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.commons;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import lombok.Getter;
+import lombok.ToString;
+
+@Getter
+@ToString
+public class UpdateEmail extends Success {
+
+ @Expose
+ @SerializedName("confirmation_required")
+ private boolean confirmationRequired;
+}
diff --git a/src/es/cadox8/xenapi/api/conversation/ConversationCreateResponse.java b/src/es/cadox8/xenapi/api/conversation/ConversationCreateResponse.java
new file mode 100644
index 0000000..52c1d35
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/conversation/ConversationCreateResponse.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.conversation;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.commons.Conversation;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+@ToString
+@Getter
+public class ConversationCreateResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("success")
+ private boolean success;
+
+ @Expose
+ @SerializedName("conversation")
+ private Conversation conversation;
+}
diff --git a/src/es/cadox8/xenapi/api/conversation/ConversationInfoResponse.java b/src/es/cadox8/xenapi/api/conversation/ConversationInfoResponse.java
new file mode 100644
index 0000000..feba287
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/conversation/ConversationInfoResponse.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.conversation;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.commons.Conversation;
+import es.cadox8.xenapi.api.commons.ConversationMessage;
+import es.cadox8.xenapi.api.commons.Pagination;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+import java.util.List;
+
+@ToString
+@Getter
+public class ConversationInfoResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("conversation")
+ private Conversation conversation;
+
+ @Expose
+ @SerializedName("messages")
+ private List messages;
+
+ @Expose
+ @SerializedName("pagination")
+ private Pagination pagination;
+}
diff --git a/src/es/cadox8/xenapi/api/conversation/ConversationMessagesResponse.java b/src/es/cadox8/xenapi/api/conversation/ConversationMessagesResponse.java
new file mode 100644
index 0000000..47e92ad
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/conversation/ConversationMessagesResponse.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI .
+ *
+ * XenAPI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * XenAPI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see or
+ */
+
+package es.cadox8.xenapi.api.conversation;
+
+import com.google.gson.annotations.Expose;
+import com.google.gson.annotations.SerializedName;
+import es.cadox8.xenapi.api.commons.ConversationMessage;
+import es.cadox8.xenapi.net.ApiResponse;
+import lombok.Getter;
+import lombok.ToString;
+
+@ToString
+@Getter
+public class ConversationMessagesResponse implements ApiResponse {
+
+ @Expose
+ @SerializedName("success")
+ private boolean success;
+
+ @Expose
+ @SerializedName("message")
+ private ConversationMessage message;
+}
diff --git a/src/es/cadox8/xenapi/api/conversation/ConversationReactResponse.java b/src/es/cadox8/xenapi/api/conversation/ConversationReactResponse.java
new file mode 100644
index 0000000..cc5755d
--- /dev/null
+++ b/src/es/cadox8/xenapi/api/conversation/ConversationReactResponse.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2024
+ *
+ * This file is part of XenAPI