Create your own awesome maps

Even on the go

with our free apps for iPhone, iPad and Android

Get Started

Already have an account?
Log In

RCSL by Mind Map: RCSL
0.0 stars - 0 reviews range from 0 to 5

RCSL

RCSL (Robo-Con Service Layer) is a layer that helps service consumers to retrieve content details in ways that suits their needs as well as performing other operations related to the business needs. All requests can combine the common parameters with operation-specific parameters to get better filtered and customized output. please note that the service will be available via normal http/https connection with a username/password send in each request header with RSA encryption for the sent password

Content Retrieval Operations

Code

Description

Parameters, contentId

SampleURL

Type

Description

Parameters, contentTypeId

SampleURL

Category

Description

Parameters, categoryId

SampleURL

Aritst

Description

Parameters, Artist, orderby

SampleURL

Album

Description

Parameters, Album

SampleURL

DetailedAlbum

Description

Parameters, detailedAlbum

SampleURL

SearchQuery

Description

Parameters, searchQuery

SampleURL

Genre

Description

Parameters, genre

SampleURL

User Profile

sample output for the bellow operations are the bellow: http://robo-con.com/userAccountoperations/playlist-operations/Create-playlist.xml http://robo-con.com/userAccountoperations/playlist-operations/Get-user-playlist.xml http://robo-con.com/userAccountoperations/playlist-operations/Remove-from-playlist.xml http://robo-con.com/userAccountoperations/playlist-operations/Remove-playlist.xml http://robo-con.com/userAccountoperations/playlist-operations/Update-playlist.xml http://robo-con.com/userAccountoperations/user-operations/Add-user-interest.xml http://robo-con.com/userAccountoperations/user-operations/Get-detailed-user-information.xml http://robo-con.com/userAccountoperations/user-operations/Get-user-interests.xml http://robo-con.com/userAccountoperations/user-operations/Login.xml http://robo-con.com/userAccountoperations/user-operations/Register.xml http://robo-con.com/userAccountoperations/user-operations/Remove-user-interest.xml http://robo-con.com/userAccountoperations/user-operations/Update-user-information.xml http://robo-con.com/userAccountoperations/verification-operations/Send-E-mail-verification-code.xml http://robo-con.com/userAccountoperations/verification-operations/Send-MSISDN-verification-code.xml http://robo-con.com/userAccountoperations/verification-operations/Verify-user-Email.xml http://robo-con.com/userAccountoperations/verification-operations/Verify-user-MSISDN.xml

Verification operations

Send MSISDN verification code, Parameters, action=sendMsisdnVC, userId, Sample URL, Description

Send E-mail verification code, Parameters, action=sendMailVC, userId, Sample URL, Description

Verify user MSISDN, Parameters, action=verifyMsisdn, userId, vCode, Sample URL, Description

Verify user Email, Parameters, action=verifyMail, userId, vCode, Sample URL, Description

Playlist operations

Add to playlist, Parameters, action=addToPlaylist, userId, playlistId, contentId, Sample URL, Description

Remove from playlist, Parameters, action=removeFromPlaylist, userId, playlistId, contentId, Sample URL, Description

Update playlist, Parameters, action=updateUserPlaylist, userId, RequestBody, Sample URL, Description

Create playlist, Parameters, action=createUserPlaylist, userId, playlistName, Sample URL, Description

Remove playlist, Parameters, action=removeUserPlaylist, userId, playlistId, Sample URL, Description

User Operations

Login, Parameters, action=login, username, password, social, Sample URL, Description

Register, Parameters, action=register, RequestBody, Sample URL, Description

Get detailed user information, Parameters, action=getUserInfo, userId, Sample URL, Description

Update user information, Parameters, action=update, RequestBody, Sample URL, Description

Add user interest, Parameters, action=addUserInterest, userId, interestId, Sample URL, Description

Remove user interest, Parameters, action=removeUserInterest, userId, interestId, Sample URL, Description

Get user interests, Parameters, action=getUserInterests, userId, Sample URL, Description

Common Parameters

look-ups

outputType

Content

userAgent

channel

pageId

itemsCount

categoryId

Generic

lang

type

MCC & MNC

Other Content Related Details

NewsId

Description

Parameters, newsId

Format

Description

Parameters, formatId

Look-Ups

This server URLis:  http:///rcsl/lookup Please note that all the bellow methods need the bellow parameters (check common paramters): outputtype type lang

Get All Categories List

Parameters

Description

Sample URL, http://82.201.143.231/rcsl/lookup?outputType=cats&type=XML&lang=en

Get All Albums List

Parameters

Description

Sample URL, http://82.201.143.231/rcsl/lookup?outputType=albums&type=XML&lang=en

Get All Artists List

Parameters

Description

Sample URL, http://82.201.143.231/rcsl/lookup?outputType=artists&type=XML&lang=en

Get All Genres List

Parameters

Description

Sample URL, http://82.201.143.231/rcsl/lookup?outputType=genres&type=XML&lang=en

Get All Models List

Parameters

Description

http://82.201.143.231/rcsl/lookup?outputType=models&type=XML&lang=en

Get All Models List By Brand

Parameters

Description

Get All Brands List

Parameters

Description

Get All Mimes List

Parameters

Description

Get All Mimes by content Type

Parameters

Description

Get All content Types

Parameters

Description

Get All Category Types

Parameters

Description

Get All News feed contents

Parameters

Description

Get All Interests

Parameters

Description

Get All Countries

Paramters

Description

Get All operators

Paramters

Description

Get All Operators per country

Paramters

Description

Get Operator Categories

Parameters

Description

Sample URL, 82.201.143.231/rcsl/lookup?outputType=operatorCategories&type=XML&mnc=1&mcc=602

Get Operator Categories V2

Parameters

Description

Sample URL, 82.201.143.231/rcslV2/lookup?outputType=CatList&type=XML&mnc=1&mcc=602

Get Radio Categories V2

Parameters

Description

Sample URL, 82.201.143.231/rcslV2/lookup?outputType=RadioList&type=XML&mnc=1&mcc=602

Security & Authentication

The Service layer authentication layer based upon a sent "username" & "password" value in all the required operations in the http(s) request header. with encrypting the password with RSA 1024. encryption steps: 1- ask for your username & password from mitech@arpuplus.com 2- send your username in your http request header as "username". 3- use the recieved public key to encrypt your password before sending it. 4- to convert your encrypted password to string please use Base64 encoding String. 5- send your password in the http request header as "password" to test your integration you can use the bellow URL: http://196.205.23.230/rcsl/testRSA.jsp

Charging Gateway

The bellow is the response output sample: http://robo-con.com/userAccountoperations/charging-operations/charging.xml

Parameters

msisdn:Mobile number to be charged. [mandatory] action:charge , checkbalance or refund [optional default: charge] amount: charging amount [mandatory] purchaseitem: Item to be charged [optional] vendor: item provider [optional] operatorId: operator ID (to be retrieved from lookup service) [mandatory] userAgent: user mobile model.[optional] details: more details to be stored in the purchase transaction. [optional]

Description

This service will be responsible for the customer charging activity (charging, refund or check balance) the charging action will be available based upon the integration with mobile operator

Sample URL

http://196.205.23.230/rcsl/roboconpayment?action=charge&type=xml&lang=en&msisdn=201221744287&operatorId=1&amount=0.5&purchaseitem=gameitem&vendor=gameloft&userAgent=&details=to%20buy%20item%20for%20the%20gameloft%20game

Utilities

Used to retrieve all of artists, albums and tracks that match the keyword

SendSMS

Paramters, operation = sms, msisdn, smsbody, operator, sc, amount, userAgent

Sample Url

Description

autocomplete

Parameters, catid, keyword, limit

Sample URL

Description

Document Log

(23-Jan-2014) Add MCC and MNC to common parameters (23-Jan-2014) Add operator categories to lookup (23-Jan-2014) Add autocomplete to utilities (23-Jan-2014) Add orderby parameter to Content Retrieval Operations - Artist (25-Jan-2014) Added Radio channels' Listing to Lookups (25-Jan-2014) Added the ability to retrieve content by code to be comma separated values to retrieve multiple content peices at once. (27-Jan-2014) Add limit parameter to autocomplete