Build your own server HTTP client

For Ruby, PHP, Python, Elixir, Go, Java, and other server stacks — implement a thin read-only client over two HTTP GETs. Node/TypeScript apps should use @stringpush/node instead.

Contract

Manifest

GET {apiBaseUrl}/v1/applications/{applicationId}/manifest?environment=staging
Authorization: Bearer {runtimeApiKey}
Origin: https://app.example.com
Accept: application/json

Bundle

Use manifest.locales[locale].url:

• Relative URL → same auth headers as manifest
• Absolute CDN URL → no Authorization (public JSON)

Bundle body: { "key.path": "string value", ... } with optional ICU MessageFormat.

curl

curl -sS -H "Authorization: Bearer trt_…" -H "Origin: https://app.example.com" \
  "https://api.platform.stringpush.com/v1/applications/{appId}/manifest?environment=staging"

Your client should

1. Fetch manifest, then bundle for the active locale
2. Resolve t(key) from the bundle map
3. Send Origin = public browser origin (allowlisted in admin)
4. Cache per locale (~5 min) under load
5. Keep overlay on the browser — use @stringpush/sdk for staging edit mode

JSON Schema (codegen)

After pnpm add @stringpush/runtime-core, see node_modules/@stringpush/runtime-core/fixtures/:

• manifest.schema.json
• bundle.schema.json
• manifest.staging.json + bundles/*.json samples

Language examples

Full Ruby, PHP, Python, and Elixir sketches: internal monorepo guide docs/integration/server-http-client.md — or ask your AI assistant:

Read https://docs.platform.stringpush.com/integration/server-http-client
and https://docs.platform.stringpush.com/concepts/manifest-and-bundles.
Implement a minimal StringPush server runtime for Rails (or Laravel / Phoenix / Django).
Include manifest + bundle fetch with Origin header and simple {name} interpolation.

Alternatives

Need	Path
Node / Next / Nuxt SSR	@stringpush/node
Locale files in Git	Git sync
Browser SPA	@stringpush/sdk

AI setup

• Docs MCP — read this page and manifest docs; generate your wrapper
• Setup MCP — create application + runtime key (agents guide)