Aller au contenu principal

Notes

L'API client.notes fournit des opérations pour récupérer, créer et interagir avec les notes (publications).

Récupération de notes​

Note individuelle​

final note = await client.notes.show(noteId: '9xyz');
print(note.text);      // Note body
print(note.user.name); // Author's display name

Liste de notes publiques​

final notes = await client.notes.list(limit: 20);

Accepte les filtres local, reply, renote, withFiles et poll.

Réponses et fils de discussion​

// Direct replies to a note
final replies = await client.notes.replies(noteId: '9xyz', limit: 10);

// All children (replies and quote renotes)
final children = await client.notes.children(noteId: '9xyz', limit: 10);

// Parent chain (ancestors)
final ancestors = await client.notes.conversation(noteId: '9xyz', limit: 10);

Fils d'actualité​

Toutes les méthodes de fil d'actualité acceptent limit, sinceId, untilId, sinceDate et untilDate pour la pagination.

Fil d'actualité personnel (authentification requise)​

final notes = await client.notes.timelineHome(limit: 20);

Fil d'actualité local​

final notes = await client.notes.timelineLocal(limit: 20);

Fil d'actualité global​

final notes = await client.notes.timelineGlobal(limit: 20);

Fil d'actualité hybride (authentification requise)​

final notes = await client.notes.timelineHybrid(limit: 20);

Pagination par curseur​

// Fetch the next page using the ID of the oldest note already loaded
final older = await client.notes.timelineHome(
  limit: 20,
  untilId: notes.last.id,
);

// Fetch newer notes since the last loaded note
final newer = await client.notes.timelineHome(
  limit: 20,
  sinceId: notes.first.id,
);

Création de notes​

Au moins l'un des paramètres text, renoteId, fileIds ou pollChoices doit être fourni.

Texte brut​

final note = await client.notes.create(
  text: 'Hello, Misskey!',
  visibility: 'public',
);
print(note.id);

Avec un avertissement de contenu​

final note = await client.notes.create(
  text: 'This contains spoilers.',
  cw: 'Spoiler warning',
);

Avec des fichiers du Drive​

// First upload a file to Drive
final file = await client.drive.files.create(
  bytes: imageBytes,
  filename: 'photo.jpg',
);

// Attach the Drive file ID to the note
final note = await client.notes.create(
  text: 'Check this out!',
  fileIds: [file.id],
);

Avec un sondage​

final note = await client.notes.create(
  text: 'What do you prefer?',
  pollChoices: ['Option A', 'Option B', 'Option C'],
  pollMultiple: false,
  pollExpiredAfter: 86400000, // 24 hours in milliseconds
);

Réponse et renote​

// Reply
final reply = await client.notes.create(
  text: 'Great point!',
  replyId: originalNoteId,
);

// Pure renote (no text)
final renote = await client.notes.create(renoteId: originalNoteId);

// Quote renote
final quote = await client.notes.create(
  text: 'My thoughts on this:',
  renoteId: originalNoteId,
);

Options de visibilité​

// 'public', 'home', 'followers', 'specified'
final note = await client.notes.create(
  text: 'Followers only',
  visibility: 'followers',
);

// Direct message to specific users
final dm = await client.notes.create(
  text: 'Hey!',
  visibility: 'specified',
  visibleUserIds: [targetUserId],
);

Interactions avec les notes​

Réactions​

// Add a reaction (Unicode emoji or custom emoji shortcode)
await client.notes.reactionsCreate(noteId: noteId, reaction: '👍');
await client.notes.reactionsCreate(noteId: noteId, reaction: ':awesome:');

// Remove your reaction
await client.notes.reactionsDelete(noteId: noteId);

// Fetch reactions on a note
final reactions = await client.notes.reactions(noteId: noteId, limit: 20);
for (final r in reactions) {
  print('${r.reaction}: ${r.user.username}');
}

Renotes​

// Renote (no text)
await client.notes.create(renoteId: noteId);

// Cancel all your renotes of a note
await client.notes.unrenote(noteId: noteId);

// List users who renoted
final renotes = await client.notes.renotes(noteId: noteId, limit: 20);

Vote de sondage​

// choice is a zero-based index
await client.notes.pollsVote(noteId: noteId, choice: 0);

Supprimer une note​

await client.notes.delete(noteId: noteId);

Recherche​

Recherche en texte intégral​

final results = await client.notes.search(
  query: 'Misskey',
  limit: 20,
);

Filtrer par utilisateur ou par canal :

final results = await client.notes.search(
  query: 'hello',
  userId: someUserId,
  channelId: someChannelId,
);

Recherche par hashtag​

// Simple tag search
final results = await client.notes.searchByTag(tag: 'misskey');

// Complex query: (tagA AND tagB) OR tagC
final results = await client.notes.searchByTag(
  queryTags: [
    ['tagA', 'tagB'],
    ['tagC'],
  ],
);

Favoris et brouillons​

// Add / remove a favorite
await client.notes.favoritesCreate(noteId: noteId);
await client.notes.favoritesDelete(noteId: noteId);

// Fetch your favorited notes
final favs = await client.account.favorites(limit: 20);

// List drafts
final drafts = await client.notes.draftsList(limit: 20);

// Draft count
final count = await client.notes.draftsCount();

Traduction​

final translation = await client.notes.translate(
  noteId: noteId,
  targetLang: 'en',
);
print(translation.text);