latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

External Wallet Access Mode

Mint the user's URID

Mints the URID NFT for a new user (account status must be Na). Requires GeeTest verification fields. The tokenId header carries the pre-generated URID.

post/api/v1/mint

Headers

tokenIdstring required

The user's URID (NFT token id).

networkstring required

Network identifier: 5000 for mainnet, 5003 for testnet.

Request body

addressstring required

User's Ethereum wallet address.

lotNumberstring required

GeeTest verification session ID.

captchaOutputstring required

GeeTest verification output result.

passTokenstring required

GeeTest pass token.

genTimestring required

GeeTest generation timestamp (seconds).

imagestring

NFT image (Base64). Optional.

backGroundColorstring

Background color (hex). Optional.

landstring

Land information. Optional.

Response

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

retCodeinteger required

0 on success; non-zero indicates failure.

retMsgstring required

Human-readable message; error details when retCode is non-zero.

{"stackTrail":"components:schemas:EwaEnvelope:properties:result","oasType":"schema","type":"unknown","description":"Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string."}

timeNowinteger

Server timestamp in milliseconds.