INTEGRA API

 

API Access

The Integra Ledger utilizes Hyperledger Fabric and Hyperledger Composer with its blockchain infrastructure. Smart Contracts execution and data access is performed  through a RESTful API. Global Legal Blockchain Consortium members run their own nodes and their identities are established through the Integra Ledger certificate authority. Integra Inc. runs a publicly accessible API Gateway allowing non consumerism participants to interact with the Ledger.

API Headers

All calls to the ledger must include the following header with the token is obtained from Integra Inc by visiting https://integraledger.portal.azure-api.net/ and creating an account. You must then request access to the API by clicking on the Signup button on the Home Page. You can obtain your Ocp-Apim-Subscription-Key by going to you profile (Use the drop down under you name) and copying the Primary Key to use as your subscription Key. The account must be activated by an Integra Admin first. This will generally take less than 24 hours.

Ocp-Apim-Subscription-Key :xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST Methods should also include

Content_Type : application/json

Accept : application/json

API

The first foundational service of the Integra Ledger provides the issuance of a unique legal identifier. String data can also be bound to the ID with current support for a value field and a metadata field. The API also provides methods to confirm the existence of the id and the existence of the value.

One common use case is for a user to create a SHA 256 Hash of a PDF document and register the hash on the Integra Ledger. The call returns a GUID as an identifier which the client can then store as a foreign key. NetDocuments executed this design in one of the early Integra proof of concepts.

The current API provides 5 end points

  • registerIdentity
  • identityExists
  • valueExists
  • registerKey
  • keyForOwner