POST /v0/entry/create
POST
Requests the creation of a new ANS entry. ANS entries need to be paid and renewed via subscription payments. Upon requesting the creation of the ANS entry, a subscription request is created. The user may accept the subscription request via their wallet by offering the initial payment. Once the subscription request is accepted, the DSO automation burns the payment and creates the ANS entry.
OpenAPI
Authorizations
userAuth
Authorization
string
required
HTTP bearer authentication. Send the token as
Authorization: Bearer <token>. Bearer format: JWT. JWT token as described by the spliceAppBearerAuth security scheme. The subject of the token must be ledger API user of the user affected by the endpoint.Body
application/json
name
string
required
The name of the ANS entry. It must end with
.unverified.<ans> where <ans> is the ANS acronym chosen by the DSO.url
string
required
A valid URL or an empty string. Use this to link to a website, such as the homepage of an application provided by the owner of this entry. Must not be longer than 255 characters.
description
string
required
A human readable description of the ANS entry. May be empty. Must not be longer than 140 characters.
Responses
200
okapplication/json
entryContextCid
ContractId
required
subscriptionRequestCid
ContractId
required
name
string
required
The name of the ANS entry, as specified in the request.
url
string
required
The URL of the ANS entry, as specified in the request.
description
string
required
The description of the ANS entry, as specified in the request.
400
Invalid request, check the error response for details.application/json
error
string
required
500
internal server errorapplication/json
error
string
required