JarCastingeztexting-java
A Java client for the EZ Texting SMS text messaging API
Overview
EZ Texting provides an API for sending SMS text messages.
You will need an account to use this library. Consult the API Documentation
This library does not implement all the features of their API.
This library can:
- Send SMS messages
- Manage Contacts
- Manage Groups
- Carrier Lookup
This library cannot:
- Manage Inbox
- Manage Keywords
- Manage Credits
- Voice Broadcast
If you need a feature implemented, please submit a pull request or file an issue.
Basic Usage
Sending a SMS message
EzTextingClient ez = new EzTextingClient(
new EzTextingCredentials("username","password"));
Messaging messaging = new Messaging(ez);
Message message = new Message.Builder()
.subject("test")
.message("Here I am EZ Texting")
.phone("5551234567")
.build();
messaging.send(message);
Managing Groups
GroupManager groups = new GroupManager(ez);
Group group = groups.create("neat");
GroupQuery query = new GroupQuery.Builder()
.sortBy(SortBy.GROUP_NAME)
.itemsPerPage(10)
.page(1)
.build();
List<Group> all = groups.retrieveAll(query);
Managing Contacts
ContactManager contacts = new ContactManager(ez);
CreateRequest request = new CreateRequest.Builder()
.phone("5551234567")
.first("first")
.last("last")
.email("my@email.com")
.group("group1")
.group("group2")
.build();
Contact contact = contacts.create(request);
UpdateRequest update = new UpdateRequest.Builder()
.email("another@email.com")
.group("group1", "group3")
.build();
contact = contacts.update(contact, update);
contacts.delete(contact);
ContactQuery query = new ContactQuery.Builder()
.query("5551234567")
.sortBy(SortBy.LAST_NAME)
.ascending()
.itemsPerPage(100)
.build();
List<Contact> found = contactManager.retrieveAll(query);
Dependencies
- Jersey Client 1.18.1 for HTTP I/O
- Jackson 2.3.3 for JSON parsing
Maven 2 Support
This library is in the Maven Central Repository.
<dependencies>
<dependency>
<groupId>com.github.krenfro</groupId>
<artifactId>eztexting-java</artifactId>
<version>0.0.3</version>
</dependency>
</dependencies>