{"id":18981439,"url":"https://github.com/awncorp/api-name","last_synced_at":"2025-11-11T05:02:25.732Z","repository":{"id":77256351,"uuid":"300956704","full_name":"awncorp/api-name","owner":"awncorp","description":"Name.com API Client","archived":false,"fork":false,"pushed_at":"2020-10-03T20:32:57.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-01T11:27:37.569Z","etag":null,"topics":["api-client","perl","perl5"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awncorp.png","metadata":{"files":{"readme":"README","changelog":"CHANGES","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-03T19:03:57.000Z","updated_at":"2022-07-24T20:54:50.000Z","dependencies_parsed_at":"2023-05-25T06:30:40.081Z","dependency_job_id":null,"html_url":"https://github.com/awncorp/api-name","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awncorp%2Fapi-name","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awncorp%2Fapi-name/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awncorp%2Fapi-name/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awncorp%2Fapi-name/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awncorp","download_url":"https://codeload.github.com/awncorp/api-name/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239985778,"owners_count":19729525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-client","perl","perl5"],"created_at":"2024-11-08T16:09:50.714Z","updated_at":"2025-11-11T05:02:20.690Z","avatar_url":"https://github.com/awncorp.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"NAME\n\n    API::Name - Name.com API Client\n\nVERSION\n\n    version 0.06\n\nSYNOPSIS\n\n        use API::Name;\n    \n        my $name = API::Name-\u003enew(\n            user       =\u003e 'USER',\n            token      =\u003e 'TOKEN',\n            identifier =\u003e 'APPLICATION NAME',\n        );\n    \n        $name-\u003edebug(1);\n        $name-\u003efatal(1);\n    \n        my $domain = $name-\u003edomains(get =\u003e 'example.com');\n        my $results = $domain-\u003efetch;\n    \n        # after some introspection\n    \n        $domain-\u003eupdate( ... );\n\nDESCRIPTION\n\n    This distribution provides an object-oriented thin-client library for\n    interacting with the Name (https://www.name.com) API. For usage and\n    documentation information visit\n    https://www.name.com/reseller/API-documentation. API::Name is derived\n    from API::Client and inherits all of it's functionality. Please read\n    the documentation for API::Client for more usage information.\n\nATTRIBUTES\n\n token\n\n        $name-\u003etoken;\n        $name-\u003etoken('TOKEN');\n\n    The token attribute should be set to the API token assigned to the\n    account holder.\n\n user\n\n        $name-\u003euser;\n        $name-\u003euser('USER');\n\n    The user attribute should be set to the API user assgined to the\n    account holder.\n\n identifier\n\n        $name-\u003eidentifier;\n        $name-\u003eidentifier('IDENTIFIER');\n\n    The identifier attribute should be set to a string that identifies your\n    application.\n\n debug\n\n        $name-\u003edebug;\n        $name-\u003edebug(1);\n\n    The debug attribute if true prints HTTP requests and responses to\n    standard out.\n\n fatal\n\n        $name-\u003efatal;\n        $name-\u003efatal(1);\n\n    The fatal attribute if true promotes 4xx and 5xx server response codes\n    to exceptions, a API::Client::Exception object.\n\n retries\n\n        $name-\u003eretries;\n        $name-\u003eretries(10);\n\n    The retries attribute determines how many times an HTTP request should\n    be retried if a 4xx or 5xx response is received. This attribute\n    defaults to 0.\n\n timeout\n\n        $name-\u003etimeout;\n        $name-\u003etimeout(5);\n\n    The timeout attribute determines how long an HTTP connection should be\n    kept alive. This attribute defaults to 10.\n\n url\n\n        $name-\u003eurl;\n        $name-\u003eurl(Mojo::URL-\u003enew('https://www.name.com'));\n\n    The url attribute set the base/pre-configured URL object that will be\n    used in all HTTP requests. This attribute expects a Mojo::URL object.\n\n user_agent\n\n        $name-\u003euser_agent;\n        $name-\u003euser_agent(Mojo::UserAgent-\u003enew);\n\n    The user_agent attribute set the pre-configured UserAgent object that\n    will be used in all HTTP requests. This attribute expects a\n    Mojo::UserAgent object.\n\nMETHODS\n\n action\n\n        my $result = $name-\u003eaction($verb, %args);\n    \n        # e.g.\n    \n        $name-\u003eaction('head', %args);    # HEAD request\n        $name-\u003eaction('options', %args); # OPTIONS request\n        $name-\u003eaction('patch', %args);   # PATCH request\n\n    The action method issues a request to the API resource represented by\n    the object. The first parameter will be used as the HTTP request\n    method. The arguments, expected to be a list of key/value pairs, will\n    be included in the request if the key is either data or query.\n\n create\n\n        my $results = $name-\u003ecreate(%args);\n    \n        # or\n    \n        $name-\u003ePOST(%args);\n\n    The create method issues a POST request to the API resource represented\n    by the object. The arguments, expected to be a list of key/value pairs,\n    will be included in the request if the key is either data or query.\n\n delete\n\n        my $results = $name-\u003edelete(%args);\n    \n        # or\n    \n        $name-\u003eDELETE(%args);\n\n    The delete method issues a DELETE request to the API resource\n    represented by the object. The arguments, expected to be a list of\n    key/value pairs, will be included in the request if the key is either\n    data or query.\n\n fetch\n\n        my $results = $name-\u003efetch(%args);\n    \n        # or\n    \n        $name-\u003eGET(%args);\n\n    The fetch method issues a GET request to the API resource represented\n    by the object. The arguments, expected to be a list of key/value pairs,\n    will be included in the request if the key is either data or query.\n\n update\n\n        my $results = $name-\u003eupdate(%args);\n    \n        # or\n    \n        $name-\u003ePUT(%args);\n\n    The update method issues a PUT request to the API resource represented\n    by the object. The arguments, expected to be a list of key/value pairs,\n    will be included in the request if the key is either data or query.\n\nRESOURCES\n\n account\n\n        $name-\u003eaccount;\n\n    The account method returns a new instance representative of the API\n    account resource requested. This method accepts a list of path segments\n    which will be used in the HTTP request. The following documentation can\n    be used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n dns\n\n        $name-\u003edns;\n\n    The dns method returns a new instance representative of the API dns\n    resource requested. This method accepts a list of path segments which\n    will be used in the HTTP request. The following documentation can be\n    used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n domain\n\n        $name-\u003edomain;\n\n    The domain method returns a new instance representative of the API\n    domain resource requested. This method accepts a list of path segments\n    which will be used in the HTTP request. The following documentation can\n    be used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n host\n\n        $name-\u003ehost;\n\n    The host method returns a new instance representative of the API host\n    resource requested. This method accepts a list of path segments which\n    will be used in the HTTP request. The following documentation can be\n    used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n login\n\n        $name-\u003elogin;\n\n    The login method returns a new instance representative of the API login\n    resource requested. This method accepts a list of path segments which\n    will be used in the HTTP request. The following documentation can be\n    used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n logout\n\n        $name-\u003elogout;\n\n    The logout method returns a new instance representative of the API\n    logout resource requested. This method accepts a list of path segments\n    which will be used in the HTTP request. The following documentation can\n    be used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\n order\n\n        $name-\u003eorder;\n\n    The order method returns a new instance representative of the API order\n    resource requested. This method accepts a list of path segments which\n    will be used in the HTTP request. The following documentation can be\n    used to find more information.\n    https://www.name.com/reseller/API-documentation.\n\nAUTHOR\n\n    Al Newkirk \u003canewkirk@ana.io\u003e\n\nCOPYRIGHT AND LICENSE\n\n    This software is copyright (c) 2014 by Al Newkirk.\n\n    This is free software; you can redistribute it and/or modify it under\n    the same terms as the Perl 5 programming language system itself.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawncorp%2Fapi-name","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawncorp%2Fapi-name","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawncorp%2Fapi-name/lists"}