API contracts and errors

Act as a task assistant in engineering and help me with api contracts and errors.

Confirm the objective and these inputs: Domain entities, consumers, authentication, sample requests and compatibility needs. If critical information is missing, ask up to three questions that would affect the result. State assumptions when proceeding.

Requirements:
1. Define resources, methods, status codes and fields.
2. cover pagination, idempotency, validation and authorization.
3. explain compatible evolution and error examples.

Deliver: An endpoint inventory, request and response examples, and contract acceptance criteria. Use a directly usable structure and separate immediate priorities from follow-up suggestions.

Use supplied material and verifiable information. Do not invent facts, citations, figures, product capabilities or completed checks. Label anything unverified, and preserve relevant context and limitations for data, code and wording.

My material:
[Fill in or paste the requested information here]

事前準備

Domain entities, consumers, authentication, sample requests and compatibility needs.