Developer documentation REST API v1

Integrate once.
Keep the evidence.

MessageHop accepts requests from trusted customer servers, binds them to a Registered App, and keeps acceptance, provider, delivery, and financial states explicit.

01 · First request

Quickstart

Register a server app, protect its show-once credential, submit an idempotent message, and read its state.

02 · Security

Authentication

Understand credential format, tenant and app scope, actions, channels, environment, expiry, rotation, and revocation.

03 · Contract

API reference

Requests and responses for message acceptance, message status, balance projections, usage activity, and release checks.

04 · Automation

Agent integration

Authenticate users, register Organizations and apps, issue scoped credentials, and verify effective authority over HTTP.

05 · Reliability

Idempotency

Choose stable operation keys, retry safely, handle ambiguous networks, and recognize material-request conflicts.

06 · Recovery

Errors and retries

Use HTTP status, stable error code, request ID, and operation evidence to decide whether and how to retry.

07 · Trust

Security model

Tenant isolation, server-side secrets, least privilege, audited commands, billing integrity, and support privacy.