68 lines
3.1 KiB
Markdown
68 lines
3.1 KiB
Markdown
## Forward Assist — Wiki & Gitea Access
|
|
|
|
**Wiki (Outline):** https://wiki.jfamily.io/api/
|
|
- Auth: `Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT`
|
|
- No MCP available — use curl to Outline REST API
|
|
- Key endpoints: `documents.list`, `documents.info`, `documents.create`, `documents.update`, `documents.search`, `collections.list`
|
|
- All POST, all take JSON body, all return JSON
|
|
|
|
### Forward Assist Collection
|
|
|
|
- **Collection ID:** `d1f85b19-030d-4a39-a6fd-317d6825fdfe`
|
|
- **Master Prompt:** `82ea3344-b55e-46d9-bcb6-a03eec252261`
|
|
- **Project Design Reference (PDR):** `f33885c7-261f-46ed-9ff9-5348615b5b2e`
|
|
- **Claude Code Log:** `7ce13c60-dc93-4af3-85ae-8e407c5ca66b`
|
|
- **User Manual:** `ebc0b8ea-8e4b-4e35-9817-77d31c0ed3ea`
|
|
- **Changelog:** `7a3b0ae0-3d0a-4433-aca8-e494f9fd8fa2`
|
|
- **The ScratchPad:** `d15c7e5d-b6f5-4e2a-aecb-a3782f8dc694`
|
|
- **Bugs!:** `172adb16-ca91-4005-89d4-5ff0c90221e2` (child of ScratchPad)
|
|
- **Change Orders!:** `cdaff737-aa78-4d85-b28b-8745968d9294` (child of ScratchPad)
|
|
- **Feature Ideas!:** `3d5e036f-33c3-4bea-b129-74e5464ed182` (child of ScratchPad)
|
|
|
|
```bash
|
|
# List collections
|
|
curl -s -X POST "https://wiki.jfamily.io/api/collections.list" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" -d '{}'
|
|
|
|
# List docs in a collection
|
|
curl -s -X POST "https://wiki.jfamily.io/api/documents.list" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"collectionId": "<id>"}'
|
|
|
|
# Read a doc
|
|
curl -s -X POST "https://wiki.jfamily.io/api/documents.info" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"id": "<doc-id>"}'
|
|
|
|
# Update a doc
|
|
curl -s -X POST "https://wiki.jfamily.io/api/documents.update" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"id": "<doc-id>", "text": "<full markdown>"}'
|
|
|
|
# Create a doc
|
|
curl -s -X POST "https://wiki.jfamily.io/api/documents.create" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"title": "...", "text": "...", "collectionId": "<id>", "publish": true}'
|
|
|
|
# Create a child doc (add parentDocumentId)
|
|
curl -s -X POST "https://wiki.jfamily.io/api/documents.create" \
|
|
-H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"title": "...", "text": "...", "collectionId": "<id>", "parentDocumentId": "<parent-id>", "publish": true}'
|
|
```
|
|
|
|
**Tip:** For long/complex markdown, use Python `urllib.request` + `json.dumps()` instead of inline curl to avoid JSON escaping headaches.
|
|
|
|
---
|
|
|
|
**Gitea:** git@git.jfamily.io (SSH, port 2222)
|
|
- SSH alias configured: `ssh git@git.jfamily.io`
|
|
- Web: http://192.168.1.204:3000 (user: eric)
|
|
- API: http://192.168.1.204:3000/api/v1/
|
|
- To generate API tokens: `ssh ragnar "pct exec 104 -- docker exec -u git gitea gitea admin user generate-access-token --username eric --token-name <name> --scopes all"`
|