Visitar URL original
bindings: read server info with ?mode=basic and wait on /api/v1/ready by tae898 · Pull Request #102 · humemai/arcadedb-embedded-python · GitHub
Skip to content

bindings: read server info with ?mode=basic and wait on /api/v1/ready - #102

Merged
tae898 merged 1 commit into
mainfrom
server-endpoint-basic-and-ready
Oct 3, 2026
Merged

tae898 merged 1 commit into
mainfrom
server-endpoint-basic-and-ready

Conversation

@tae898

@tae898 tae898 commented Oct 3, 2026

Copy link
Copy Markdown

The ArcadeData#8909 sweep, with the user's go-ahead (2026-10-03). On 26.9.1 and earlier the first full GET /api/v1/server after a start takes about 20 s (ArcadeData#8909, fixed for 26.10.1 by ArcadeData#8911). Where the bindings only need the version, server name, or languages, ?mode=basic returns them without the metrics section; where they only need to know the server is up, /api/v1/ready answers 204 without authentication.

  • tests: test_server_packaging reads the version from the basic form; the test_server_http_endpoints fixture polls /api/v1/ready (its 5 s per-attempt timeout could never outlast a 20 s first call).
  • examples: example 23 and the vector latency probe wait on the basic form.
  • docs: the server guide and the API access page use the basic form and name the readiness endpoint.

POST /api/v1/server (server commands) is unchanged. Checked: both changed test files pass (9), example 23 runs and prints version, server name, and languages from the basic form, pre-commit clean.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Lj5isEaoaGCeaZe5nNoWX4

…ArcadeData#8909 sweep)

The full GET /api/v1/server answer computes a metrics section that took
about 20 s on the first call after a start on 26.9.1 and earlier
(ArcadeData#8909, fixed for 26.10.1 by ArcadeData#8911). Where we only need
the version, server name, or languages, ?mode=basic returns them without
it; where we only need to know the server is up, /api/v1/ready answers 204
without authentication. Checked on the current engine: ready 204, basic
carries instanceId, languages, serverName, user, and version.

- tests: the packaging test reads the version from the basic form; the
  HTTP endpoint fixture polls /api/v1/ready (its 5 s per-attempt timeout
  could never outlast a 20 s first call).
- examples: example 23 and the vector latency probe wait on the basic form.
- docs: the server guide and the API access page use the basic form and
  name the readiness endpoint.

POST /api/v1/server (server commands) is unchanged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lj5isEaoaGCeaZe5nNoWX4
@tae898
tae898 merged commit bd31462 into main Oct 3, 2026
48 checks passed
@tae898
tae898 deleted the server-endpoint-basic-and-ready branch October 7, 2026 14:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant