Developer Platform
Reseller / Developer API Platform
Your Identity for WEB3 and Beyond!

API Overview API Functions (58)
        
Active Pending Reserved
   
API Endpoints

Communication with the API clusters require access to our API Endpoints.
Our public endpoints are able to to deliver all public data for the active functions.
Some functions may require additional auth data to communicate.

Reseller partners are assigned a dedicated API Server to use for communication.
Please consult with your partnership manager.

API Endpoint Attributes
https://master.bns.technology/call.cfm?apikey=public &command=explore
&name=^MyName
REQUIRED
All public data will be avilable with the public API endpoint. The name can be a full blockchain name with its functions and attributes such as this example: ^MyName.key.btc or ^MyName.social.profileimage

Anyone can easily explore and retrieve public data for any active Blockchain Name. The structure to the API is simple. Use the same endpoint and attributes along with the full blockchain name. If data is assigned, it will be dissplayed in an easy to read JSON format. Access and storage of the data can be on a blockchain or IPFS file storage or multiple services. Our return data will display anything we have available.

Example API Call:
https://master.bns.technology/call.cfm?apikey=public&command=explore&name=^baker.social.profile
Return Data:
{"COLUMNS":["NAMEFUNCTION","NAMEPARENT","NAMECHILD","DATEADDED","STATUS","METATITLE","METADATA"], "DATA":[["social","profile","displayname","11/22/2023","Active","displayname","MrBaker"],["social","profile","profileimage","11/25/2023","Active","profileimage","https://ipfs-144.dataspaces.cloud/ipfs/QmedMVPMDnt2U6tjSVkWCbbBCvDdE1Zv4dSRbU8aUU4HMv"],["social","profile","coverimage","11/25/2023","Active","coverimage","https://ipfs-144.dataspaces.cloud/ipfs/QmWhNzrQw5SfhLyxxEYpTm2ENVTrYgsPt2vjGDN5D33Tde"]]}

Return Data

The most common retuen will be given in JSON format unless the return is only one word, phrase or number, which will just be returned with no formating. This return data may be defined by adding additional attributes to the blockchain name.

ie; ^MyName.social.profile will retun all of your social profile data. If only the diplayname is required, then the blockchain name will reflect the attriburs with ^MyName.social.profile.displayname Another example with public keys ^MyName.key will return all assigned public keys and ^MyName.key.btc.mywallet will return only the one btc address with the nickname of mywallet. And yes ^MyName.key.btc will retun all btc assignemts.



Blockchain Names and its API is a service of Global Data Spaces, Inc. ©2023 All Rights Reserved