{"id":17196739,"url":"https://github.com/weppos/domainr-go","last_synced_at":"2025-03-25T08:15:39.987Z","repository":{"id":64306269,"uuid":"50851053","full_name":"weppos/domainr-go","owner":"weppos","description":"A Go client for the Domainr API.","archived":false,"fork":false,"pushed_at":"2016-09-03T18:27:40.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-30T07:30:14.346Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/weppos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-01T16:03:56.000Z","updated_at":"2023-09-08T17:06:34.000Z","dependencies_parsed_at":"2023-01-15T10:45:38.129Z","dependency_job_id":null,"html_url":"https://github.com/weppos/domainr-go","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weppos%2Fdomainr-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weppos%2Fdomainr-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weppos%2Fdomainr-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weppos%2Fdomainr-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weppos","download_url":"https://codeload.github.com/weppos/domainr-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245423253,"owners_count":20612749,"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":[],"created_at":"2024-10-15T01:54:26.224Z","updated_at":"2025-03-25T08:15:39.955Z","avatar_url":"https://github.com/weppos.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Domainr API client\n\nA Go client for the [Domainr API](http://domainr.build/).\n\n[![Build Status](https://travis-ci.org/weppos/domainr-go.svg?branch=master)](https://travis-ci.org/weppos/domainr-go)\n[![GoDoc](https://godoc.org/github.com/weppos/domainr-go/domainr?status.svg)](https://godoc.org/github.com/weppos/domainr-go/domainr)\n\n\n## Getting started\n\n```shell\n$ git clone git@github.com:weppos/domainr-go.git\n$ cd domainr-go\n```\n\nRun the test suite.\n\n\n## Testing\n\n```shell\n$ go test ./...\n```\n\n### Live Testing\n\n```shell\n$ export DOMAINR_CLIENT_ID=\"some-magic-client-id\"\n$ go test ./... -v\n```\n\n**Example output**\n\n```shell\n$ go test ./... -v\n=== RUN   TestNewClient\n--- PASS: TestNewClient (0.00s)\n=== RUN   TestLivePrivateGetStatus\n\u003cnil\u003e\n\u0026{[{domainr.com com active active}] 0xc820332b40}\n--- PASS: TestLivePrivateGetStatus (1.13s)\n=== RUN   TestLiveGetStatus\n\u003cnil\u003e\n\u0026{domainr.com com active active}\n--- PASS: TestLiveGetStatus (0.24s)\nPASS\nok  \tgithub.com/weppos/domainr-go/domainr\t1.385s\n```\n\n**Custom domain list**\n\n```shell\n$ DOMAINR_STATUS_DOMAINS=dnsimple.com,domainr.com go test ./... -v\n=== RUN   TestNewClient\n--- PASS: TestNewClient (0.00s)\n=== RUN   TestLivePrivateGetStatus\n\u003cnil\u003e\n\u0026{[{dnsimple.com com active registrar registrar} {domainr.com com active active}] 0xc82041a090}\n--- PASS: TestLivePrivateGetStatus (0.50s)\n=== RUN   TestLiveGetStatus\n\u003cnil\u003e\n\u0026{dnsimple.com com active registrar registrar}\n--- PASS: TestLiveGetStatus (0.26s)\nPASS\nok  \tgithub.com/weppos/domainr-go/domainr\t0.772s\n```\n\n## Installation\n\n```shell\n$ go get github.com/weppos/domainr-go/domainr\n```\n\n## Usage\n\n```go\npackage main\n\nimport (\n    \"fmt\"\n    \"os\"\n\n    \"github.com/weppos/domainr-go/domainr\"\n)\n\nfunc main() {\n  clientID := \"some-magic-client-id\"\n\n  client := domainr.NewClient(NewDomainrAuthentication(clientID))\n\n  // Get the status of some domains\n  domainResponse, err := client.Status([]string{\"example.com\", \"example.org\"})\n  if err != nil {\n      fmt.Println(err)\n      os.Exit(1)\n  }\n\n  domain := domainResponse.Domains[0]\n  fmt.Printf(\"%s: %s\", domain.Name, domain.Summary)\n}\n```\n\n### Authentication\n\nThis library supports both Mashape and Commercial authentication.\n\n```go\n// commercial authentication\nclient := domainr.NewClient(NewDomainrAuthentication(\"client-id\"))\n\n// mashape authentication\nclient := domainr.NewClient(NewMashapeAuthentication(\"mashape-api-key\"))\n```\n\nThe API endpoint is automatically adapted according to the type of authentication selected.\n\n\n## License\n\nCopyright (c) 2016 Simone Carletti. This is Free Software distributed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweppos%2Fdomainr-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweppos%2Fdomainr-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweppos%2Fdomainr-go/lists"}