User Identity

Define a user's identity

User Identity

The read access to Meroku's dApp Store Kit APIs doesn’t require any specific authentication.

In order to download the .app or visit its URL or rate the .app, a user id is required. This user id could be any identifier, that uniquely identifies a user. If your dApp Store Implementation has a notion of “user-id” or similar, that field should go here.

If your dApp Store has the user's wallet address, that can also be used.

Age

Certain .apps are age limited. In order to ensure you enable age-appropriate access, it is required to know the age of a user.

We recommend you ask the age of the user and store it "in the browser". This should be used as a filter parameter in the listings.

Example: The following CURL request filters .apps with a query to age greater than 18

curl --request GET \
  --url 'https://api.meroku.store/api/v1/dapp/search?search=nft&minAge=18' \
  --header 'Accept: application/json' \
  --header 'apikey: YOUR_API_KEY'

Geography

Certain .apps are geo limited. In order to ensure you enable location-appropriate access, it is required to know the country of usage of a user.

We recommend you use device location or IP address to deduce the location and use the country as a filter parameter in the listings.

Ex: To filter based on allowedInCountries

curl --request GET \
  --url 'https://api.meroku.store/api/v1/dapp/search?search=nft&allowedInCountries=us&minAge=18' \
  --header 'Accept: application/json' \
  --header 'apikey: YOUR_API_KEY'

For example: To filter based on blockedInCountries

curl --request GET \
  --url 'https://api.meroku.store/api/v1/dapp/search?search=nft&blockedInCountries=us&minAge=18' \
  --header 'Accept: application/json' \
  --header 'apikey: YOUR_API_KEY'

How do I find out the country of a user in Javascript?

There are a few good APIs and articles on this. Below are some of google's top result. But feel free to DYOR (Do Your Own Research)

1. https://www.geoapify.com/how-to-get-user-location-with-javascript

Device Details

Some calls like "download Build URL" requires device details. This could be a unique identifier for the device. For Android devices, this could be “GSF Code”. This is used to obtain information like which users have what .apps installed on which device.