{"id":13801111,"url":"https://github.com/kivra/restclient","last_synced_at":"2026-02-19T02:32:31.669Z","repository":{"id":2721209,"uuid":"3715836","full_name":"kivra/restclient","owner":"kivra","description":"Erlang Rest Client","archived":false,"fork":false,"pushed_at":"2026-01-12T14:08:02.000Z","size":322,"stargazers_count":96,"open_issues_count":5,"forks_count":49,"subscribers_count":15,"default_branch":"master","last_synced_at":"2026-01-12T20:06:05.673Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Erlang","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/kivra.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2012-03-14T08:39:34.000Z","updated_at":"2026-01-12T13:53:56.000Z","dependencies_parsed_at":"2024-08-04T00:16:15.958Z","dependency_job_id":null,"html_url":"https://github.com/kivra/restclient","commit_stats":{"total_commits":130,"total_committers":21,"mean_commits":6.190476190476191,"dds":0.7230769230769231,"last_synced_commit":"e5df6d6736afedbb58ecd8681202bf2fe8637c12"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/kivra/restclient","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kivra%2Frestclient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kivra%2Frestclient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kivra%2Frestclient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kivra%2Frestclient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kivra","download_url":"https://codeload.github.com/kivra/restclient/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kivra%2Frestclient/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29601091,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T00:59:38.239Z","status":"online","status_checked_at":"2026-02-19T02:00:07.702Z","response_time":117,"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":[],"created_at":"2024-08-04T00:01:19.625Z","updated_at":"2026-02-19T02:32:31.653Z","avatar_url":"https://github.com/kivra.png","language":"Erlang","readme":"[![Hex.pm](https://img.shields.io/hexpm/v/restc.svg?maxAge=2592000)](https://hex.pm/packages/restc) restclient -- An erlang REST Client library\n====================================\n\n## DESCRIPTION\n\nrestclient is a library to help with consuming RESTful web services. It supports\nencoding and decoding JSON, Percent and XML and comes with a convenience\nfunction for working with urls and query parameters.\n\n## USAGE\n\nInclude restclient as a rebar dependency with:\n\n\t{deps, [{restc, \".*\", {git, \"git://github.com/kivra/restclient.git\", {tag, \"0.8.2\"}}}]}.\n\nYou have to start inets before using the client and if you want to use https make sure to start ssl before.\nThen you can use the client as:\n\n``` erlang\nErlang/OTP 19 [erts-8.2] [source] [64-bit] [smp:8:8] [async-threads:0] [kernel-poll:false]\n\nEshell V8.2  (abort with ^G)\n1\u003e application:ensure_all_started(restc).\n{ok,[idna,mimerl,certifi,ssl_verify_fun,metrics,hackney,\n     mochiweb_util,restc]}\n\n2\u003e restc:request(get, \"https://api.github.com\").\n{ok,200,\n    [{\u003c\u003c\"Server\"\u003e\u003e,\u003c\u003c\"GitHub.com\"\u003e\u003e},\n     {\u003c\u003c\"Date\"\u003e\u003e,\u003c\u003c\"Thu, 11 May 2017 07:36:16 GMT\"\u003e\u003e},\n     {\u003c\u003c\"Content-Type\"\u003e\u003e,\u003c\u003c\"application/json; charset=utf-8\"\u003e\u003e},\n     {\u003c\u003c\"Content-Length\"\u003e\u003e,\u003c\u003c\"2039\"\u003e\u003e},\n     {\u003c\u003c\"Status\"\u003e\u003e,\u003c\u003c\"200 OK\"\u003e\u003e},\n     {\u003c\u003c\"X-GitHub-Req\"...\u003e\u003e,\u003c\u003c\"8E05:5C9\"...\u003e\u003e}],\n    [{\u003c\u003c\"current_user_url\"\u003e\u003e,\u003c\u003c\"https://api.github.com/user\"\u003e\u003e},\n     {\u003c\u003c\"current_user_authorizations_html_url\"\u003e\u003e,\n      \u003c\u003c\"https://github.com/settings/connections/applications{/client_id}\"\u003e\u003e},\n     {\u003c\u003c\"authorizations_url\"\u003e\u003e,\n      \u003c\u003c\"https://api.github.com/authorizations\"\u003e\u003e},\n     {\u003c\u003c...\u003e\u003e,...},\n     {...}|...]}\n3\u003e restc:request(get, \"https://api.github.com/herp-derp-404\", [200]).\n{error,404,\n       [{\u003c\u003c\"Server\"\u003e\u003e,\u003c\u003c\"GitHub.com\"\u003e\u003e},\n        {\u003c\u003c\"Date\"\u003e\u003e,\u003c\u003c\"Thu, 11 May 2017 07:37:27 GMT\"\u003e\u003e},\n        {\u003c\u003c\"Content-Type\"\u003e\u003e,\u003c\u003c\"application/json; charset=utf-8\"\u003e\u003e},\n        {\u003c\u003c\"Content-Length\"\u003e\u003e,\u003c\u003c\"77\"\u003e\u003e},\n        {\u003c\u003c\"Status\"\u003e\u003e,\u003c\u003c\"404 Not Found\"\u003e\u003e},\n        {\u003c\u003c\"X-RateLimit-Limit\"\u003e\u003e,\u003c\u003c\"60\"\u003e\u003e},\n        {\u003c\u003c\"X-RateLimit-Remaining\"\u003e\u003e,\u003c\u003c\"56\"\u003e\u003e},\n        {\u003c\u003c\"X-RateLimit-Reset\"\u003e\u003e,\u003c\u003c\"1494491776\"\u003e\u003e},\n        {\u003c\u003c\"X-GitHub-Media-Type\"\u003e\u003e,\u003c\u003c\"github.v3\"\u003e\u003e},\n        {\u003c\u003c\"Access-Control-Expose-Headers\"\u003e\u003e,\n         \u003c\u003c\"ETag, Link, X-GitHub-OTP, X-RateLimit-Limit, X-RateLimit\"...\u003e\u003e},\n        {\u003c\u003c\"Access-Control-Allow-Origin\"\u003e\u003e,\u003c\u003c\"*\"\u003e\u003e},\n        {\u003c\u003c\"Content-Security-Policy\"\u003e\u003e,\u003c\u003c\"default-src 'none'\"\u003e\u003e},\n        {\u003c\u003c\"Strict-Transport-Security\"\u003e\u003e,\n         \u003c\u003c\"max-age=31536000; includeSubdomains; preload\"\u003e\u003e},\n        {\u003c\u003c\"X-Content-Type-Options\"\u003e\u003e,\u003c\u003c\"nosniff\"\u003e\u003e},\n        {\u003c\u003c\"X-Frame-Options\"\u003e\u003e,\u003c\u003c\"deny\"\u003e\u003e},\n        {\u003c\u003c\"X-XSS-Protection\"\u003e\u003e,\u003c\u003c\"1; mode=block\"\u003e\u003e},\n        {\u003c\u003c\"X-GitHub-Request-Id\"\u003e\u003e,\n         \u003c\u003c\"8C1D:5C90:54F34B8:6C6FF4D:59\"...\u003e\u003e}],\n       [{\u003c\u003c\"message\"\u003e\u003e,\u003c\u003c\"Not Found\"\u003e\u003e},\n        {\u003c\u003c\"documentation_url\"\u003e\u003e,\n         \u003c\u003c\"https://developer.github.com/v3\"\u003e\u003e}]}\n\n```\n\nThere's also convenience functions for working with urls and query string:\n\n``` erlang\n\t7\u003e restc:construct_url(\"http://www.example.com/te\", \"res/res1/res2\", [{\"q1\", \"qval1\"}, {\"q2\", \"qval2\"}]).\n\t\"http://www.example.com/te/res/res1/res2?q1=qval1\u0026q2=qval2\"\n```\n\n## License\nThe KIVRA restclient library uses an [MIT license](http://en.wikipedia.org/wiki/MIT_License). So go ahead and do what\nyou want!\n\nLots of fun!\n","funding_links":[],"categories":["Third Party APIs"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkivra%2Frestclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkivra%2Frestclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkivra%2Frestclient/lists"}