com.github.ismaeltoe:osms-android

DEPRECATED

osms-android is deprecated. No more development will be taking place. It's better not to use it. Instead, see it as a hint on how to integrate Orange SMS API in your Android project and use the latest version of Retrofit. Much has changed since the release of osms-android.

osms-android

Provides an Android wrapper for the Orange SMS API.

Usage

Retrieve an access token

Osms osms = new Osms("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

CredentialsService credentialsService = osms.credentials();

credentialsService.getAccessToken(
    "client_credentials",
	new Callback<CredentialsEntity>() {
	    @Override
		public void success(CredentialsEntity credentialsEntity, Response response) {
		    // token successfully retrieved
		}
		
		@Override
		public void failure(RetrofitError error) {
		    // an error has occured
		}
	}
)

Send a message

Osms osms = new Osms();
osms.setAccessToken('YOUR_ACCESS_TOKEN');

MessagingService messagingService = osms.messaging();

OutboundSMSTextMessage outboundSMSTextMessage = new OutboundSMSTextMessage("Hello World!");

OutboundSMSMessageRequest outboundSMSMessageRequest = new OutboundSMSMessageRequest(
    "tel:[phone]", // the receiver address
	outboundSMSTextMessage,
	"tel:[phone]", // the sender address
	"Optimus Prime" // the sender name
);

MessageEntity messageEntity = new MessageEntity(outboundSMSMessageRequest);

messagingService.sendMessage(
    "tel:[phone]", // the sender address
	messageEntity,
	new Callback<MessageEntity>() {
	    @Override
		public void success(MessageEntity messageEntity, Response response) {
		    // the message has been sent
		}
		
		@Override
		public void failure(RetrofitError error) {
		    // an error has occured
		}
	}
)

See the sample app for more examples.

Download

Add the following dependency to your Gradle project:

    compile 'com.github.ismaeltoe:osms-android:1.0'

Reference

• Javadoc http://ismaeltoe.github.io/osms-android
• Native API https://developer.orange.com/apis/sms-ci/getting-started

Developed By

• Ismael Toé - [e-mail]

Other Libraries

• osms-php

License

Copyright 2015 Ismael Toé

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.