John O'Keefe
cfcd95b25e
The generator moves into the Go toolchain per repo preference: internal/docs/bruno_gen.go emits the OpenCollection mirrors (same output contract — gate-verified example-request bodies, env-var params, device-token headers, login/register/refresh token-capture scripts) and TestBrunoMirrorsDocs grows a -update flag: verification by default, regeneration on demand: go test ./internal/docs -run TestBrunoMirrorsDocs -update Generator and checker are now the same code — they cannot drift apart. scripts/gen_bruno_from_docs.py deleted; opencollection.yml README points at the go-test command. Also fixed vs the Python pass: mirror placement follows the docs tree folder (RelPath), not the area frontmatter (several docs — highlights, notes, ratings, users, progress — carry a different area); docs blocks emit the collection's mapping form (content + type), not a bare scalar; JSON body sanity is checked at generation time. Idempotent: back-to-back -update runs are byte-identical. make test green (9 pkgs).
38 lines
922 B
YAML
38 lines
922 B
YAML
info:
|
|
name: Create Media Bookmark
|
|
type: http
|
|
seq: 3
|
|
|
|
http:
|
|
method: POST
|
|
url: '{{base_url}}/api/media-items/{{media_item_id}}/bookmarks'
|
|
auth: inherit
|
|
body:
|
|
type: json
|
|
data: |-
|
|
{
|
|
"title": "Chapter 3",
|
|
"position": "kindle:pos:1:2",
|
|
"notes": "revisit this",
|
|
"cfi_position": "epubcfi(/6/4)",
|
|
"page_number": 42,
|
|
"chapter_number": 3,
|
|
"percentage": 35.5,
|
|
"chapter_reference": 3,
|
|
"origin": "android"
|
|
}
|
|
settings:
|
|
encodeUrl: true
|
|
timeout: 0
|
|
followRedirects: true
|
|
maxRedirects: 5
|
|
|
|
docs:
|
|
content: |-
|
|
# Create Media Bookmark
|
|
|
|
`POST /api/media-items/:id/bookmarks` — auth: jwt.
|
|
|
|
Canonical reference: docs/developer/api/media-items/create_media_bookmark.md (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, then run the drift test with -update.
|
|
type: text/markdown
|