{"cid_format":{"description":"CID is always returned with dashes (8 groups of 6 digits)","example":"018645-163141-810324-795896-145686-078691-374894-335310"},"documentation":{"/api/balance":{"description":"Check token balance","example":"/api/balance?token=YOUR_32_CHAR_TOKEN","method":"GET","parameters":{"token":"(required) 32-character API token"}},"/api/cid":{"description":"Retrieve CID for a given IID","example":"/api/cid?token=YOUR_32_CHAR_TOKEN&iid=4753196-2624015-1937492-5691303-3067702-9796702-2657503-3244460-4554242","method":"GET","parameters":{"iid":"(required) Installation ID","token":"(required) 32-character API token"}},"/api/cid/ocr":{"body":{"image":"(required) Base64-encoded image string","token":"(required) 32-character API token"},"content_type":"application/json","description":"Retrieve CID by extracting IID from a Base64-encoded image","example_body":{"image":"iVBORw0KGgoAAAANSUhEUgAA... (Base64 string)","token":"YOUR_32_CHAR_TOKEN"},"method":"POST","notes":["Accepts raw Base64 or data URL format (data:image/png;base64,...)","Supported formats: PNG, JPG, JPEG, GIF, BMP, WebP, TIFF"]},"/api/health":{"description":"Health check endpoint","method":"GET"}},"error_codes":{"IID_BLOCKED":"IID is blocked and cannot be activated","IID_NOT_FOUND":"No valid IID found in the image","INSUFFICIENT_BALANCE":"Not enough balance to process request","INVALID_BASE64":"Invalid Base64 image string (OCR endpoint)","INVALID_IID":"IID format is invalid","INVALID_TOKEN":"Token is invalid or expired","INVALID_TOKEN_FORMAT":"Token must be 32 alphanumeric characters","MISSING_IID":"IID parameter not provided","MISSING_IMAGE":"Image parameter not provided (OCR endpoint)","MISSING_TOKEN":"Token parameter not provided","OCR_FAILED":"Could not extract text from image"},"iid_formats":{"description":"Accepted Installation ID formats (9 groups of 6-7 digits)","examples":["4753196-2624015-1937492-5691303-3067702-9796702-2657503-3244460-4554242","475319626240151937492569130330677029796702265750332444604554242","4753196 2624015 1937492 5691303 3067702 9796702 2657503 3244460 4554242"]},"name":"Keys Locker Supply API","version":"1.1.0"}