Reseller API

.Kred provides an API for Reseller Partners to provision and query the status of domains.

Technical Note: Reseller Partners will have provided an IANA ID and a default Ethereum Mainnet wallet address prior to receiving access to this API - These can be assumed to be defined.

Authenticatication:
Resellers will be issued an authentication key, on registration, which can be managed through the reseller console. This key must be provided with all calls to the API, either as a 'token' request paramater, or as a HTTP Basic Auth Header

/avail
GET

Returns information about the availability of a .Kred domain

QUERY PARAMS
domain
string
The domain name to query

RESPONSE
string
JSON encoded data about domain availability

{artee.kred: {
    available: false,
    text: "in use"
}}

/expiry
GET

Returns time of domain expiry

QUERY PARAMS
domain
string
The domain name to query

RESPONSE
string
JSON encoded data about expiry time of queried domain

{artee.kred: {
    expires: "2021-02-27T23:59:59.0Z",
}}

/list
GET

Returns a list of all domains registered by the Reseller Partner

QUERY PARAMS
page
integer
OPTIONAL
Page to return.
DEFAULT: 1

count
integer
OPTIONAL
Number of results per page
DEFAULT: 100

RESPONSE
string
JSON encoded list of results

[ {
    status: "active",
    updated: null,
    created: 1581668788,
    name: "00000.kred"
},
{
   status: "active",
    updated: null,
    created: 1581919261,
    name: "000000.kred"
},
{
    status: "active",
    updated: null,
    created: 1581919262,
    name: "000001.kred"
},
{
    status: "active",
    updated: null,
    created: 1581919264,
    name: "00001.kred"
},
{
    status: "active",
    updated: null,
    created: 1581919266,
    name: "00002.kred"
},
{
    status: "active",
    updated: null,
    created: 1581919267,
    name: "00005.kred"
    }
]

/price
GET

Returns wholesale price of a .Kred domain

QUERY PARAMS
domain
string
The domain name to query

RESPONSE
string
JSON encoded data about domain price

{artee.kred: {
    price: 20.00
}}

/purchase
POST

Desc

QUERY PARAMS
domain
string
Domain name to register

firstname
string
Recipient first name

lastname
string
Recipient last name

email
string
Recipient email address

phone
string
OPTIONAL
Recipient phone number

company
string
OPTIONAL
Recipient company name

wallet
string
OPTIONAL
Ethereum wallet address for token to be minted into
DEFAULT: The Reseller Partner's designated custodial wallet address

address
string
OPTIONAL
IP address for domain to resolve to initially

numyears
integer
OPTIONAL
Number of years to register the domain for
DEFAULT: 1

RESPONSE
string
JSON encoded data confirming transaction

{artee.kred: {
    transaction: "CNIC-D0088C16DBBDD7D5A481686530EE3E7E4C75CDE79E466D0024C2793EB08",
    expires: "2021-02-27T23:59:59.0Z",
    created: "2020-02-27T06:48:55.0Z"
}}

/renew
POST

Renews a registered domain for a number of years

QUERY PARAMS
domain
string
Domain name to renew

numyears
integer
Number of years to extend the domain's registration by
DEFAULT: 1

RESPONSE
string
JSON encoded data about the revised expiry time of the domain

{artee.kred: {
    expires: "2022-02-27T23:59:59.0Z",
}}

`