JarCasting
Idobata4J is a Idobata(https://idobata.io) API binding library for the Java language licensed under Apache License 2.0.
Supported endpoints
| Endpoint | Http method | Java API |
|---|---|---|
| /api/seed | GET | Seed Idobata.getSeed() |
| /api/messages | GET | List Idobata.getMessages(List ids) |
| /api/messages | GET | List Idobata.getMessages(long roomId, long olderThan) |
| /api/messages | POST | Message Idobata.postMessage(long roomId, String source) |
| /api/messages | POST | Message Idobata.postMessage(long roomId, String fileName, String contentType, InputStream content) |
| /api/messages/${id} | DELETE | Message Idobata.deleteMessage(long messageId) |
| /api/users | GET | List Idobata.getUsers(List ids) |
| /api/users/${id} | GET | User Idobata.getUser(long guyId) |
| /api/rooms | GET | List Idobata.getRooms(List ids) |
| /api/rooms | GET | Room Idobata.getRoom(String organizationSlug, String roomName) |
| /api/rooms | GET | @Deprecated List Idobata.getRooms(String organizationSlug, String roomName) |
| /api/room/${id} | GET | Room Idobata.getRoom(long roomId) |
| /api/rooms/${id}/bots | POST | Bot postBot(long roomId, String botName) |
| /api/bots | GET | List getBots(List ids) |
| /api/bots | POST | Bot postBot(String botName, long organizationId) |
| /api/user/rooms/${id}/touch | POST | void Idobata.postTouch(long roomId) |
| /pusher/auth | POST | String Idobata.postPusherAuth(String channelName, String socketId) |
Usage
Post a message as an user.
String email = "SET-YOUR-EMAIL";
String password = "SET-YOUR-PASSWORD";
String organizationSlug = "SET-YOUR-ORGANIZATION_SLUG";
String roomName = "SET-YOUR-ROOM-NAME";
String source = "Hello, Idobata.";
RequestInterceptor authenticator = new FormAuthenticator(email, password);
Idobata idobata = new IdobataBuilder().setRequestInterceptor(authenticator)
.build();
Room room = idobata.getRoom(organizationSlug, roomName);
idobata.postMessage(room.getId(), source);
Post a message as a bot.
String apiToken = "SET-YOUR-API-TOKEN";
String organizationSlug = "SET-YOUR-ORGANIZATION_SLUG";
String roomName = "SET-YOUR-ROOM-NAME";
String source = "Hello, Idobata.";
RequestInterceptor authenticator = new TokenAuthenticator(apiToken);
Idobata idobata = new IdobataBuilder().setRequestInterceptor(authenticator)
.build();
Room room = idobata.getRoom(organizationSlug, roomName);
idobata.postMessage(room.getId(), source);
Subscribing push events.
RequestInterceptor authenticator = ...
Idobata idobata = new IdobataBuilder().setRequestInterceptor(authenticator)
.build();
idobata.openStream()
.subscribeMessageCreated(new IdobataStream.Listener<MessageCreatedEvent>() {
@Override
public void onEvent(MessageCreatedEvent event) {
System.out.println(event.getSenderName() + ":" + event.getBody());
}
})
.subscribeMemberStatusChanged(new IdobataStream.Listener<MemberStatusChangedEvent>() {
@Override
public void onEvent(MemberStatusChangedEvent event) {
System.out.println(event.getId() + ":" + event.getStatus());
}
});
Download
Idobata4J releases are available on Maven Central.
Gradle
compile "com.uphyca.idobata:idobata4j-core:${idobata4jVersion}"
Maven
<dependencies>
<dependency>
<groupId>com.uphyca.idobata</groupId>
<artifactId>idobata4j-core</artifactId>
<version>${idobata4j.version}</version>
</dependency>
</dependencies>
License
Copyright 2014 uPhyca, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
