Appearance
Version Service
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.
API
See https://api.godiddy.com/#tag/Version-Service.
Historical lookup
Historical lookup can be used both within a given DID method, or for a specific DID.
List latest DIDs in a DID method
This request lists the 5
latest DIDs within the indy
DID method:
bash
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"
1
2
3
2
3
Look up a DID at a specific point in time
This request resolves the DID did:indy:idunion:test:BDrEcHc8Tb4Lb2VyQZWEDE
at the millisecond timestamp 1602854361000
, which corresponds to time 2020-10-16T13:19:21.000Z
:
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:idunion:test:BDrEcHc8Tb4Lb2VyQZWEDE&versionTime=1602854361000&limit=1" \
-H "Accept: application/json"
1
2
3
2
3
Removing limit=1
from the query resolves all the versions of the DID did:indy:idunion:test:BDrEcHc8Tb4Lb2VyQZWEDE
up through 2020-10-16T13:19:21.000Z
:
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
-X GET "https://api.godiddy.com/1.0.0/version-service/didrecords?did=did:indy:idunion:test:BDrEcHc8Tb4Lb2VyQZWEDE&versionTime=1602854361000" \
-H "Accept: application/json"
1
2
3
2
3
Search for DIDs
Searching is possible both by the DID (the identifier itself) and by DID document contents.
Search by DID content
This request searches for a DID containing the string WRfXPg8dantKVubE3HX8pw
:
bash
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"
1
2
3
2
3
Search by DID document content
This request searches for DIDs containing a verification method of type Ed25519VerificationKey2018
:
bash
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"
1
2
3
2
3