飛書承認

Approval API を通じて承認インスタンスを作成および照会します。

ベース URL: https://open.feishu.cn/open-apis/approval/v4

認証とトークン取得

feishu_skills のルートディレクトリから共有スクリプトを実行します。

TOKEN="$(./scripts/get_feishu_token.sh)"

リクエストヘッダーはすべて Authorization: Bearer ${TOKEN} を使用します。

ビジネスインターフェースがトークン無効、期限切れ、または 401 を返した場合、強制的に更新した後、元のリクエストを一度だけ再試行します。

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

環境変数:

• FEISHU_APP_ID
• FEISHU_APP_SECRET

ローカルキャッシュ: ./.feishu_token_cache.json（期限切れでなければ直接再利用、デフォルトで 5 分前に更新）

承認インスタンス

インスタンス作成:

{
  "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
  "user_id": "ou_xxx",
  "form": "{\"widget1\":\"value1\"}"
}

承認タスク

承認定義

承認CC

承認コメント

共通パラメータ説明

user_id_type: ユーザーIDタイプ

• open_id（デフォルト）
• user_id
• union_id

ページネーションパラメータ:

• page_size: 1ページあたりの数（デフォルト 20、最大 100）
• page_token: ページネーショントークン

インスタンスステータス:

• PENDING: 承認中
• APPROVED: 承認済み
• REJECTED: 却下済み
• CANCELED: 撤回済み
• DELETED: 削除済み

テスト例

承認定義リストの取得:

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/approvals?page_size=10" \
  -H "Authorization: Bearer ${TOKEN}"

承認インスタンスの作成:

curl -X POST "https://open.feishu.cn/open-apis/approval/v4/instances" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
    "user_id": "ou_xxx",
    "form": "{\"widget1\":\"請假3天\"}"
  }'

インスタンスリストの照会:

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/instances?page_size=20&user_id=ou_xxx" \
  -H "Authorization: Bearer ${TOKEN}"

ベストプラクティス

1. まず承認定義を取得します（form フィールドを確認するため）
2. form は文字列化された JSON である必要があります
3. 承認操作には承認者の権限が必要です
4. ページネーション照会: 大量のデータは page_token でページネーションします
5. user_id は必須です: インスタンス作成とリスト照会には user_id の指定が必要です