Best Practices for Integrating Partner API
Here are best practices to ensure the proper integration of the Unstoppable Domains Partner API into your applications:
Simplify Your Domain Search Fields With the Domains Suggestions Endpoint
Instead of making API calls to both the Domain Name Availability and Get Domains Suggestions endpoints to check the availability of a domain name and generate domain suggestions for a domain search field, you can make a single request to the
Get Domains Suggestions endpoint with the requested domain name as a
search parameter. If the domain name is available, it will be at the top of the list, along with other suggestions.
Utilize Free Domains as an Incentive To Complete KYC
Since distributing Free Domains requires strict anti-abuse measures, such as KYC, we recommend claiming a free domain as an incentive to complete KYC within your application.
Only Pre-fill Crypto Records if Your App Is a Wallet
Unstoppable Domains Partner API can pre-fill crypto payment addresses for the user during the minting process, which adds complexity to the implementation. Therefore, we only recommend doing this if your application is a wallet since wallets contain the addresses of various cryptos for the user.
Don’t Use Your Secrets in the Frontend
Using your Partner API key from the backend of your application is recommended rather than the frontend. If the API key is placed in the frontend, it becomes accessible by anyone who has access to the client-side code, increasing the risk of unauthorized access or misuse. To protect against this, use the API key from the backend to keep it secure.
Asking For Help
If you are experiencing difficulties using our services, please know that we are here to help. You can join our Discord Community for real-time support from UD and the community, where you can receive assistance with integrating your app