{"id":38984593,"url":"https://github.com/polytomic/polytomic-java","last_synced_at":"2026-04-13T22:00:47.397Z","repository":{"id":219984157,"uuid":"734824881","full_name":"polytomic/polytomic-java","owner":"polytomic","description":"Java library for the Polytomic API","archived":false,"fork":false,"pushed_at":"2026-03-31T18:35:23.000Z","size":1317,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-04-01T22:27:55.339Z","etag":null,"topics":["java-client","java-sdk","kotlin-client","kotlin-sdk"],"latest_commit_sha":null,"homepage":"https://www.polytomic.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/polytomic.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":"2023-12-22T18:17:05.000Z","updated_at":"2026-03-18T22:32:56.000Z","dependencies_parsed_at":"2024-02-11T05:23:12.144Z","dependency_job_id":"615f6e82-6deb-46c9-aa58-46ec0c85c05d","html_url":"https://github.com/polytomic/polytomic-java","commit_stats":null,"previous_names":["polytomic/polytomic-java-sdk","polytomic/polytomic-java"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/polytomic/polytomic-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polytomic%2Fpolytomic-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polytomic%2Fpolytomic-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polytomic%2Fpolytomic-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polytomic%2Fpolytomic-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/polytomic","download_url":"https://codeload.github.com/polytomic/polytomic-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/polytomic%2Fpolytomic-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31772642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: 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":["java-client","java-sdk","kotlin-client","kotlin-sdk"],"created_at":"2026-01-17T16:58:24.973Z","updated_at":"2026-04-13T22:00:47.348Z","avatar_url":"https://github.com/polytomic.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polytomic Java Library\n\n[![Maven Central](https://img.shields.io/maven-central/v/com.polytomic/polytomic-java)](https://central.sonatype.com/artifact/com.polytomic/polytomic-java)\n\nThe Polytomic Java SDK provides convenient access to the Polytomic API from Java or Kotlin.\n\n## Documentation\n\nAPI reference documentation is available [here](https://docs.polytomic.com/reference).\n\n## Installation\n\n### Gradle\n\nAdd the dependency in your `build.gradle`:\n\n```groovy\ndependencies {\n    implementation 'com.polytomic:polytomic-java:0.0.1-beta0'\n}\n```\n\n### Maven\nAdd the dependency in your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.polytomic\u003c/groupId\u003e\n    \u003cartifactId\u003epolytomic-java\u003c/artifactId\u003e\n    \u003cversion\u003e0.0.1-beta0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n```java\nimport com.polytomic.api.Polytomic;\n\nPolytomic polytomic = Polytomic.builder()\n  .token(\"YOUR_API_KEY\")\n  .build();\n  \nvar bulkSync = polytomic.bulkSync().get(\"bulk-sync-id\")\n\nSystem.out.printlin(\"Received response! \" + bulkSync);\n```\n\n## Handling Errors\nWhen the API returns a non-success status code (4xx or 5xx response),\na subclass of [ApiError](./src/main/java/com/polytomic/api/core/ApiError.java)\nwill be thrown:\n\n```java\nimport com.polytomic.api.core.ApiError;\n\ntry {\n  polytomic.bulkSync().executions().list(/* ... */);\n} catch (ApiError error) {\n  System.out.println(error.getBody());\n  System.out.println(error.getStatusCode());\n}\n```\n\n## Additional Properties\nSometimes, the server response may include additional properties that are not\navailable in the SDK. Use the `getAdditionalProperties()` method to access them.\n\n```java\nObject value = entity.getAdditionalProperties().get(\"new_prop\");\n```\n\n## Request Options\nEvery method in the SDK takes an optional `RequestOptions` class where \nyou can specify overrides for that specific endpoint call.  \n\n```java\nimport com.polytomic.api.core.RequestOptions;\n\ntry {\n  polytomic.bulkSync().get(\"...\", RequestOptions.builder()\n    .apiKey(\"....\") // override the API key for this endpoint call\n    .build());\n```\n\n## Staged Builders\nAll models in the SDK use the staged builder the pattern. In particular, \nthe `build` method for a model will not be accessible until all required\nproperties are specified. \n\n```java\nimport comp.polytomic.api.types.BulkSchedule;\n\nBulkSchedule.builder()\n  .build() // build method inacessible\n\n\nBulkSchedule.builder()\n  .frequency(\"12h\")\n  .build() // build methd accessible after specifying frequency\n```\n\n## Version pinning\nWe recommend pinning the package\nversion to a specific version in your build.gradle file. This way, you can \ninstall the same version each time without breaking changes unless you are\nintentionally looking for the latest version.\n\n## Contributing\nWhile we value open-source contributions to this SDK, this library \nis generated programmatically. Additions made directly to this library \nwould have to be moved over to our generation code, otherwise they would \nbe overwritten upon the next generated release. Feel free to open a PR as a\nproof of concept, but know that we will not be able to merge it as-is. \nWe suggest opening an issue first to discuss with us!\n\nOn the other hand, contributions to the README are always very welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolytomic%2Fpolytomic-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolytomic%2Fpolytomic-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolytomic%2Fpolytomic-java/lists"}