feishu-doc-editor

# Feishu Document Editor Skill This skill provides comprehensive guidance for creating and editing Feishu documents using the Feishu OpenAPI. ## Prerequisites ### 1. App Creation and Configuration **Create enterprise self-built app**: Login to Feishu Open Platform, create an app and add "Bot" capability. **Apply for API permissions**: In "Permission Management", apply for the following permissions: - Document editing: `docx:document:write_only` - Document viewing: `docx:document:readonly` **Publish app**: Submit version and publish, ensuring the app coverage includes target users/departments. ### 2. Get Access Token Call the self-built app get tenant_access_token interface: ```bash curl -X POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal \ -H "Content-Type: application/json" \ -d '{"app_id": "your_app_id", "app_secret": "your_app_secret"}' ``` Response example: ```json { "code": 0, "tenant_access_token": "t-xxx", "expire": 7200 } ``` ## Core Operations ### Extract Document ID Get `document_id` from document URL: **Example URL**: `https://bigdatacenter.feishu.cn/docx/HpK2dtGu9omhMAxV12zcB6i7ngd` **document_id** = `HpK2dtGu9omhMAxV12zcB6i7ngd` ### Grant App Document Permission **Manually add collaborator**: - Open document in Feishu client → Click "..." in top right → "More" → "Add document app" - Search and add your app, grant "Can edit" permission. ### Write Text Content **Interface**: Create Block - **Path parameters**: `document_id` = document ID, `block_id` = document ID (root node is the document itself) - **Request headers**: ```http Authorization: Bearer {tenant_access_token} Content-Type: application/json ``` - **Request body example** (write "hello"): ```json { "index": -1, "children": [ { "block_type": 2, "text": { "elements": [ { "text_run": { "content": "hello" } } ] } } ] } ``` ### Read Document Content **Interface**: Get Document Plain Text ```bash curl -X GET "https://open.feishu.cn/open-apis/docx/v1/documents/{document_id}/plaintext" \ -H "Authorization: Bearer {tenant_access_token}" ``` Response example: ```json { "code": 0, "data": { "content": "Document text content here" } } ``` ## Common Issues ### 1. Permission Error (403 Forbidden) - **Diagnosis**: App not added as document collaborator, or `tenant_access_token` is invalid. - **Solution**: Re-add app as collaborator, or re-get `tenant_access_token`. ### 2. Missing Access Token (99991661) - **Diagnosis**: Request header does not carry `Authorization: Bearer {token}`. - **Solution**: Ensure `tenant_access_token` is correctly added to request header. ### 3. Document Not Found (404 Not Found) - **Diagnosis**: `document_id` is incorrect or document has been deleted. - **Solution**: Re-extract `document_id` from document URL. ## Reference Documentation - Create Block Interface - Get Document Plain Text Interface - Permission Configuration Guide Through the above steps, you can achieve editing Feishu documents via API, supporting add/delete/modify/query operations for multiple content types including text, tables, and images.