perl: make use of hashes for the API functions

[smokhov]

Similarly to the FP API, should convert to the use of name=>value hashes as the API parameters to avoid long parameter lists and being selective on the fields needed to set.

[smokhov]

FYI, @qtdnguyen - this is one of the refactorings I need to do to make it more flexible