REST API Rules

This document describes the common rules for the REST API. For integration instructions, start with REST API Overview.

Common Rules

• The current version contains REST APIs only
• All successful 2xx responses return data
• All error responses omit data
• message is a human-readable description and must not be used for program branching
• Clients may branch only on HTTP status and code
• Relay commands must define idempotency and retry semantics