Heepay Open Platform Code Generation

Problem

When integrating with the Heepay Open Platform, API payloads often contain many fields and nested objects. Manually translating interface documentation into Java request classes, response classes, tests, and local debug pages is error-prone, especially for @JsonProperty annotations, type mapping, and appending generated code into the same Maven project over time.

How It Works

This skill targets explicit API code generation tasks. It can be triggered when a user mentions an API method code such as pay.heepay.bank.apply, or describes business objects like payments, orders, invoices, or complaints. The workflow is anchored to the reference/hyw-demo/ Maven project so package layout, naming, and annotation style stay consistent.

Key steps include:

• Ask for the output path: generation confirms where to place the project, with a default location of generated/hyw-demo/.
• Fetch API metadata: a Python script returns data.info, data.request_fields, and data.response_fields, which drive the request, response, and nested object design.
• Generate project skeleton and Java code: on first generation, it adds files such as pom.xml, Application.java, lib/, and logback.xml, while placing VO classes under com.hyw.demo.vo.
• Generate tests and debug entries: it creates a test class, an HTML debug page, and a TestController for each API, then maintains the index.html endpoint list.
• Validate output: it checks field coverage, brace matching, type consistency, imports, and required @JsonProperty("original_json_name") annotations.

Boundaries

The skill is best suited to generating a Java/Maven client project when the Heepay method code is known. It does not design final payment, invoice, or complaint business rules by itself. Confirm that the API method code is correct, the output directory is writable, and repeated generation should append into the same hyw-demo structure. If field semantics, enum values, or merchant permissions are unclear, review the Open Platform documentation manually.