PlainApp
API குறிப்பு

அமர்வுகள்

பெயரிட்ட API டோக்கனை உருவாக்கி clientId மற்றும் Base64 குறியாக்கப்பட்ட 32 பைட் token ஐ வழங்கும். உள்நுழைவு மற்றும் API டோக்கன் அமர்வுகளைப் பட்டியலிடும். LOGIN இன் token, urlToken காலியாக இருக்கும்; API_TOKEN சான்றுகளை உள்ளூர் உரிமையாளரின் கோரிக்கைகள் மட்டுமே படிக்க முடியும்.

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

graphql
type Mutation {
  createApiToken(name: String!): CreatedApiToken!
  renameSession(clientId: ID!, name: String!): Boolean!
  revokeSession(clientId: ID!): Boolean!
}

type Query {
  sessions: [Session!]!
}

type CreatedApiToken {
	clientId: ID!
	token: String!
}

scalar Instant

type Session {
	clientId: ID!
	clientName: String!
	type: SessionType!
	clientIp: String!
	osName: String!
	osVersion: String!
	appName: String!
	appVersion: String!
	lastSeenAt: Instant
	lastActive: Instant!
	createdAt: Instant!
	updatedAt: Instant!
}

enum SessionType {
	LOGIN
	API_TOKEN
}

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

mutation

createApiToken

பெயரிட்ட API டோக்கனை உருவாக்கி clientId மற்றும் Base64 குறியாக்கப்பட்ட 32 பைட் token ஐ வழங்கும்.

graphql
mutation createApiToken($name: String!) {
  createApiToken(name: $name) { clientId token }
}
mutation

renameSession

குறிப்பிட்ட அனுமதியளிக்கப்பட்ட கிளையன்ட் அமர்வின் பெயரை மாற்றவும்.

graphql
mutation renameSession($clientId: ID!, $name: String!) {
  renameSession(clientId: $clientId, name: $name)
}
mutation

revokeSession

குறிப்பிட்ட கிளையன்ட் அமர்வையும் அதன் அணுகலையும் ரத்துசெய்யவும்.

graphql
mutation revokeSession($clientId: ID!) {
  revokeSession(clientId: $clientId)
}
query

sessions

உள்நுழைவு மற்றும் API டோக்கன் அமர்வுகளைப் பட்டியலிடும். LOGIN இன் token, urlToken காலியாக இருக்கும்; API_TOKEN சான்றுகளை உள்ளூர் உரிமையாளரின் கோரிக்கைகள் மட்டுமே படிக்க முடியும்.

graphql
query sessions {
  sessions { clientId clientName type clientIp osName osVersion appName appVersion }
}