Metadata V3 Get

The Metadata Metadata provides information about a piece of data. It is used to summarize basic information about data, which can make working with the data easier. In the context of Keyfactor Command, the certificate metadata feature allows you to create custom metadata fields that allow you to tag certificates with tracking information about certificates. V3 Get POST method is used to get metadata value on a certificate in Keyfactor Command. Despite the "Get" in the Keyfactor Command method name, the HTTP method must be POST and not GET. As with metadata/3/set (see Metadata V3 Set), the POST request body must consist of a JSON string containing the parameters used to get a certificate’s metadata. The "value" attribute for each metadata entry is not used, but must be present and can be set to null or an empty string. The method returns a JSON dictionary in a format identical to the metadata parameter A parameter or argument is a value that is passed into a function in an application., with key-value pairs containing the fields and values requested.

Example Request

POST http://<host>/CMSApi/Metadata/3/Get HTTP/1.1

{
	"Lookup": 
	{
		"Type": "Serial", 
		"SerialNumber": "<serial-number>", 
		"IssuerDN": "<issuer-dn>"
	},
	"Security": {"Flags": 3},
	"Metadata ": {"Email-Contact": ""}
}

Example Response

{
	"Email-Contact": "bob.smith@example.com"
}