{"id":30793987,"url":"https://github.com/sendgrid/java-http-client","last_synced_at":"2025-09-05T16:26:17.072Z","repository":{"id":7422204,"uuid":"53534967","full_name":"sendgrid/java-http-client","owner":"sendgrid","description":"SendGrid's Java HTTP Client for calling APIs","archived":false,"fork":false,"pushed_at":"2023-04-10T00:22:01.000Z","size":2786,"stargazers_count":25,"open_issues_count":5,"forks_count":78,"subscribers_count":155,"default_branch":"main","last_synced_at":"2025-07-09T14:09:00.659Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://sendgrid.com","language":"Java","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/sendgrid.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-09T21:59:49.000Z","updated_at":"2024-06-27T12:59:53.000Z","dependencies_parsed_at":"2023-01-13T14:22:28.639Z","dependency_job_id":null,"html_url":"https://github.com/sendgrid/java-http-client","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/sendgrid/java-http-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fjava-http-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fjava-http-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fjava-http-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fjava-http-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sendgrid","download_url":"https://codeload.github.com/sendgrid/java-http-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fjava-http-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273782704,"owners_count":25167200,"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-09-05T02:00:09.113Z","response_time":402,"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":"2025-09-05T16:26:14.214Z","updated_at":"2025-09-05T16:26:17.058Z","avatar_url":"https://github.com/sendgrid.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![SendGrid Logo](twilio_sendgrid_logo.png)\n\n[![Test and Deploy](https://github.com/sendgrid/java-http-client/actions/workflows/test-and-deploy.yml/badge.svg)](https://github.com/sendgrid/java-http-client/actions/workflows/test-and-deploy.yml)\n[![Maven Central](https://img.shields.io/maven-central/v/com.sendgrid/java-http-client.svg)](http://mvnrepository.com/artifact/com.sendgrid/java-http-client)\n[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Twitter Follow](https://img.shields.io/twitter/follow/sendgrid.svg?style=social\u0026label=Follow)](https://twitter.com/sendgrid)\n[![GitHub contributors](https://img.shields.io/github/contributors/sendgrid/java-http-client.svg)](https://github.com/sendgrid/java-http-client/graphs/contributors)\n\n**Quickly and easily access any RESTful or RESTful-like API.**\n\nIf you are looking for the SendGrid API client library, please see [this repo](https://github.com/sendgrid/sendgrid-java).\n\n# Table of Contents\n\n* [Announcements](#announcements)\n* [Installation](#installation)\n* [Quick Start](#quick-start)\n* [Usage](./USAGE.md)\n* [How to Contribute](#contribute)\n* [About](#about)\n* [Support](#support)\n* [License](#license)\n\n\u003ca name=\"announcements\"\u003e\u003c/a\u003e\n# Announcements\n\nAll updates to this project are documented in our [CHANGELOG](CHANGELOG.md).\n\n\u003ca name=\"installation\"\u003e\u003c/a\u003e\n# Installation\n\n## Prerequisites\n\n- Java 8, 11, or 17\n\n## Install via Maven w/ Gradle\n\n```groovy\n...\ndependencies {\n  ...\n  compile 'com.sendgrid:java-http-client:4.5.1'\n}\n\nrepositories {\n  mavenCentral()\n}\n...\n```\n\n### Maven\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.sendgrid\u003c/groupId\u003e\n    \u003cartifactId\u003ejava-http-client\u003c/artifactId\u003e\n    \u003cversion\u003e4.5.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n`mvn install`\n\n## Dependencies\n\n- Please see the [pom.xml file](pom.xml)\n\n\u003ca name=\"quick-start\"\u003e\u003c/a\u003e\n# Quick Start\n\nHere is a quick example:\n\n`GET /your/api/{param}/call`\n\n```java\nClient client = new Client();\n\nRequest request = new Request();\nrequest.setBaseUri(\"api.test.com\");\nrequest.setMethod(Method.GET);\nString param = \"param\";\nrequest.setEndpoint(\"/your/api/\" + param + \"/call\");\n\ntry {\n    Response response = client.api(request);\n    System.out.println(response.getStatusCode());\n    System.out.println(response.getBody());\n    System.out.println(response.getHeaders());\n} catch (IOException ex) {\n    throw ex;\n}\n```\n\n`POST /your/api/{param}/call` with headers, query parameters and a request body.\n\n```java\nrequest.addHeader(\"Authorization\", \"Bearer YOUR_API_KEY\");\nrequest.addQueryParam(\"limit\", \"100\");\nrequest.addQueryParam(\"offset\", \"0\");\n// Will be parsed to categories=cake\u0026categories=pie\u0026categories=baking\nrequest.addQueryParam(\"categories\", \"cake\u0026pie\u0026baking\");\nrequest.setBody(\"{\\\"name\\\": \\\"My Request Body\\\"}\");\nrequest.setMethod(Method.POST);\nString param = \"param\";\nrequest.setEndpoint(\"/your/api/\" + param + \"/call\");\n\ntry {\n    Response response = client.api(request);\n    System.out.println(response.getStatusCode());\n    System.out.println(response.getBody());\n    System.out.println(response.getHeaders());\n} catch (IOException ex) {\n    throw ex;\n}\n```\n\n\u003ca name=\"contribute\"\u003e\u003c/a\u003e\n# How to Contribute\n\nWe encourage contribution to our projects please see our [CONTRIBUTING](CONTRIBUTING.md) guide for details.\n\nQuick links:\n\n- [Feature Request](CONTRIBUTING.md#feature-request)\n- [Bug Reports](CONTRIBUTING.md#submit-a-bug-report)\n- [Improvements to the Codebase](CONTRIBUTING.md#improvements-to-the-codebase)\n- [Review Pull Requests](CONTRIBUTING.md#Code-Reviews)\n\n\u003ca name=\"about\"\u003e\u003c/a\u003e\n# About\n\njava-http-client is maintained and funded by Twilio SendGrid, Inc. The names and logos for java-http-client are trademarks of Twilio SendGrid, Inc.\n\n\u003ca name=\"support\"\u003e\u003c/a\u003e\n# Support\n\nIf you need help using SendGrid, please check the [Twilio SendGrid Support Help Center](https://support.sendgrid.com).\n\nIf you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!\n\n# License\n[The MIT License (MIT)](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fjava-http-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsendgrid%2Fjava-http-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fjava-http-client/lists"}