45 lines
2.3 KiB
Markdown
45 lines
2.3 KiB
Markdown
# +feed-group-query-item
|
|
|
|
> Shortcut for `lark-cli im +feed-group-query-item`. Look up specific feed cards inside one feed group (tag) by ID, enriched with a readable `chat_name`.
|
|
|
|
`+feed-group-query-item` is the only CLI surface for the `feed.groups.batch_query_item` read API — there is no raw `feed.groups batch_query_item` command. It resolves a human-readable `chat_name` for every feed card it returns: a v1 feed card's `feed_id` is always a chat ID (`oc_xxx`), so the shortcut issues a follow-up `POST /open-apis/im/v1/chats/batch_query` and injects `chat_name` into each entry of both `items[]` and `deleted_items[]`.
|
|
|
|
## Identity
|
|
|
|
User-only. Run with `--as user`.
|
|
|
|
## Scopes
|
|
|
|
Because chat-name resolution always runs, this shortcut needs **two** user scopes unconditionally:
|
|
|
|
- `im:feed_group_v1:read` — to read the items
|
|
- `im:chat:read` — to resolve names
|
|
|
|
`chat_name` resolution always runs, so there is no single-scope, un-enriched path. For the other raw `feed.groups.*` methods, see [lark-im-feed-groups.md](lark-im-feed-groups.md).
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
lark-cli im +feed-group-query-item --as user \
|
|
--feed-group-id ofg_xxx --feed-id oc_a,oc_b
|
|
```
|
|
|
|
## Flags
|
|
|
|
| Flag | Required | Description |
|
|
|---|---|---|
|
|
| `--feed-group-id` | Yes | Feed group ID (`ofg_xxx`); path parameter |
|
|
| `--feed-id` | Yes | Comma-separated chat IDs (`oc_xxx`); `feed_type` is fixed to `chat` |
|
|
|
|
## Output
|
|
|
|
The command sends `{"items":[{"feed_id":"oc_a","feed_type":"chat"},{"feed_id":"oc_b","feed_type":"chat"}]}`, then enriches the response (`items[]` and `deleted_items[]`) with `chat_name` exactly as `+feed-group-list-item` does. There is no pagination for this method.
|
|
|
|
A feed card whose chat cannot be resolved (soft-deleted or no permission) simply omits `chat_name` — the command still exits 0. p2p (direct) chats also omit `chat_name`: the server returns an empty `name` for them (the client UI shows the partner's display name instead); if a label is needed, fetch the chat via `chats/batch_query`, read `p2p_target_id`, and resolve it with a contact lookup.
|
|
|
|
## See also
|
|
|
|
- [lark-im-feed-groups.md](lark-im-feed-groups.md) — raw `feed.groups.*` APIs, enums, and rule guidance
|
|
- [lark-im-feed-group-list.md](lark-im-feed-group-list.md) — list your feed groups
|
|
- [lark-im-feed-group-list-item.md](lark-im-feed-group-list-item.md) — list all feed cards in a group (paginated)
|