jointrashposs/content/ja-JP/.docs-legacy/api/endpoints/users/search-by-username-and-host.json5
kakkokari-gtyih a8dca2c347 migrate docs
2023-07-11 00:44:03 +09:00

61 lines
1.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
summary: 'ユーザー名・ホスト名からユーザーを検索します。',
description: 'ユーザー名・ホスト名からユーザーを検索します。30日間投稿のないユーザーや、凍結されているユーザーは除外されます。結果はユーザーの最後の投稿が新しい順にソートされます。ログイン中であれば認証情報が送信されれば、フォローしているユーザーを優先的に検索します。',
tags: [
'users',
],
requireCredential: false,
req: {
type: 'object',
properties: {
username: {
type: 'string',
nullable: true,
description: 'ユーザー名。',
},
host: {
type: 'string',
nullable: true,
description: 'ユーザーが所属するサーバーのホスト名ドメインなど。ローカルユーザーを対象にする場合はnullを指定します。',
},
limit: {
type: 'integer',
minimum: 1,
maximum: 100,
default: 10,
description: '取得するユーザーの最大数。',
},
detail: {
type: 'boolean',
default: true,
description: 'trueにすると、ユーザーの詳細な情報を返します。',
},
},
anyOf: [
{
required: [
'username',
],
},
{
required: [
'host',
],
},
],
},
res: {
type: 'array',
optional: false,
nullable: false,
items: {
type: 'object',
optional: false,
nullable: false,
ref: 'User',
$ref: 'misskey://User',
},
},
errors: {},
}