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

Camxshare : donnez accès aux services camxweb.com à vos clients sur votre plateforme

Une plate-forme pour les professionnels

Vous avez du trafic, vous avez un système de paiement et/ou une zone membres et vous souhaitez intégrer des live shows webcams majoritairement francophones et anglophones? Camxshare est fait pour vous!

Comment ça marche?

C'est très simple, grâce à nos flux multi-formats, vous intégrez les informations de nos produits sur votre site comme si c'était les vôtres, les clients paient via votre système de paiement et vous leur donnez accès directement à nos produits (liveshows webcam, vod, webtv, etc).

Vous achetez à l'avance un nombre de crédits que vous pourrez distribuer à l'ensemble de vos clients comme bon vous semble.

Comment faire?

1. Devenir affilié

Tout d'abord il faut ouvrir un compte webmaster chez nous en allant sur https://sponsors.only4info.com/?action=webmasters, c'est gratuit et c'est rapide.Vous obtiendrez ainsi vos accès pour entamer l'intégration de tous les produits disponibles sur camxweb.com.

2. Intégration de nos flux webmaster

Une fois votre compte webmaster créé, vous aurez alors accès à la documentation pour intégrer tous nos flux afin d'afficher de manière totalement transparente les produits VOD, WebTV et liveshows webcams (cliquez ici pour un exemple de flux intégrable).

Afin que l'intégration soit transparente pour vos clients, vous vous proposons des flux avec les plus grands standards utilisés : json, xml, phpserialisé, soap et wddx en plus de la tradionnelle solution iframe.

3. Création d'un compte camxshare

A ce niveau vous pourrez proposer tous nos produits sur votre site avec les infos que vous souhaitez afficher (descriptions, photos, vidéos, etc) mais l'url de vente pointera toujours vers camxweb.com.

Afin de permettre directement à vos clients d'ouvrir le produit camxweb.com (interface liveshow webcam, interface vod ou webtv), il vous faudra demander un compte camxshare. Il suffit de nous envoyer un ticket via l'interface de gestion webmaster et nous vous créerons un compte.

 
NB : Pour des raisons de sécurité, lors de la création du compte, nous vous demanderons la liste des ip des serveurs qui hébergent vos applications

4. Intégration du protocole camxshare

Camxshare a été développé sur le même modèle que les webservices que vous aurez déjà utilisés pour intégrer les informations sur nos produits (cependant soap sera activé sur demande pour cette partie), l'intégration sera donc rapide.

Camxshare est la plate-forme qui va vous permettre de donner l'accès à vos clients. Cliquez ici pour consulter la documentation d'intégration avec un exemple d'utilisation du webservice en xml.

5. Vendez votre service!

Et voilà, votre site présente de manière totalement intégrée nos produits, les clients s'enregistrent chez vous et paient directement chez vous pour accéder à nos produits!

Protocole d'intégration camxshare :

En parcourant ces quelques lignes vous verrez que l'intégration est simple. Le temps de développement n'en sera que plus réduit. La démonstration ci-dessous est en XML mais le flux est disponible dans d'autres formats (json, phpserial, wddx, etc).

Création d'une session

Pour toute nouvelle série d'actions que vous souhaitez faire, il vous faut établir une nouvelle session. Pour toutes les commandes suivantes, l'id de session sera demandé. Cette session n'a pas de limite de validité. Par contre il est nécessaire de recréer une nouvelle session si il n'y a plus eu d'interactivité avec l'API pendant plus de 15min ou si vous avez eu un message d'erreur autre que le code 400. Vous n'avez pas à recréer une session pour chaque nouvelle commande autre que "disconnect".

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

Destruction d'une session

A tout moment vous pouvez mettre fin à une session en invoquant cette commande

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>

Création d'un compte d'accès pour votre client

Pour chacun de vos clients, vous pouvez créer un compte avec le nombre de crédits que vous souhaitez lui attribuer. Ces crédits seront débités de votre compte camxshare et attribués à votre client.

Avec ces crédits, votre client pourra avoir accès à tous les produits présents sur camxweb.com (le nombre de crédits dépensés par le client sera calculé selon le produit choisi par le client - le nombre de crédits utilisés est le même que les clients camxweb.com).

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)

Obtenir les informations pour un compte client donné

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

Création d'une clé d'accès pour un de vos clients

Une fois que vous avez créé un compte avec le nombre de crédits que vous souhaitiez donner à votre client. Il faudra, à chaque fois que votre client voudra avoir accès à un produit, lui créer une clé d'accès à ce produit.

Pour créer une clé d'accès à un produit il vous faudra l'identifiant de ce produit qui se trouve dans la "TMKey" (clé présente dans tous les flux d'intégration webmaster).

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

Ajouter des crédits à un compte

Il vous est possible de recharger un compte client (même si il est en cours d'utilisation).

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

Obtenir la liste des comptes créés et le nombre de crédits restants sur votre compte

Afin d'avoir un aperçu d'utilisation de votre compte, il vous suffit d'appeler la commande "getStatus".

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

Codes de retours possibles

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.