NAME
Circle::Common - the common module for Circle::Chain SDK
VERSION
Version 0.05
SYNOPSIS
use Circle::Common;
my $url = build_url_template('user', 'getBlockHashList', {
baseHeight => 0,
});
my $response = http_json_get($url);
if ($response->{status} == 200) {
my $data = $response->{data};
# process data here.
}
my $logout_url = build_url_template('user', 'logout', {});
$response = http_json_post($logout_url);
if ($response->{status} == 200) {
my $data = $response->{data};
# check the logout success here.
}
DESCRIPTION
The Circle::Common is common module which provides common functions: http restful api get, http restful api post and build url template etc.
METHODS
build_url_template
my $url = build_url_template('user', 'getBlockHashList', {
baseHeight => 10,
});
Builds user's getBlockHashList url.
my $url = build_url_template($buz, $path, $params_for);
$buz stands for: 'user', 'block', 'wallet' business modules.
$path stands for the key of the variant urls.
$params_for stands for the request query map.
load_config
my $config = load_config();
# process the config data here.
get_session_key
my $session_key = get_session_key();
# process the session key here.
In fact, you needn't set session key when you post apis. In SDK we set the session key in the post/get headers after you logged successfully.
http_json_get
my $response = http_json_get($url);
Invokes the http json get request to circle chain server. the response data contains three fields: status, message and data:
my $response = http_json_get($url);
if ($response->{status} == 200) {
my $data = $response->{data};
# process you data here.
}
http_json_post
my $response = http_json_post($url, $body);
Invokes the http json post request to circle chain server. the response data contains three fields: status, message and data:
my $body = {
...
};
my $response = http_json_post($url, $body);
if ($response->{status} == 200) {
my $data = $response->{data};
# process your data here.
}
SEE ALSO
See Circle::User for circle user module.
See Circle::Wallet for circle wallet module.
See Circle::Block for circle block module.
COPYRIGHT AND LICENSE
Copyright 2024-2030 Charles li
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.