The Version Service offers functionality around versioning, tracking and searching of many different types ("methods") of Decentralized Identifiers (DIDs).
This includes looking up historical versions of DIDs and DID documents, search for DIDs based on the DID (the identifier itself) or DID document contents, as well as various tracking, auditing and analytics functions.
See https://api.godiddy.com/#tag/Version-Service
Historical look up can be used both within a given a DID method, or for a specific DID.
This request lists the 5
latest DIDs within the indy
DID method:
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?method=indy&limit=5" \
-H "Accept: application/json"
This request resolves the DID did:indy:sovrin:DjxRxnL4gXsncbH8jM8ySM
at the millisecond timestamp 1544916028000
, which corresponds to time 2018-12-10T02:22:49Z
:
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:sovrin:DjxRxnL4gXsncbH8jM8ySM&versionTime=1544916028000&limit=1" \
-H "Accept: application/json"
Removing limit=1
from the query resolves all the versions of the DID did:indy:sovrin:DjxRxnL4gXsncbH8jM8ySM
up through 2018-12-10T02:22:49Z
:
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:sovrin:DjxRxnL4gXsncbH8jM8ySM&versionTime=1544916028000" \
-H "Accept: application/json"
Searching is possible both by the DID (the identifier itself) and by DID document contents.
This request searches for a DID containing the string WRfXPg8dantKVubE3HX8pw
:
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords/findInIdentifier?term=WRfXPg8dantKVubE3HX8pw" \
-H "Accept: application/json"
This request searches for DIDs containing a verification method of type Ed25519VerificationKey2018
:
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/diddocuments/search?path=verificationMethod&path=type&value=Ed25519VerificationKey2018" \
-H "Accept: application/json"