Webmasters & animatrices webcams [FR] Webmasters & Webcams Performers [UK / EN]
 

Allow access to camxweb.com services to your clients on your system

A system aimed at professionals

You have traffic, you have a payment system and/or a member zone and you wish to integrate French/English speaking webcam live shows ? Camxshare is made for you !

How does it work ?

It is very easy. Thanks to our multiformat streams you can integrate information about our products right into your site just like if it was yours. Clients pay through your payment system and you give them direct access to our products (webcam live shows, vod, webtv and more).

You buy credits in advance and then you share them among your clients, according to their needs.

How to proceed ?

1. Become an affiliate

You first have to create an account on our system on http://modules.only4info.com/affiliate_form.net, it’s easy and free of charge. You’ll then receive your access to start integrating all our products available on camxweb.com.

2. Integration of our webmaster feeds

Once your webmaster account has been created you get access to all documentation to integrate all of our streams in order to display the vod, webtv and live show products (Click here to see an example of an integrable feeds.).

We provide you feeds with the most common standards : json, xml, phpserialized, soap and wddx besides the widely known iframe solution so that the integration is clear for your clients.

3. Creation of a camxshare account

At that stage you’ll be able to provide all of our products on your site along with the info you want to display (presentation, pictures, video,...) but the sales URL will always redirect to camxweb.com.

You have to request a camxshare account to allow your clients to have direct access to the camxweb product (webcam live show interface, vod or webtv interface). To request your account just send us a ticket on the webmaster management interface.

 
NB : For security reasons you’ll be asked the list of server ip’s that host your applications.

4. Camxshare protocol integration

Camxshare has been developed based on the same model as the webservices you might have already used to integrate all info about our products (however soap will be activated on request for that part). Integration should therefore be quite easy.

Camxshare is the system that will allow you to give access to your clients. Click here to view the integration documentation along with an example of the use of the xml webservice.

5. Sell your service !

There it is! Your site displays our fully integrated products, clients register and pay directly on your system to have access to our products !

Camxshare integration protocol :

While reading these few lines you’ll see that integration is easy. The time needed for integration will then be reduced. The example below is in XML but the stream is available in other formats (json, phpserial, wddx,...).

Session creation

For any new action you wish to take you have to establish a new session. The session id will be requested for all following orders. This session has no lifetime limit but you have to create a new session each time there is no activity for more than 15min with the API or if you received an error code above 400 (not inc). There is no need to create a new session each time you need to use a command.

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?action=connect&pw=1117773c7c1c197483dda0f46a7198f3&id=15456&token=fesfef13pwebrulessf4e54s
Parameters value :

action : connect

pw : md5 hash of your adminpanel password

id : your partner id

token : your token (given after the creation of your camxshare account)

Reply:
<xml>
  <code>200</code>
  <session_id>512cd6c15d0f3710f7d5126a3d</session_id>
</xml>
Reply values :

code : 200 if success (see below for codes)

session_id : the session_id to use for the other commands

Session destruction

You can end a session any time by calling this command

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?action=disconnect&session_id=512cd6c15d0f3710f7d5126a3d
Parameters value :

action : disconnect

session_id : the session id you want to kill

Reply : 
<xml>
  <code>200</code>
  <msg>session destroyed</msg>
</xml>

Creation of an access account for your client

You can create an account for each of your clients with the amount of credits you wish to give him. These credits will be withdrawn from your camxshare account and granted to your client.

With these credits your client will have access to all available products on camxweb.com (the amount of credits spent by the client will be calculated based on the product selected by the client. The amount of credits used is the same as the camxweb.com clients).

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?session_id=512cd6c15d0f3710f7d5126a3d&action=createAccount&credits=600
Parameters value :

session_id : the session id

action : createAccount

credits : the credits you want to give to your clients; this should me a unsigned integer value (ex : 600)

Reply:
<xml>
  <code>200</code>
  <account_id>CSTPEWHB</account_id>
  <account_balance>600</account_balance>
  <master_account>
    <initial_balance>16766301</initial_balance>
    <current_balance>16765701</current_balance>
  </master_account>
</xml>
Reply values :

code : 200 if success (see below for codes)

account_id : the ID of the camxshare client account created

account_balance : the amount of the camxshare client account created

master_account : contains the credits left on your camxshare account (initial = before last account creation)

Get info for a specific client account

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?session_id=512cd6c15d0f3710f7d5126a3d&action=getAccount&account_id=CSTPEWHB
Parameters value :

session_id : the session id

action : getAccount

account_id : the camxshare account you've created for your client via createAccount

Reply:
<xml>
  <code>200</code>
  <infos>
    <mz_account>CSTPEWHB</mz_account>
    <creation_date>2013-02-26 17:38:04</creation_date>
    <credits_allocated>600</credits_at_creation>
    <credits_left>372.50</credits_left>
  </infos>
</xml>
Reply values :

code : 200 if success (see below for codes)

infos: contains all information aboute the requested account

mz_account : the account ID

creation_date : the creation date and time

credits_allocated : the amount of credits when you created this account + credits you've added to this account

credits_left : le amount of credits left (decimal) on this account at the request time

Creation of an access key for one of your clients

Once you created an account with the amount of credits you wish to grant to your client. You’ll have to create an access key to a specific product each time your client wants to get access to the product.

To create an access key to a product you’ll need the ID of this product, which you’ll find in the TMKey (key that can be found in all webmaster integration streams).

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?session_id=512cd6c15d0f3710f7d5126a3d&action=getAccessKey&account_id=CSTPEWHB&TMKey=iBNjcGu3cwhgAEbAjLi1MA==
Parameters value :

session_id : the session id

action : getAccessKey

account_id : the camxshare account you've created for your client via createAccount

TMKey : the camxweb product ID which is in the webmaster streams

Reply:
<xml>
  <code>200</code>
  <key>mz7541bc01e16a7578f42484e227de6d0a</key>
  <url>
  https://www.camxweb.com/fr/hampton/consume/mz7541bc01e16a7578f42484e227de6d0a
  </url>
  <credits_left>371.000</credits_left>
</xml>
Reply values :

code : 200 if success (see below for codes)

key : the transaction key to access to the requested product

url : the url to redirect your client (it's a direct link to the product so in this case the adult liveshow console.

credits_left : the credits left (decimal) on the client account

Add credits to an account

You can reload a client account (even if it’s being used).

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?session_id=512cd6c15d0f3710f7d5126a3d&action=addCredits&credits=10&account_id=CSTPEWHB
Parameters value :

session_id : the session id

action : addCredits

account_id : the camxshare account you've created for your client via createAccount

credits : the amount of credits you want to add

Reply:
<xml>
  <code>200</code>
  <credits_allocated>610</credits_allocated>
  <credits_left>200.000</credits_left>
  <master_account>
    <current_balance>95990</current_balance>
  </master_account>
</xml>
Reply values :

code : 200 if success (see below for codes)

credits_allocated : the amount of credits when you created this account + credits you've added to this account

credits_left : the credits left (decimal) on the client account when you created the key

master_account > current_balance : contains the credits left on your camxshare account

Get the list of created accounts and the amount of remaining credits on your account

To get an overview of your account just call the « getStatus » command.

URL to call :
http://ws.only4info.com/xml/sis/v2/SIS.net?session_id=512cd6c15d0f3710f7d5126a3d&action=getStatus
Parameters value :

session_id : the session id

Reply
<xml>
  <code>200</code>
  <credits_left>15523135</credits_left>
  <accounts_create>1</accounts_create>
  <accounts>
    <node>
      <account_id>ETAWTEFN</account_id>
      <credits_allocated>100</credits_allocated>
      <creation_date>0000-00-00 00:00:00</creation_date>
    </node>
    <node>
      <account_id>EJ6AXW5A</account_id>
      <credits_allocated>100</credits_allocated>
      <creation_date>0000-00-00 00:00:00</creation_date>
    </node>
    <node>...</node>
    ...
  </accounts>
</xml>
Reply values :

code : 200 if success (see below for codes)

credits_left : the credits left on your camxshare account

accounts : list of user accounts you've createdd

accounts node > account_id : the user account ID

accounts node > credits_allocated : the credits added to this account (at creation and via the command "addCredits"

accounts node > creation_date : the date of the creation

Possible return codes

200 => 'Command Success' : the process was successful

401 => 'Access Denied' : you don't have access ; check your parameters

402 => 'Payment Required' : you don't have enough credits on the camxshare account

400 => 'Bad Request - Malformed syntax or missing parameters',

403 => 'Forbidden Area - Token Required',

404 => 'Object doesn't exist : the object you try to interact with doesn't exist anymore

405 => 'Method Not allowed',

--- 500 and Above - should never appear if so, retry later ---

500 => 'Internal Server Error',

501 => 'Not implemeted',

502 => 'Bad Gateway',

503 => 'Service Unavailable',

504 => 'Gateway Timeout'

Error reply structure 
<xml>
  <error>
    <code>401</code>
    <msg>Access Denied</msg>
  </error>
</xml>

[ X ]Ce site utilise les cookies afin de pouvoir stocker vos préférences et optimiser nos services. En fermant la notification, ou en continuant à naviguer sur le site, vous acceptez l'utilisation des cookies et nos conditions générales d'utilisation.