본문으로 건너뛰기

계정 및 프로필

client.account API는 현재 인증된 사용자를 위한 기능을 제공합니다. 프로필 정보 조회 및 업데이트, 인증 정보 관리, 데이터 내보내기/가져오기, 레지스트리, 2단계 인증, 웹훅을 위한 하위 API에 접근할 수 있습니다.

프로필 조회​

final me = await client.account.i();
print(me.name);        // 표시 이름
print(me.username);    // 사용자명 (@ 없이)
print(me.description); // 소개글

프로필 업데이트​

update는 임의의 필드 조합을 받습니다. 전달한 필드만 서버에 전송되며, 생략된 필드는 변경되지 않고 업데이트된 MisskeyUser가 반환됩니다.

final updated = await client.account.update(
  name: Optional('Alice'),
  description: Optional('Hello from Misskey!'),
  lang: Optional('en'),
  isLocked: false,
);

Optional 타입​

서버가 null로 받아들여 값을 지울 수 있는 필드에는 Optional<T> 래퍼를 사용합니다. 이를 통해 라이브러리가 세 가지 상태를 구분할 수 있습니다:

  • 파라미터 생략 — 요청에 필드가 포함되지 않으며 서버 값이 변경되지 않습니다.
  • Optional('value') — 필드가 지정된 값으로 설정됩니다.
  • Optional.null_() — 필드가 명시적으로 지워집니다.
// 아바타를 드라이브 파일로 설정하고 생일을 지우기
await client.account.update(
  avatarId: Optional('driveFileId123'),
  birthday: Optional.null_(),
);

개인정보 및 공개 범위​

await client.account.update(
  followingVisibility: 'followers', // 'public', 'followers', 또는 'private'
  followersVisibility: 'public',
  publicReactions: true,
  isLocked: true,                   // 팔로우 승인 필요
  hideOnlineStatus: true,
  noCrawle: true,
  preventAiLearning: true,
);

노트 고정 및 해제​

// 프로필에 노트 고정
final updated = await client.account.pin(noteId: noteId);

// 고정 해제
final updated = await client.account.unpin(noteId: noteId);

두 메서드 모두 업데이트된 MisskeyUser를 반환합니다.

즐겨찾기​

final favs = await client.account.favorites(limit: 20);
for (final fav in favs) {
  print(fav.note.text);
}

sinceId / untilId 또는 sinceDate / untilDate (밀리초 단위 Unix 타임스탬프)로 페이지네이션할 수 있습니다.

final older = await client.account.favorites(
  limit: 20,
  untilId: favs.last.id,
);

비밀번호, 이메일 및 토큰 관리​

비밀번호 변경​

await client.account.changePassword(
  currentPassword: 'hunter2',
  newPassword: 'correct-horse-battery-staple',
);

2단계 인증이 활성화된 경우 현재 TOTP 코드를 token으로 전달합니다.

이메일 주소 업데이트​

final updated = await client.account.updateEmail(
  password: 'mypassword',
  email: Optional('newemail@example.com'),
);

// 이메일 주소 제거
await client.account.updateEmail(
  password: 'mypassword',
  email: Optional.null_(),
);

API 토큰 재생성​

호출이 완료되면 현재 토큰은 즉시 무효화됩니다.

await client.account.regenerateToken(password: 'mypassword');

토큰 폐기​

await client.account.revokeTokenById(tokenId);
await client.account.revokeTokenByToken(tokenString);

내보내기 및 가져오기​

모든 내보내기 작업은 비동기 작업으로 대기열에 추가됩니다. 완료 시 알림이 전송됩니다.

데이터 내보내기​

await client.account.exportNotes();
await client.account.exportFollowing(excludeMuting: true, excludeInactive: true);
await client.account.exportBlocking();
await client.account.exportMute();
await client.account.exportFavorites();
await client.account.exportAntennas();
await client.account.exportClips();
await client.account.exportUserLists();

데이터 가져오기​

이전에 내보낸 파일의 드라이브 파일 ID를 전달합니다.

// 먼저 파일을 드라이브에 업로드한 다음 ID를 전달합니다
await client.account.importFollowing(fileId: driveFileId, withReplies: true);
await client.account.importBlocking(fileId: driveFileId);
await client.account.importMuting(fileId: driveFileId);
await client.account.importAntennas(fileId: driveFileId);
await client.account.importUserLists(fileId: driveFileId);

로그인 기록​

final history = await client.account.signinHistory(limit: 20);
for (final entry in history) {
  print('${entry.createdAt} — ${entry.ip}');
}

하위 API​

AccountApi는 세 가지 하위 API를 속성으로 제공합니다.

레지스트리​

레지스트리는 클라이언트 애플리케이션을 위한 임의의 키-값 데이터를 저장합니다 (브라우저의 localStorage와 동일하지만 기기 간에 동기화됩니다).

// 값 읽기
final value = await client.account.registry.get(
  key: 'theme',
  scope: ['my-app'],
);

// 값 쓰기
await client.account.registry.set(
  key: 'theme',
  value: 'dark',
  scope: ['my-app'],
);

2단계 인증​

// TOTP 등록 시작
final reg = await client.account.twoFactor.registerTotp(password: 'mypassword');
print(reg.qr); // UI에 표시할 QR 코드 데이터 URL

// 인증 앱의 첫 번째 코드로 TOTP 확인 및 활성화
await client.account.twoFactor.done(token: '123456');

웹훅​

// 웹훅 생성
final webhook = await client.account.webhooks.create(
  name: 'My webhook',
  url: 'https://example.com/hook',
  on: ['note', 'follow'],
  secret: 'supersecret',
);

// 웹훅 목록 조회
final webhooks = await client.account.webhooks.list();