{"id":30493818,"url":"https://github.com/peteryangs/request","last_synced_at":"2025-08-24T22:25:46.226Z","repository":{"id":57631543,"uuid":"410225494","full_name":"PeterYangs/request","owner":"PeterYangs","description":"http客户端，http client","archived":false,"fork":false,"pushed_at":"2022-10-14T06:44:20.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T13:34:04.548Z","etag":null,"topics":["go","http-client"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PeterYangs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-09-25T09:05:58.000Z","updated_at":"2024-06-20T13:34:04.549Z","dependencies_parsed_at":"2023-01-20T01:17:00.710Z","dependency_job_id":null,"html_url":"https://github.com/PeterYangs/request","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/PeterYangs/request","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterYangs%2Frequest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterYangs%2Frequest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterYangs%2Frequest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterYangs%2Frequest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PeterYangs","download_url":"https://codeload.github.com/PeterYangs/request/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterYangs%2Frequest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271963023,"owners_count":24850599,"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","status":"online","status_checked_at":"2025-08-24T02:00:11.135Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["go","http-client"],"created_at":"2025-08-24T22:25:42.908Z","updated_at":"2025-08-24T22:25:46.211Z","avatar_url":"https://github.com/PeterYangs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# request\n\nhttp请求库\n\n**安装**\n\n```shell\ngo get github.com/PeterYangs/request/v2\n```\n\n**快速开始**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tcontent, err := client.R().GetToContent(\"https://www.baidu.com\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n\n```\n\n**get**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tr, err := client.R().Get(\"https://www.baidu.com\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tcontent, err := r.Content()\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n或者直接读取结果\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tcontent, err := client.R().GetToContent(\"https://www.baidu.com\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n\n```\n\n**post**\n\nParams作为body参数，Query作为url参数\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tr, err := client.R().Params(map[string]interface{}{\n\t\t\"list\":  \"123\",\n\t\t\"array\": []string{\"123\", \"456\"},\n\t\t\"form\": map[string]interface{}{\n\t\t\t\"name\":  \"yy\",\n\t\t\t\"email\": \"904801074@qq.com\",\n\t\t\t\"age\":   10,\n\t\t\t\"order\": []string{\"1\", \"2\", \"3\"},\n\t\t},\n\t}).Post(\"https://www.baidu.com\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tcontent, err := r.Content()\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n**post Multipart提交**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n\t\"os\"\n)\n\nfunc main() {\n\n\tf, e := os.OpenFile(\"README.md\", os.O_CREATE|os.O_RDWR, 0644)\n\n\tif e != nil {\n\n\t\treturn\n\t}\n\n\tclient := request.NewClient()\n\n\tct, err := client.R().Params(map[string]interface{}{\"name\": \"yy\", \"file\": f}).PostMultipartToContent(\"http://www.yycms.com/post_test\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(ct.ToString())\n\n}\n```\n\n\n**header**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\t//全局设置header\n\tclient := request.NewClient().Header(map[string]string{\"test\": \"demo\"})\n\n\t//请求设置header\n\tcontent, err := client.R().Header(map[string]string{\"test\": \"demo2\"}).GetToContent(\"http://list.com/demo/header.php\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n**proxy**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient().Proxy(\"http://127.0.0.1:4780\")\n\n\tcontent, err := client.R().GetToContent(\"https://www.google.com.hk/\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n**download**\n\n下载\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\turl := \"http://list.com/demo/demo.zip\"\n\n\tclient := request.NewClient()\n\n\terr := client.R().Download(url, \"123.zip\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\t}\n}\n```\n\n**reTry**\n\n重试\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tcontent, err := client.R().ReTry(1).GetToContent(\"http://list.com/asdjk.php\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n\n```\n\n**upload**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\n\tcontent, err := client.R().Upload(\"http://list.com/demo/get.php\", \"README.md\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n**自定义body**\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/PeterYangs/request/v2\"\n\t\"strings\"\n)\n\nfunc main() {\n\n\tclient := request.NewClient()\n\t//设置body后，Params将失效\n\tcontent, err := client.R().Body(strings.NewReader(\"name=123\u0026age=18\")).PostToContent(\"http://list.com/demo/post.php\")\n\n\tif err != nil {\n\n\t\tfmt.Println(err)\n\n\t\treturn\n\t}\n\n\tfmt.Println(content.ToString())\n\n}\n```\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeteryangs%2Frequest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeteryangs%2Frequest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeteryangs%2Frequest/lists"}