engineer.nightowl-groupsio-api-java

Java client for the Groups.IO API

License	GNU GPLv3
Categories	Java Languages
GroupId	engineer.nightowl
ArtifactId	groupsio-api-java
Last Version	0.0.3
Release Date	Dec 16, 2019
Type	jar
Description	engineer.nightowl-groupsio-api-java Java client for the Groups.IO API
Project URL	https://github.com/nightowlengineer/groupsio-api-java
Source Code Management	https://github.com/nightowlengineer/groupsio-api-java/tree/master

Download groupsio-api-java

Filename	Size
groupsio-api-java-0.0.3.pom
groupsio-api-java-0.0.3.jar	48 KB
groupsio-api-java-0.0.3-sources.jar	31 KB
groupsio-api-java-0.0.3-javadoc.jar	198 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/engineer.nightowl/groupsio-api-java/ -->
<dependency>
    <groupId>engineer.nightowl</groupId>
    <artifactId>groupsio-api-java</artifactId>
    <version>0.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/engineer.nightowl/groupsio-api-java/
implementation 'engineer.nightowl:groupsio-api-java:0.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/engineer.nightowl/groupsio-api-java/
implementation ("engineer.nightowl:groupsio-api-java:0.0.3")

Apache Buildr

'engineer.nightowl:groupsio-api-java:jar:0.0.3'

Apache Ivy

<dependency org="engineer.nightowl" name="groupsio-api-java" rev="0.0.3">
  <artifact name="groupsio-api-java" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='engineer.nightowl', module='groupsio-api-java', version='0.0.3')
)

Scala SBT

libraryDependencies += "engineer.nightowl" % "groupsio-api-java" % "0.0.3"

Leiningen

[engineer.nightowl/groupsio-api-java "0.0.3"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.apache.commons : commons-lang3	jar	3.6
commons-io : commons-io	jar	1.3.2
org.apache.httpcomponents : httpclient	jar	4.5.2
com.fasterxml.jackson.core : jackson-databind	jar	2.9.10.1

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

groupsio-api-java

Java client library for the Groups.io API.

What is Groups.io?

Groups.io is a service that provides online communities and mailing lists - essentially a modern alternative to Yahoo! Groups.

See https://groups.io to find out more about the service.

Maven

<dependency>
    <groupId>engineer.nightowl</groupId>
    <artifactId>groupsio-api-java</artifactId>
    <version>0.0.1</version>
</dependency>

API documentation

The client is based on the API Docs. As the API is under active development and not yet considered stable, the project will be updated as soon as possible after updates are published.

GroupsIOApiClient client = new GroupsIOApiClient(apiKey, email);

Login

Use the provided password to login to Groups.io and generate an API token, which will be stored in the client instance. The token is returned should you need it.

String apiToken = client.user().login("password");

Error Handling

The client will throw GroupsIOApiException when an error is returned by the Groups.io API, or if an internal error occurs.

With the API, only invalid_value will contain an 'extra' value, all other errors just return the error type.

{
  type: "invalid_value",
  extra: "groupId"
}

Issue Reporting

If you've found an issue or have a request with this client, please create an issue.

If you have an issue or question about the API itself, a mailing list is available here.

Author

James Milligan

Legal

This project is licensed under the GPLv3 license. See the LICENSE file for more info.

The Groups.io name and logo are copyright of Groups.io, Inc, and use of the service is subject to their Terms of Service.

Versions

Version
0.0.3 Dec 16, 2019
0.0.2 Nov 5, 2018