{"id":13878945,"url":"https://github.com/dnsimple/dnsimple-ruby","last_synced_at":"2026-02-24T00:06:25.885Z","repository":{"id":971902,"uuid":"768077","full_name":"dnsimple/dnsimple-ruby","owner":"dnsimple","description":"The DNSimple API client for Ruby.","archived":false,"fork":false,"pushed_at":"2026-02-19T11:16:23.000Z","size":2023,"stargazers_count":188,"open_issues_count":2,"forks_count":51,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-02-20T08:08:25.696Z","etag":null,"topics":["api","api-client","dnsimple","dnsimple-api","dnsimple-policy-eng","dnsimple-policy-group-apiclient","dnsimple-policy-triage-application","ruby"],"latest_commit_sha":null,"homepage":"https://developer.dnsimple.com/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dnsimple.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2010-07-10T20:48:48.000Z","updated_at":"2026-02-19T08:43:40.000Z","dependencies_parsed_at":"2026-02-20T08:08:28.605Z","dependency_job_id":null,"html_url":"https://github.com/dnsimple/dnsimple-ruby","commit_stats":{"total_commits":1122,"total_committers":45,"mean_commits":"24.933333333333334","dds":0.6131907308377897,"last_synced_commit":"26e675be52059330a9afe5b9ad18cf02402b5c60"},"previous_names":["aetrion/dnsimple-ruby"],"tags_count":61,"template":false,"template_full_name":null,"purl":"pkg:github/dnsimple/dnsimple-ruby","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnsimple%2Fdnsimple-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnsimple%2Fdnsimple-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnsimple%2Fdnsimple-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnsimple%2Fdnsimple-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dnsimple","download_url":"https://codeload.github.com/dnsimple/dnsimple-ruby/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnsimple%2Fdnsimple-ruby/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29762008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T21:02:23.375Z","status":"ssl_error","status_checked_at":"2026-02-23T20:58:31.539Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","api-client","dnsimple","dnsimple-api","dnsimple-policy-eng","dnsimple-policy-group-apiclient","dnsimple-policy-triage-application","ruby"],"created_at":"2024-08-06T08:02:04.956Z","updated_at":"2026-02-24T00:06:25.877Z","avatar_url":"https://github.com/dnsimple.png","language":"Ruby","readme":"# DNSimple Ruby Client\n\nA Ruby client for the [DNSimple API v2](https://developer.dnsimple.com/v2/).\n\n[![Build Status](https://github.com/dnsimple/dnsimple-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/dnsimple/dnsimple-ruby/actions/workflows/ci.yml)\n[![Coverage Status](https://img.shields.io/coveralls/dnsimple/dnsimple-ruby.svg)](https://coveralls.io/r/dnsimple/dnsimple-ruby?branch=main)\n\n[DNSimple](https://dnsimple.com/) provides DNS hosting and domain registration that is simple and friendly.\nWe provide a full API and an easy-to-use web interface so you can get your domain registered and set up with a minimal amount of effort.\n\n## Requirements\n\n- Ruby: MRI \u003e 3.2+\n- An activated DNSimple account\n\n## Installation\n\nYou can install the gem manually:\n\n```shell\ngem install dnsimple\n```\n\nOr use Bundler and define it as a dependency in your Gemfile:\n\n```ruby\ngem 'dnsimple', '~\u003e 11.0'\n```\n\n## Usage\n\nBe sure to require the gem before trying any of the examples:\n\n```ruby\nrequire 'dnsimple'\n```\n\n### Authentication\n\n```ruby\nclient = Dnsimple::Client.new(access_token: \"a1b2c3\")\n\n# Fetch your details\nresponse = client.identity.whoami   # execute the call\nresponse.data                       # extract the relevant data from the response or\nclient.identity.whoami.data         # execute the call and get the data in one line\n\n# Define an account ID.\naccount_id = 1010\n\n# You can also fetch it from the whoami response\n# as long as you authenticate with an Account access token\nwhoami = client.identity.whoami.data\naccount_id = whoami.account.id\n```\n\n### Listing your domains\n\n```ruby\nputs client.domains.list_domains(account_id).data                      # =\u003e domains from the account 1234, first page\nputs client.domains.list_domains(account_id, query: { page: 3 }).data  # =\u003e domains from the account 1234, third page\nputs client.domains.all_domains(account_id).data                       # =\u003e all domains from the account 1234 (use carefully)\n```\n\n### Create a domain\n\n```ruby\nresponse = client.domains.create_domain(account_id, name: \"example.com\")\nputs response.data\n```\n\n### Get a domain\n\n```ruby\nresponse = client.domains.domain(account_id, \"example.com\")\nputs response.data\n```\n\n## Configuration\n\n### Sandbox Environment\n\nWe highly recommend testing against our [sandbox environment](https://developer.dnsimple.com/sandbox/) before using our production environment. This will allow you to avoid real purchases, live charges on your credit card, and reduce the chance of your running up against rate limits.\n\nThe client supports both the production and sandbox environment. To switch to sandbox pass the sandbox API host using the `base_url` option when you construct the client:\n\n```ruby\nclient = Dnsimple::Client.new(base_url: \"https://api.sandbox.dnsimple.com\", access_token: \"a1b2c3\")\n```\n\nYou will need to ensure that you are using an access token created in the sandbox environment. Production tokens will *not* work in the sandbox environment.\n\n### Setting a custom `User-Agent` header\n\nYou can customize the `User-Agent` header for the calls made to the DNSimple API:\n\n```ruby\nclient = Dnsimple::Client.new(user_agent: \"my-app/1.0\")\n```\n\nThe value you provide will be prepended to the default `User-Agent` the client uses. For example, if you use `my-app/1.0`, the final header value will be `my-app/1.0 dnsimple-ruby/0.14.0` (note that it will vary depending on the client version).\n\nWe recommend to customize the user agent. If you are building a library or integration on top of the official client, customizing the client will help us to understand what is this client used for, and allow to contribute back or get in touch.\n\n## Documentation\n\n- [dnsimple-ruby RDocs](https://www.rubydoc.info/gems/dnsimple/).\n- [DNSimple API documentation](https://developer.dnsimple.com).\n- [DNSimple API examples repository](https://github.com/dnsimple/dnsimple-api-examples).\n- [DNSimple support documentation](https://support.dnsimple.com).\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for details.\n\n## License\n\nCopyright (c) 2010-2026 DNSimple Corporation. This is Free Software distributed under the [MIT License](LICENSE.txt).\n","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnsimple%2Fdnsimple-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdnsimple%2Fdnsimple-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnsimple%2Fdnsimple-ruby/lists"}