πZone
Check Name Availability
Checks the availability of a zone with the provided name.
GET
/api/v1/reseller-logic/zones/availability/{zone_name}
Request Headers
Name
Description
Authorization
Required: Bearer {Authorization}
This API endpoint allows users to check the availability of a specific Web3 zone name. By sending a GET request with the desired zone name as a parameter, the response will indicate whether the name is available or not. In the provided example response, the timestamp signifies the time of the request, and the data field indicates the availability status, where "false" suggests that the zone name is not available.
Response
200 OK
Create Zone
Creates a new zone based on the provided zone data.
POST
/api/v1/reseller-logic/zones?mint=boolean
This API endpoint allows users to create a new Web3 zone with specified details such as name, activation status, and records. The request body includes parameters like the desired subdomain name, its activation status, and an array of records containing information like record type, name, and value. Upon successful creation, the response provides a timestamp along with the unique identifier (UUID) of the newly created zone, its full domain name (including the assigned TLD), and an array of associated records with their respective UUIDs.
Request Headers
Name
Description
Authorization
Required: Bearer {Authorization}
Query Parameters
Parameter
Type
Description
mint
boolean
[Optional] Indicates whether to mint the zone. Default is false
.
Request Body
As uuid, we can use the following:
You can also create a new registrant using the create registrant endpoint under profile registry section.
Response
201 Created
In case an invalid TLD is passed, an error message is displayed to notify the user.
Response
400 Bad Request
Fetch Zones of Logged Reseller
Fetches the zones associated with the current user.
GET
/api/v1/reseller-logic/zones/self
This API endpoint retrieves Web3 zones owned by the logged-in reseller. The response includes metadata such as timestamp, page information (size, page number, total elements, total pages), and an array of data objects representing individual web3 zones. Each data object contains details about a specific zone, including its unique identifier (UUID), status, name, ASCII name, blockchain chain, contract address, token ID, registrar information (name, contact details, wallet address), reseller information (email, wallet address), registration date, expiration date, and grace end date.
Request Headers
Name
Description
Authorization
The authorization token for accessing the API.
Query Parameters
Parameter
Type
Description
page
integer
[Optional] The page number for pagination. Default value is 0.
pageSize
integer
[Optional] The page size for pagination. Default value is 25.
sortBy
string
[Optional] The field to sort the zones by. Default value is "name".
Response
200 OK
Update Zone Status
Updates zone status by uuid given the new status.
PATCH
/api/v1/reseller-logic/zones/{uuid}?status={new_status}
This API endpoint updates the status of a specific Web3 zone identified by its UUID. Users can specify the new status for the zone in the request query parameter.
Response
Trigger Minting Process
POST
/api/v1/reseller-logic/zones/minting
This API endpoint allows resellers to trigger the minting process for a specific zone identified by the name. The reseller needs to send a POST request with the zone name and provide details such as the destination blockchain chain where the minting will occur.
Request Body:
In the request body, the reseller specifies the destination blockchain where they want to mint the domain, as well as the name and wallet address.
Upon successful triggering of the minting process, the response will confirm the initiation of the minting process and provide relevant details.
Response
In the response, the timestamp indicates the time of the response and the chain field specifies the blockchain where the minting will occur.
This updated endpoint allows resellers to trigger the minting process themselves, providing flexibility in specifying the destination blockchain for minting provided that the assigned TLDs is on the chosen chain.
Check Minting Status
GET
/api/v1/reseller-logic/minting/{zoneName}
This API endpoint allows users to check the status of the minting process for a specific zone identified by its name. By sending a GET request with the zone name as a parameter, the response will indicate the current status of the minting process.
Request Headers
Name
Description
Bearer Token
[Required] The authorization token for accessing the API.
Response
If the status is in PENDING
, the transaction hash is not displayed. Once the transaction is COMPLETE
, the transaction hash is also provided.
Fetch Available Chains
GET /api/v1/reseller-logic/chains
This endpoint retrieves a list of available blockchain networks supported by the reseller logic system. It provides information about the different chains that users can interact with through the platform.
Request Headers
Name
Description
Bearer Token
[Required] The authorization token for accessing the API.
Response
Last updated