Layer Directory API
人・作品・SNS の正準ディレクトリ(公開読み)。Connect プロトコル(HTTP POST + JSON)。
サーバー:https://dev.layer.fan/api/directory
layer.directory.v1.DirectoryService
post/layer.directory.v1.DirectoryService/GetTalentGetTalent
パラメータ
| 名前 | 場所 | 型 | 必須 | 説明 |
|---|---|---|---|---|
| Connect-Protocol-Version | header | connect-protocol-version | ||
| Connect-Timeout-Ms | header | connect-timeout-header |
リクエストボディ
layer.directory.v1.GetTalentRequestレスポンス
| ステータス | スキーマ | 説明 |
|---|---|---|
| 200 | layer.directory.v1.GetTalentResponse | Success |
| default | connect.error | Error |
post/layer.directory.v1.DirectoryService/ListTalentsListTalents
パラメータ
| 名前 | 場所 | 型 | 必須 | 説明 |
|---|---|---|---|---|
| Connect-Protocol-Version | header | connect-protocol-version | ||
| Connect-Timeout-Ms | header | connect-timeout-header |
リクエストボディ
layer.directory.v1.ListTalentsRequestレスポンス
| ステータス | スキーマ | 説明 |
|---|---|---|
| 200 | layer.directory.v1.ListTalentsResponse | Success |
| default | connect.error | Error |
post/layer.directory.v1.DirectoryService/GetSeriesGetSeries
パラメータ
| 名前 | 場所 | 型 | 必須 | 説明 |
|---|---|---|---|---|
| Connect-Protocol-Version | header | connect-protocol-version | ||
| Connect-Timeout-Ms | header | connect-timeout-header |
リクエストボディ
layer.directory.v1.GetSeriesRequestレスポンス
| ステータス | スキーマ | 説明 |
|---|---|---|
| 200 | layer.directory.v1.GetSeriesResponse | Success |
| default | connect.error | Error |
スキーマ
layer.directory.v1.SocialPlatform
"SOCIAL_PLATFORM_UNSPECIFIED" | "SOCIAL_PLATFORM_X" | "SOCIAL_PLATFORM_INSTAGRAM" | "SOCIAL_PLATFORM_YOUTUBE" | "SOCIAL_PLATFORM_TIKTOK" | "SOCIAL_PLATFORM_WEBSITE"
layer.directory.v1.SocialStatus
"SOCIAL_STATUS_UNSPECIFIED" | "SOCIAL_STATUS_ACTIVE" | "SOCIAL_STATUS_INACTIVE"
layer.directory.v1.TalentSource
"TALENT_SOURCE_UNSPECIFIED" | "TALENT_SOURCE_CRAWLER" | "TALENT_SOURCE_USER" | "TALENT_SOURCE_ADMIN"
google.protobuf.Timestamp
RFC3339 の日時文字列(例: 2024-01-01T00:00:00Z)。
string<date-time>
layer.directory.v1.Character
character_node: kind=series をルート、character をその子とする closure tree。
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | ||
| parentId | string | series は空、character は series の id | |
| kind | string | series|character | |
| name | string | ||
| normalizedName | string |
layer.directory.v1.GetSeriesRequest
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string |
layer.directory.v1.GetSeriesResponse
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| series | layer.directory.v1.Character | ||
| characters | layer.directory.v1.Character[] | 直下の character 群 |
layer.directory.v1.GetTalentRequest
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | redirect を辿って canonical 解決 |
layer.directory.v1.GetTalentResponse
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| talent | layer.directory.v1.Talent |
layer.directory.v1.ListTalentsRequest
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | ||
| offset | integer | ||
| query | string | 名前部分一致(任意) |
layer.directory.v1.ListTalentsResponse
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| talents | layer.directory.v1.Talent[] | ||
| total | integer |
layer.directory.v1.Social
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | ||
| talentId | string | ||
| platform | layer.directory.v1.SocialPlatform | ||
| handle | string | website は空 | |
| platformUserId | string | 改名耐性の安定 id(不明なら空) | |
| url | string | ||
| status | layer.directory.v1.SocialStatus | ||
| isPrimary | boolean | ||
| source | string | extracted|claimed|manual | |
| firstSeenAt | google.protobuf.Timestamp | ||
| lastSeenAt | google.protobuf.Timestamp |
layer.directory.v1.Talent
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | ||
| name | string | ||
| normalizedName | string | ||
| ownerUserId | string | claim 済みなら OIDC sub(空=未claim) | |
| source | layer.directory.v1.TalentSource | ||
| socials | layer.directory.v1.Social[] | ||
| createdAt | google.protobuf.Timestamp | ||
| updatedAt | google.protobuf.Timestamp |
connect-protocol-version
Define the version of the Connect protocol
1
connect-timeout-header
Define the timeout, in ms
number
connect.error
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| code | "canceled" | "unknown" | "invalid_argument" | "deadline_exceeded" | "not_found" | "already_exists" | "permission_denied" | "resource_exhausted" | "failed_precondition" | "aborted" | "out_of_range" | "unimplemented" | "internal" | "unavailable" | "data_loss" | "unauthenticated" | The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. | |
| message | string | A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. | |
| detail | google.protobuf.Any |
google.protobuf.Any
任意の型を包む値(type + value)。
| プロパティ | 型 | 必須 | 説明 |
|---|---|---|---|
| type | string | ||
| value | string<binary> | ||
| debug | object |