API Help
API Help
Integration checklist
Authentication and production environment
- [ ] Use an API key created in the production environment.
- [ ] Store API keys only in the caller's server-side application.
- [ ] Use the production Base URL.
- [ ] Send exactly one
X-API-Keyheader with every request.
Requests and responses
- [ ] Send POST/PATCH requests with
Content-Type: application/json. - [ ] Use
snake_casefor JSON fields and query parameters. - [ ] Handle amounts and traffic as strings, and do not convert IDs to low-precision numeric types.
- [ ] Determine success from response-body
code = 0, not only HTTP200. - [ ] Treat non-
200, non-JSON, and empty responses as transport failures. Read operations may be queried again; for write operations, verify the current result or state first. - [ ] Save any available
X-TRACE-ID, but do not log API keys or proxy passwords.
Creation requests
- [ ] Generate a unique
request_nofor every business operation. - [ ] Understand that
request_noonly prevents duplicate acceptance; it is not a result-query key and does not guarantee replay of the original result. - [ ] If the outcome of a write request is uncertain, query the result first instead of blindly resubmitting with the original or a new request number.
- [ ] Store the request number, request content, call time, production Base URL, any available
X-TRACE-ID, and the returned order number. - [ ] Never provide an API key when contacting support.
Asynchronous static proxy workflows
- [ ] Filter the order list by the exact
order_no. Stop automatic polling when a purchase order reachesSUCCESS,PARTIAL_SUCCESS, orFAILED. - [ ] Stop automatic polling when a renewal order reaches
COMPLETEDorFAILED. - [ ] For a
SUCCESSorPARTIAL_SUCCESSpurchase order, list static proxy resources to obtain connection details for successfully fulfilled resources. - [ ] Retain polling and recovery queries even when a callback is configured.
- [ ] Use the fixed production public key described in the callback guide, and verify the timestamp, line break, and raw request body with RSA-SHA256.
- [ ] Verify that the callback timestamp differs from the current time by no more than five minutes. Do not trigger business queries if signature verification fails.
- [ ] Deduplicate callback processing by
order_no. - [ ] Design recovery queries around the rule that each order receives at most one callback, failed delivery is not retried, and no second callback is sent.
- [ ] Do not treat a callback as the sole source of the order result.
- [ ] Query the corresponding order list and static proxy resources again after manual handling by support.
Sensitive information
- [ ] Do not write API keys, proxy accounts, passwords, or connection credentials to ordinary logs.
- [ ] Do not place responses containing sensitive fields in shared caches or error pages.
- [ ] If you suspect API key exposure, revoke and replace the key immediately in the web console.