Errors

Errors always return an envelope with status: "failure" and an error object:

{
  "status": "failure",
  "data": null,
  "meta": null,
  "error": {
    "code": "BAD_REQUEST",
    "message": "workingTime must not be null"
  }
}

HTTP status mapping

Status	Backend exception	Meaning
400	BadRequestException	Malformed input, missing required field.
401	UnauthorizedException	Missing or invalid Origin or bearer token.
403	ForbiddenException	Origin not permitted to call this endpoint.
404	NotFoundException	Resource does not exist.
409	ConflictException	Duplicate or state conflict.
422	UnprocessableRequestException	Validation failed after parsing.
429	RateLimitException	Rate limit exceeded.
500	InternalServerException	Unexpected server error.

Retry policy

• 429 and 5xx: retry with exponential backoff (1s, 2s, 4s, 8s; give up after 5 tries).
• 4xx other than 429: do not retry — fix the request.

Reporting bugs

Include the x-request-id response header, timestamp, and full request/response in your bug report to support@homesoon.jp.