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

Header parameters

tokenIdstringRequired

The user's URID (NFT token id).

networkstringRequired

Network identifier: 5000 for mainnet, 5003 for testnet.

Body

addressstringRequired

User's Ethereum wallet address.

lotNumberstringRequired

GeeTest verification session ID.

captchaOutputstringRequired

GeeTest verification output result.

passTokenstringRequired

GeeTest pass token.

genTimestringRequired

GeeTest generation timestamp (seconds).

imagestringOptional

NFT image (Base64). Optional.

backGroundColorstringOptional

Background color (hex). Optional.

landstringOptional

Land information. Optional.

Responses

200

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.

application/json

Standard response envelope for the user API (api.ur.app).

retCodeinteger · int64Required

0 on success; non-zero indicates failure.

retMsgstringRequired

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

resultanyOptional

Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string.

timeNowinteger · int64Optional

Server timestamp in milliseconds.

post/api/v1/mint

POST /api/v1/mint HTTP/1.1
Host: api.ur.app
tokenId: text
network: text
Content-Type: application/json
Accept: */*
Content-Length: 150

{
  "address": "text",
  "lotNumber": "text",
  "captchaOutput": "text",
  "passToken": "text",
  "genTime": "text",
  "image": "text",
  "backGroundColor": "text",
  "land": "text"
}

200

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.

{
  "retCode": 0,
  "retMsg": "success",
  "result": "{\"tokenId\":\"12345\",\"txHash\":\"0xabc...\"}",
  "timeNow": 1703123456789
}