Metadata Connector

Documentation

Base Url

http://lzrmid-metadata.lazarustechservices.com

Requirements for Endpoint Consumption

All endpoints must include the header Authorization: Token ${Token value}

Retrieve File Metadata:

Method: POST
URL: /v1/get-metadata
Note:The formdata field must be called:
```
fileMetadata
```
Description: Returns an object containing the metadata of the received file.
Response: JSON
Allowed File Types:

        
"image/jpeg",
"image/png",
"image/gif",
"image/webp",
"image/tiff",
"image/bmp",
"image/svg+xml",
"image/vnd.microsoft.icon",
"image/heif",
"image/heic",
"image/avif",
"application/pdf",
"application/msword",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.ms-excel",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"application/vnd.ms-powerpoint",
"application/vnd.openxmlformats-officedocument.presentationml.presentation",
"text/csv",

Example Response:

{

    "errors": [],
    "GPSLatitude": 40.4066,
    "GPSLongitude": -3.650183,
    "GPSLatitudeRef": "N",
    "GPSLongitudeRef": "W",
    "tz": "UTC+1",
    "tzSource": "OffsetTimeOriginal",
    "GPSAltitude": 664.1940615,
    "GPSPosition": "40.4066 -3.65018333333333",
    "Orientation": 6,
    "FileName": "IMG_7931.jpeg",
    uploads",
    "FileSize": "2.1 MB",
    "FileModifyDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 13,
        "hour": 9,
        "minute": 25,
        "second": 42,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:13 09:25:42+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "FileAccessDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 13,
        "hour": 9,
        "minute": 25,
        "second": 42,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:13 09:25:42+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "FileInodeChangeDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 13,
        "hour": 9,
        "minute": 25,
        "second": 42,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:13 09:25:42+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "FilePermissions": "-rw-r--r--",
    "FileType": "JPEG",
    "FileTypeExtension": "jpg",
    "MIMEType": "image/jpeg",
    "JFIFVersion": 1.01,
    "ExifByteOrder": "Big-endian (Motorola, MM)",
    "Make": "Apple",
    "Model": "iPhone 13 Pro Max",
    "XResolution": 72,
    "YResolution": 72,
    "ResolutionUnit": "inches",
    "Software": "18.3.1",
    "ModifyDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56",
        "zoneName": "UTC+1",
        "inferredZone": true
    },
    "HostComputer": "iPhone 13 Pro Max",
    "YCbCrPositioning": "Centered",
    "ExposureTime": "1/20",
    "FNumber": 2.8,
    "ExposureProgram": "Program AE",
    "ISO": 2500,
    "ExifVersion": "0232",
    "DateTimeOriginal": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56",
        "zoneName": "UTC+1",
        "inferredZone": true
    },
    "CreateDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56",
        "zoneName": "UTC+1",
        "inferredZone": true
    },
    "OffsetTime": "+01:00",
    "OffsetTimeOriginal": "+01:00",
    "OffsetTimeDigitized": "+01:00",
    "ComponentsConfiguration": "Y, Cb, Cr, -",
    "ShutterSpeedValue": "1/20",
    "ApertureValue": 2.8,
    "BrightnessValue": -3.205531329,
    "ExposureCompensation": 0,
    "MeteringMode": "Multi-segment",
    "Flash": "Off, Did not fire",
    "FocalLength": "9.0 mm",
    "SubjectArea": "829 1741 456 453",
    "MakerNoteVersion": 15,
    "RunTimeFlags": "Valid",
    "RunTimeValue": "1005244389988541",
    "RunTimeScale": 1000000000,
    "RunTimeEpoch": 0,
    "AEStable": "Yes",
    "AETarget": 112,
    "AEAverage": 104,
    "AFStable": "Yes",
    "AccelerationVector": "0.01180943939 -0.9847047323 -0.1246409045",
    "FocusDistanceRange": "0.36 - 0.76 m",
    "ImageCaptureType": "Scene",
    "LivePhotoVideoIndex": 3259506688,
    "PhotosAppFeatureFlags": 0,
    "HDRHeadroom": 0.5,
    "AFPerformance": "341 1 29",
    "SignalToNoiseRatio": 10.43932437,
    "PhotoIdentifier": "E841E5E4-9576-4B16-BE84-88B42085D7A9",
    "ColorTemperature": 5054,
    "CameraType": "Back Normal",
    "FocusPosition": 104,
    "HDRGain": 0.006972941098,
    "AFMeasuredDepth": 241,
    "AFConfidence": 29,
    "SemanticStyle": {
        "_0": 1,
        "_1": 0,
        "_2": 0,
        "_3": 0
    },
    "SubSecTimeOriginal": 391,
    "SubSecTimeDigitized": 391,
    "FlashpixVersion": "0100",
    "ColorSpace": "Uncalibrated",
    "ExifImageWidth": 4032,
    "ExifImageHeight": 3024,
    "SensingMethod": "One-chip color area",
    "SceneType": "Directly photographed",
    "ExposureMode": "Auto",
    "WhiteBalance": "Auto",
    "FocalLengthIn35mmFormat": "77 mm",
    "SceneCaptureType": "Standard",
    "LensInfo": "1.570000052-9mm f/1.5-2.8",
    "LensMake": "Apple",
    "LensModel": "iPhone 13 Pro Max back triple camera 9mm f/2.8",
    "CompositeImage": "General Composite Image",
    "GPSAltitudeRef": "Above Sea Level",
    "GPSTimeStamp": {
        "_ctor": "ExifTime",
        "hour": 20,
        "minute": 1,
        "second": 51,
        "rawValue": "20:01:51",
        "zone": "UTC",
        "inferredZone": true
    },
    "GPSSpeedRef": "km/h",
    "GPSSpeed": 0,
    "GPSImgDirectionRef": "True North",
    "GPSImgDirection": 251.62294,
    "GPSDestBearingRef": "True North",
    "GPSDestBearing": 251.62294,
    "GPSDateStamp": {
        "_ctor": "ExifDate",
        "year": 2025,
        "month": 3,
        "day": 9,
        "rawValue": "2025:03:09"
    },
    "GPSHPositioningError": "19.03484122 m",
    "Compression": "JPEG (old-style)",
    "ThumbnailOffset": 3140,
    "ThumbnailLength": 8522,
    "XMPToolkit": "XMP Core 6.0.0",
    "CreatorTool": "18.3.1",
    "DateCreated": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56",
        "zoneName": "UTC+1",
        "inferredZone": true
    },
    "RegionInfo": {
        "AppliedToDimensions": {
            "H": 3024,
            "Unit": "pixel",
            "W": 4032
        },
        "RegionList": [
            {
                "Area": {
                    "H": "0.15200000000000002",
                    "Unit": "normalized",
                    "W": "0.11523809523809522",
                    "X": "0.20561904761904759",
                    "Y": "0.56800000000000006"
                },
                "Extensions": {
                    "XMP-apple-fi:AngleInfoRoll": 268,
                    "XMP-apple-fi:AngleInfoYaw": 331,
                    "XMP-apple-fi:ConfidenceLevel": 467,
                    "XMP-apple-fi:FaceID": 9
                },
                "Type": "Face"
            }
        ]
    },
    "MPFVersion": "0100",
    "NumberOfImages": 2,
    "MPImageFlags": "(none)",
    "MPImageFormat": "JPEG",
    "MPImageType": "Undefined",
    "MPImageLength": 299937,
    "MPImageStart": 1806437,
    "DependentImage1EntryNumber": 0,
    "DependentImage2EntryNumber": 0,
    "ProfileCMMType": "Apple Computer Inc.",
    "ProfileVersion": "4.0.0",
    "ProfileClass": "Display Device Profile",
    "ColorSpaceData": "RGB ",
    "ProfileConnectionSpace": "XYZ ",
    "ProfileDateTime": {
        "_ctor": "ExifDateTime",
        "year": 2022,
        "month": 1,
        "day": 1,
        "hour": 0,
        "minute": 0,
        "second": 0,
        "tzoffsetMinutes": 60,
        "rawValue": "2022:01:01 00:00:00",
        "zoneName": "UTC+1",
        "inferredZone": true
    },
    "ProfileFileSignature": "acsp",
    "PrimaryPlatform": "Apple Computer Inc.",
    "CMMFlags": "Not Embedded, Independent",
    "DeviceManufacturer": "Apple Computer Inc.",
    "DeviceModel": "",
    "DeviceAttributes": "Reflective, Glossy, Positive, Color",
    "RenderingIntent": "Perceptual",
    "ConnectionSpaceIlluminant": "0.9642 1 0.82491",
    "ProfileCreator": "Apple Computer Inc.",
    "ProfileID": "ecfda38e388547c36db4bd4f7ada182f",
    "ProfileDescription": "Display P3",
    "ProfileCopyright": "Copyright Apple Inc., 2022",
    "MediaWhitePoint": "0.96419 1 0.82489",
    "RedMatrixColumn": "0.51512 0.2412 -0.00105",
    "GreenMatrixColumn": "0.29198 0.69225 0.04189",
    "BlueMatrixColumn": "0.1571 0.06657 0.78407",
    "RedTRC": {
        "_ctor": "BinaryField",
        "bytes": 32,
        "rawValue": "(Binary data 32 bytes, use -b option to extract)"
    },
    "ChromaticAdaptation": "1.04788 0.02292 -0.0502 0.02959 0.99048 -0.01706 -0.00923 0.01508 0.75168",
    "BlueTRC": {
        "_ctor": "BinaryField",
        "bytes": 32,
        "rawValue": "(Binary data 32 bytes, use -b option to extract)"
    },
    "GreenTRC": {
        "_ctor": "BinaryField",
        "bytes": 32,
        "rawValue": "(Binary data 32 bytes, use -b option to extract)"
    },
    "HDRGainCurve": {
        "_ctor": "BinaryField",
        "bytes": 1385,
        "rawValue": "(Binary data 1385 bytes, use -b option to extract)"
    },
    "ImageWidth": 4032,
    "ImageHeight": 3024,
    "EncodingProcess": "Baseline DCT, Huffman coding",
    "BitsPerSample": 8,
    "ColorComponents": 3,
    "YCbCrSubSampling": "YCbCr4:2:0 (2 2)",
    "RunTimeSincePowerUp": "11 days 15:14:04",
    "Aperture": 2.8,
    "ImageSize": "4032x3024",
    "Megapixels": 12.2,
    "ScaleFactor35efl": 8.6,
    "ShutterSpeed": "1/20",
    "SubSecCreateDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "millisecond": 391,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56.391+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "SubSecDateTimeOriginal": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "millisecond": 391,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56.391+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "SubSecModifyDate": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 21,
        "minute": 1,
        "second": 56,
        "tzoffsetMinutes": 60,
        "rawValue": "2025:03:09 21:01:56+01:00",
        "zoneName": "UTC+1",
        "inferredZone": false
    },
    "ThumbnailImage": {
        "_ctor": "BinaryField",
        "bytes": 8522,
        "rawValue": "(Binary data 8522 bytes, use -b option to extract)"
    },
    "GPSDateTime": {
        "_ctor": "ExifDateTime",
        "year": 2025,
        "month": 3,
        "day": 9,
        "hour": 20,
        "minute": 1,
        "second": 51,
        "tzoffsetMinutes": 0,
        "rawValue": "2025:03:09 20:01:51Z",
        "zoneName": "UTC",
        "inferredZone": false
    },
    "MPImage2": {
        "_ctor": "BinaryField",
        "bytes": 299937,
        "rawValue": "(Binary data 299937 bytes, use -b option to extract)"
    },
    "CircleOfConfusion": "0.004 mm",
    "FOV": "26.3 deg",
    "FocalLength35efl": "9.0 mm (35 mm equivalent: 77.0 mm)",
    "HyperfocalDistance": "8.24 m",
    "LightValue": 2.6,
    "LensID": "iPhone 13 Pro Max back triple camera 9mm f/2.8",
    "warnings": []
}

Retrieve File Without Metadata by File Name:

Method: GET
URL: /v1/get-file-without-metadata/{filename}
Note:The parameter name must be the same as the one received in the get-metadata endpoint.
Description: Returns a blob if the response is successful or a JSON object with an error if an issue occurs.
Parameters:

filename: The FileName field from the "get-metadata" request. This name is the original name prefixed by a hash (created with a UUID).

Response:

Error: 400
Error Messages:

Not file in request
Error get Data from request: error.message
Error read metadata: error.message

Format: JSON or Blob