mirror of
https://github.com/Athou/commafeed.git
synced 2026-03-21 21:37:29 +00:00
more api documentation
This commit is contained in:
@@ -17,19 +17,19 @@ import com.wordnik.swagger.annotations.ApiProperty;
|
||||
@ApiClass("List of entries with some metadata")
|
||||
public class Entries implements Serializable {
|
||||
|
||||
@ApiProperty("Name of the feed or the category requested")
|
||||
@ApiProperty("name of the feed or the category requested")
|
||||
private String name;
|
||||
|
||||
@ApiProperty("Error or warning message")
|
||||
@ApiProperty("error or warning message")
|
||||
private String message;
|
||||
|
||||
@ApiProperty("TImes the server tried to refresh the feed and failed")
|
||||
@ApiProperty("times the server tried to refresh the feed and failed")
|
||||
private int errorCount;
|
||||
|
||||
@ApiProperty("List generation Timestamp")
|
||||
@ApiProperty("list generation Timestamp")
|
||||
private long timestamp;
|
||||
|
||||
@ApiProperty("List of entries")
|
||||
@ApiProperty("list of entries")
|
||||
private List<Entry> entries = Lists.newArrayList();
|
||||
|
||||
public String getName() {
|
||||
|
||||
@@ -7,22 +7,49 @@ import javax.xml.bind.annotation.XmlAccessType;
|
||||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import com.wordnik.swagger.annotations.ApiClass;
|
||||
import com.wordnik.swagger.annotations.ApiProperty;
|
||||
|
||||
@SuppressWarnings("serial")
|
||||
@XmlRootElement
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
@ApiClass("Entry details")
|
||||
public class Entry implements Serializable {
|
||||
|
||||
@ApiProperty("entry id")
|
||||
private String id;
|
||||
|
||||
@ApiProperty("entry title")
|
||||
private String title;
|
||||
|
||||
@ApiProperty("entry content")
|
||||
private String content;
|
||||
|
||||
@ApiProperty("entry enclosure url, if any")
|
||||
private String enclosureUrl;
|
||||
|
||||
@ApiProperty("entry enclosure mime type, if any")
|
||||
private String enclosureType;
|
||||
|
||||
@ApiProperty("entry publication date")
|
||||
private Date date;
|
||||
|
||||
@ApiProperty("feed id")
|
||||
private String feedId;
|
||||
|
||||
@ApiProperty("feed name")
|
||||
private String feedName;
|
||||
|
||||
@ApiProperty("feed url")
|
||||
private String feedUrl;
|
||||
|
||||
@ApiProperty("entry url")
|
||||
private String url;
|
||||
|
||||
@ApiProperty("read sttaus")
|
||||
private boolean read;
|
||||
|
||||
@ApiProperty("starred status")
|
||||
private boolean starred;
|
||||
|
||||
public String getId() {
|
||||
|
||||
@@ -6,13 +6,22 @@ import javax.xml.bind.annotation.XmlAccessType;
|
||||
import javax.xml.bind.annotation.XmlAccessorType;
|
||||
import javax.xml.bind.annotation.XmlRootElement;
|
||||
|
||||
import com.wordnik.swagger.annotations.ApiClass;
|
||||
import com.wordnik.swagger.annotations.ApiProperty;
|
||||
|
||||
@SuppressWarnings("serial")
|
||||
@XmlRootElement
|
||||
@XmlAccessorType(XmlAccessType.FIELD)
|
||||
@ApiClass("Subscription request")
|
||||
public class SubscriptionRequest implements Serializable {
|
||||
|
||||
@ApiProperty(value = "url of the feed", required = true)
|
||||
private String url;
|
||||
|
||||
@ApiProperty(value = "name of the feed for the user", required = true)
|
||||
private String title;
|
||||
|
||||
@ApiProperty(value = "id of the user category to place the feed in")
|
||||
private String categoryId;
|
||||
|
||||
public String getUrl() {
|
||||
|
||||
Reference in New Issue
Block a user