Référence de l'API

Sessions

Créer un jeton API nommé et renvoyer clientId ainsi que le token de 32 octets encodé en Base64. Lister les sessions de connexion et de jetons API. Pour LOGIN, token et urlToken sont vides ; les identifiants API_TOKEN nécessitent une requête du propriétaire local.

Définitions de types

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
}

Opérations

mutation

createApiToken

Créer un jeton API nommé et renvoyer clientId ainsi que le token de 32 octets encodé en Base64.

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

renameSession

Renommer la session du client autorisé indiqué.

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

revokeSession

Révoquer la session du client indiqué et son accès.

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

sessions

Lister les sessions de connexion et de jetons API. Pour LOGIN, token et urlToken sont vides ; les identifiants API_TOKEN nécessitent une requête du propriétaire local.

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