Xooa Docs

The FAQs are aimed to educate, inform and guide you through both User Minted and Platform Minted Marketplaces on our application.

How to mint NFT programmatically?

NFTs can be minted programmatically using the Xooa API.

Following are the steps to try the Mint Token API:

Go to Xooa API URL - https://api.ci.xooa.io/.
Enter API Token - generate in Design Console -> Identities -> App admin -> Regenerate Token.
Copy the token to API Token box in Xooa API URL and click -> (Right Arrow).
After successful authorization, the ‘Authorized as NFT Marketplace Admin’ message appears below.
Click NFT -> Mint Token and fill in the details.
Click TRY.
If the minting is successful, the response will contain the result with response details and the 202 response code.

How do I access API endpoints?

Sign in to your White-Label NFT marketplace design console.
On the left-hand panel, click API.
Click Sandbox to open the page. You will find the API endpoint details here.

How to integrate the marketplace with Auth0 for single sign-on?

Prerequisite:

User must have an Auth0 account.
User must be an app admin in the White-Label NFT marketplace.

Steps to integrate the marketplace with Auth0

Configure App URL in Auth0
1. Sign in to Auth0 account and copy the Domain ID from My App.
2. Sign in to your White-Label NFT marketplace design console.
3. On the Publish page -> click Sign In Settings.
4. Enable the Single Sign On.
5. Paste the Domain ID that you copied from My App.
6. Go back to My App and copy the Client ID and paste in the Client ID field in the marketplace.
7. Click Save.
8. Copy the URL under the client ID field.
9. Go to My App -> Settings -> Application URLs.
10. Paste the URL address in the following sections:
  - Allowed Callback URLs
  - Allowed Logout URLs
  - Allowed Web Origins
  - Allowed Origins
11. Click Save changes.
Create App User using API
1. On the left-hand panel, go to User Management -> Users -> click Create User.
2. Fill in the details and click Create. Your user ID is created.
3. Go back to the design console of your marketplace -> Click API -> Identities.
4. Copy the Public Key from the newly created ID (usually shown at the top of the result).
5. Click API -> Sandbox -> click Explore APIs to open Xooa API Explorer page.
6. Paste the API Token in the field and click the arrow next to the field.
7. Go to Identities page -> click Add New.
8. Give a name and set the API Access Permission to Read+Write.
9. Click Create.
10. Copy the API Token from the popup and paste the API Token in the field.
11. Click the arrow next to the field. A message will confirm the authorization.
12. On the same page, go to App User -> List roles -> click TRY.
13. Copy the ID for NFT User.
14. Paste it in the user parameters -> Roles field in the API Explorer’s Create page.
  - Copy your user id from My App and paste it in the email ID field in the API Explorer’s Create page.
  - Go to My App -> Applications -> click Applications -> copy Domain ID.
  - Paste the domain ID as the “@ ID” (replace xooa.com).
15. Click TRY and check the keys in the popup.
Verify Mint Token using API
1. Go to API Explorer -> NFT -> Mint Token -> fill in parameters -> click TRY.
2. Copy the token id from the Mint Token popup page. Copy it in Notes.
3. Go to NFT -> Transfer -> paste the token id that was copied.
4. Go to App Users -> List roles -> copy the email parameter.
5. Go to NFT -> Transfer -> paste the email parameter in the ‘To’ field -> click Try.
6. From the design console click Launch App -> NFT User -> Sign In.
7. Go to NFT Wallet -> click to view the token.

How to get API token to access the marketplace API?

In the design console of the NFT marketplace, go to API -> click Identities.
Under the Name column, find the Admin identity.
From the Actions menu, select Regenerate API Token.

Note

This action also invalidates the previous API Token, so it may require reconfiguration of already deployed client applications. API Token regeneration has the same impact as deleting and recreating an identity.