PlainApp
API குறிப்பு

ஊட்டங்கள் (RSS)

அம்ச ஆதரவிற்கு app.capabilities-ஐயும் அனுமதிக்கு app.access மற்றும் host அனுமதிகளையும் சரிபார்க்கவும். எடுத்துக்காட்டுகள் செயற்கை மதிப்புகளைப் பயன்படுத்துகின்றன; அழைப்பதற்கு முன் பாதைகள், ID-கள், உள்ளீடுகள் மற்றும் வடிப்பான்களை மாற்றவும்.

வகை வரையறைகள்

graphql
type Subscription {
  feedsFetched: FeedSyncChange!
}

type Mutation {
  createFeed(url: String!, fetchContent: Boolean!, name: String): Feed!
  deleteFeed(id: ID!): Boolean!
  deleteFeedEntries(query: String!): ActionResult!
  importFeeds(content: String!): Boolean!
  markFeedEntriesRead(query: String!, read: Boolean!): ActionResult!
  syncFeedEntryContent(id: ID!): FeedEntry!
  syncFeeds(id: ID): Boolean!
  updateFeed(id: ID!, name: String, fetchContent: Boolean, url: String): Feed!
}

type Query {
  exportFeeds: String!
  feed(id: ID!): Feed
  feedEntries(query: String!, offset: Int!, limit: Int!): [FeedEntry!]!
  feedEntry(id: ID!): FeedEntry
  feedEntryCount(query: String!): Int!
  feedEntryCounts: [FeedEntryCount!]!
  feedSyncStates: [FeedSyncState!]!
  feeds: [Feed!]!
  fetchFeedTitle(url: String!): String!
}

type ActionResult {
	affectedCount: Int!
}

enum DataType {
	DEFAULT
	AUDIO
	VIDEO
	IMAGE
	SMS
	CONTACT
	NOTE
	FEED_ENTRY
	CALL
	PACKAGE
	FILE
	APP_FILE
	DOC
}

type Feed {
	id: ID!
	name: String!
	url: String!
	fetchContent: Boolean!
	logo: String!
	lastSyncAt: Instant
	lastError: FeedError!
	createdAt: Instant!
	updatedAt: Instant!
}

type FeedEntry {
	id: ID!
	title: String!
	url: String!
	image: String!
	description: String!
	author: String!
	content: String!
	feedId: ID!
	rawId: String!
	read: Boolean!
	publishedAt: Instant!
	createdAt: Instant!
	updatedAt: Instant!
	tags: [Tag!]!
	feed: Feed
}

type FeedEntryCount {
	feedId: ID!
	count: Int!
}

type FeedError {
	code: FeedErrorCode!
	detail: String!
}

enum FeedErrorCode {
	NONE
	TIMEOUT
	SERVER
	DNS
	PARSE
	UNKNOWN
}

type FeedSyncChange {
	feedId: ID!
	error: String
	canceled: Boolean
}

type FeedSyncState {
	feedId: ID!
	taskId: ID!
	revision: Long!
	status: FeedWorkerStatus!
	error: String!
}

enum FeedWorkerStatus {
	QUEUED
	RUNNING
	CANCELED
	COMPLETED
	ERROR
}

scalar Instant

scalar Long

type Tag {
	id: ID!
	name: String!
	type: DataType!
	count: Int!
}

செயல்பாடுகள்

subscription

feedsFetched

ஊட்ட ஒத்திசைவு மாற்றங்களைப் பெறவும்.

graphql
subscription feedsFetched {
  feedsFetched { feedId error canceled }
}
mutation

createFeed

ஊட்டத்திற்குச் சந்தாசேர்ந்து அதன் முதல் ஒத்திசைவை வரிசையில் சேர்க்கவும்.

graphql
mutation createFeed($url: String!, $fetchContent: Boolean!, $name: String) {
  createFeed(url: $url, fetchContent: $fetchContent, name: $name) { id name url fetchContent logo lastSyncAt createdAt updatedAt }
}
mutation

deleteFeed

ஊட்டச் சந்தாவை நீக்கி அதன் அனைத்துப் பதிவுகளையும் அவற்றின் குறிச்சொல் உறவுகளையும் நீக்கவும்.

graphql
mutation deleteFeed($id: ID!) {
  deleteFeed(id: $id)
}
mutation

deleteFeedEntries

வினவலுக்குப் பொருந்தும் ஊட்டப் பதிவுகளையும் அவற்றின் குறிச்சொல் உறவுகளையும் நீக்கவும்.

graphql
mutation deleteFeedEntries($query: String!) {
  deleteFeedEntries(query: $query) { affectedCount }
}
mutation

importFeeds

OPML ஆவணத்தைச் சரமாக ஊட்டத் தரவுத்தளத்திற்கு இறக்குமதி செய்யவும்.

graphql
mutation importFeeds($content: String!) {
  importFeeds(content: $content)
}
mutation

markFeedEntriesRead

பொருந்தும் ஊட்டப் பதிவுகளைப் படித்ததாகவோ படிக்காததாகவோ குறித்துப் பாதிக்கப்பட்ட எண்ணிக்கையைத் தெரிவிக்கவும்.

graphql
mutation markFeedEntriesRead($query: String!, $read: Boolean!) {
  markFeedEntriesRead(query: $query, read: $read) { affectedCount }
}
mutation

syncFeedEntryContent

ஓர் ஊட்டப் பதிவின் முழு உள்ளடக்கத்தைப் பெற்றுச் சேமிக்கவும்.

graphql
mutation syncFeedEntryContent($id: ID!) {
  syncFeedEntryContent(id: $id) { id title url image description author content feedId }
}
mutation

syncFeeds

ID மூலம் ஓர் ஊட்டத்தின் ஒத்திசைவை வரிசையில் சேர்க்கவும்; ID வழங்கப்படாவிட்டால் அனைத்து ஊட்டங்களையும் சேர்க்கவும்.

graphql
mutation syncFeeds($id: ID) {
  syncFeeds(id: $id)
}
mutation

updateFeed

ஊட்டத்தின் காட்சிப் பெயர் அல்லது fetchContent கொடியைப் புதுப்பிக்கவும்.

graphql
mutation updateFeed($id: ID!, $name: String, $fetchContent: Boolean, $url: String) {
  updateFeed(id: $id, name: $name, fetchContent: $fetchContent, url: $url) { id name url fetchContent logo lastSyncAt createdAt updatedAt }
}
query

exportFeeds

அனைத்துச் சந்தா ஊட்டங்களையும் OPML சரமாக ஏற்றுமதி செய்யவும்.

graphql
query exportFeeds {
  exportFeeds
}
query

feed

ID மூலம் ஓர் ஊட்டச் சந்தாவைப் படிக்கவும்; இல்லாவிட்டால் null தரவும்.

graphql
query feed($id: ID!) {
  feed(id: $id) { id name url fetchContent logo lastSyncAt createdAt updatedAt }
}
query

feedEntries

ஊட்டப் பதிவுகளின் தலைப்பிலும் விளக்கத்திலும் தேடவும். அனைத்தையும் பட்டியலிட query-ஐ வெறுமையாக விடவும்.

graphql
query feedEntries($query: String!, $offset: Int!, $limit: Int!) {
  feedEntries(query: $query, offset: $offset, limit: $limit) { id title url image description author content feedId }
}
query

feedEntry

ID மூலம் ஓர் ஊட்டப் பதிவைப் பெறவும்.

graphql
query feedEntry($id: ID!) {
  feedEntry(id: $id) { id title url image description author content feedId }
}
query

feedEntryCount

வினவலுக்குப் பொருந்தும் ஊட்டப் பதிவுகளை எண்ணவும்.

graphql
query feedEntryCount($query: String!) {
  feedEntryCount(query: $query)
}
query

feedEntryCounts

ஊட்டப் பதிவுகளின் எண்ணிக்கைச் சுருக்கங்களைப் படிக்கவும்.

graphql
query feedEntryCounts {
  feedEntryCounts { feedId count }
}
query

feedSyncStates

ஊட்டச் சந்தாக்களின் தற்போதைய ஒத்திசைவு நிலையைப் படிக்கவும்.

graphql
query feedSyncStates {
  feedSyncStates { feedId taskId revision status error }
}
query

feeds

அனைத்துச் சந்தா ஊட்டங்களையும் பட்டியலிடவும்.

graphql
query feeds {
  feeds { id name url fetchContent logo lastSyncAt createdAt updatedAt }
}
query

fetchFeedTitle

சந்தா சேர்க்காமல் URL இலிருந்து ஊட்டத்தின் தலைப்பைப் பெறுகிறது.

graphql
query fetchFeedTitle($url: String!) {
  fetchFeedTitle(url: $url)
}