{"id":24764490,"url":"https://github.com/seamapi/java","last_synced_at":"2026-04-13T16:35:59.940Z","repository":{"id":170512255,"uuid":"646661861","full_name":"seamapi/java","owner":"seamapi","description":"Java library for accessing the Seam API","archived":false,"fork":false,"pushed_at":"2024-07-08T17:32:24.000Z","size":1226,"stargazers_count":0,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-08T00:41:12.814Z","etag":null,"topics":["java-client","java-sdk"],"latest_commit_sha":null,"homepage":"https://docs.seam.co","language":"Java","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/seamapi.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,"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-05-29T03:53:06.000Z","updated_at":"2024-07-08T17:32:30.000Z","dependencies_parsed_at":"2023-11-16T04:30:52.905Z","dependency_job_id":"13fdac83-e0eb-43b8-aae1-a213ff518e91","html_url":"https://github.com/seamapi/java","commit_stats":null,"previous_names":["fern-seam/seam-java","seamapi/java"],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/seamapi/java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fjava","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fjava/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fjava/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fjava/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seamapi","download_url":"https://codeload.github.com/seamapi/java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seamapi%2Fjava/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31761986,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","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"],"created_at":"2025-01-28T22:31:49.521Z","updated_at":"2026-04-13T16:35:59.914Z","avatar_url":"https://github.com/seamapi.png","language":"Java","readme":"# Seam Java Library\n\n[![Maven Central](https://img.shields.io/maven-central/v/io.github.seamapi/java)](https://central.sonatype.com/artifact/io.github.seamapi/java) \n[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://buildwithfern.com/?utm_source=seamapi/java/readme)\n\n## Documentation\n\nAPI documentation is available at https://docs.seam.co/latest/api-clients/overview.\n\n## Install\n\n### Gradle\n\nAdd the dependency in your `build.gradle`:\n\n```groovy\ndependencies {\n    implementation 'io.github.seamapi:java:0.x.x'\n}\n```\n\n### Maven\n\nAdd the dependency in your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.seamapi\u003c/groupId\u003e\n    \u003cartifactId\u003ejava\u003c/artifactId\u003e\n    \u003cversion\u003e0.x.x\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n```java\nimport com.seam.api.Seam;\nimport com.seam.api.types.AccessCode;\nimport com.seam.api.resources.accesscodes.requests.AccessCodesCreateRequest;\n\nSeam seam = Seam.builder()\n        .token(\"MY_API_KEY\")\n        .build();\nAccessCode accessCode = seam.accessCodes().create(AccessCodesCreateRequest.builder()\n        .deviceId(someDevice.getDeviceId())\n        .name(\"Test code\")\n        .code(\"4444\")\n        .build());\nSystem.out.println(accessCode);\n```\n\n## Using PATs\nIf you're using access tokens to authenticate with the API, make sure \nto supply the seam workspace when you construct the client. \n\n```java\nimport com.seam.api.Seam;\nimport com.seam.api.types.AccessCode;\n\nSeam seam = Seam.builder()\n        .token(\"YOUR_PAT\")\n        .seamWorkspace(\"YOUR_WORKSPACE_ID\")\n        .build();\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/seam/api/core/ApiError.java)\nwill be thrown:\n\n```ts\nimport com.seam.api.core.ApiError;\n\ntry {\n  seam.accessCodes().create(...);\n} catch (ApiError error) {\n  System.out.println(error.getBody());\n  System.out.println(error.getStatusCode());\n}\n```\n\n## Staged Builders\nThe generated builders all follow the staged builder pattern. \nRead more [here](https://immutables.github.io/immutable.html#staged-builder).\nStaged builders only allow you to construct the object once all required \nproperties have been specified. \n\nFor example, in the snippet below, you will not be able to access the build\nmethod on `AccessCodesCreateRequest` until you have specified the mandatory \ndeviceId variable.\n\n```java\nimport com.seam.api.resources.accesscodes.requests.AccessCodesCreateRequest;\n\nAccessCodesCreateRequest.builder()\n    .deviceId(someDevice.getDeviceId())\n    .name(\"Test code\")\n    .code(\"4444\")\n    .build()\n```\n\n## Beta status\n\nThis SDK is in beta, and there may be breaking changes between versions without a major version update. \nTherefore, we recommend pinning the package version to a specific version in your build.gradle file. \nThis way, you can install the same version each time without breaking changes unless you are \nintentionally looking for the latest version.\n\n## Contributing\n\nWhile we value open-source contributions to this SDK, this library is generated programmatically. \nAdditions made directly to this library would have to be moved over to our generation code, \notherwise they would be overwritten upon the next generated release. Feel free to open a PR \nas a proof of concept, but know that we will not be able to merge it as-is. We suggest opening an issue first to discuss with us!\n\nOn the other hand, contributions to the README are always very welcome!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseamapi%2Fjava","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseamapi%2Fjava","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseamapi%2Fjava/lists"}