{"openapi":"3.1.0","info":{"title":"Flotilo Data Act export interface","version":"1.2","description":"Read-only retrieval interface for an already prepared customer export. The access code is sent only in the Authorization header and never in the URL."},"servers":[{"url":"https:\/\/app.flotilo.cz"}],"paths":{"\/data-exports\/interface\/v1\/{company}\/{export}\/{grant}":{"get":{"summary":"Read metadata and download location for a prepared export","security":[{"bearerAuth":[]}],"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"export","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"grant","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Authorized export metadata","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ExportMetadata"}}}},"404":{"description":"Export or authorization is unavailable"},"429":{"description":"Rate limit exceeded"}}}},"\/data-exports\/interface\/v1\/{company}\/{export}\/{grant}\/download":{"get":{"summary":"Download the prepared ZIP export","security":[{"bearerAuth":[]}],"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"export","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"grant","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"ZIP export","headers":{"Digest":{"description":"SHA-256 digest of the response archive","schema":{"type":"string"}}},"content":{"application\/zip":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Export or authorization is unavailable"},"429":{"description":"Rate limit exceeded"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"32 hexadecimal characters","description":"Use the separately delivered access code. Hyphens in the displayed code are accepted."}},"schemas":{"ExportMetadata":{"type":"object","additionalProperties":false,"required":["format","format_version","grant_type","retrieval_expires_at","sha256","schema_url","openapi_url","download_url"],"properties":{"format":{"type":"string"},"format_version":{"type":"string"},"grant_type":{"type":"string","enum":["customer","destination_provider"]},"retrieval_expires_at":{"type":"string","format":"date-time"},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"schema_url":{"type":"string","format":"uri"},"openapi_url":{"type":"string","format":"uri"},"download_url":{"type":"string","format":"uri"}}}}},"externalDocs":{"description":"Public export schema","url":"https:\/\/flotilo.cz\/data-export-format\/schema.json"}}