API/overview

From Webcamwiz
Jump to: navigation, search


Overview

This document describes how to embed ImLive webcam chat functionality in sites.

This is a high level overview of the available components and APIs that can be embedded and used. The technical details of the integration can be found in each component’s API/integration document.

It should be noted that the components and APIs currently available for embedding cover a part of a full webcam chat service. For a full service, the embedding site should still redirect the users to ImLive or to an ImLive white label site.

Sample Site

A sample reference site, developed with API can be viewed here - http://www.nonstopcam.biz/

Source code: The PHP source code for the sample site can be downloaded here - http://wiki.webcamwiz.com/webcamwiz_php_api_sample.rar

Important: This sample code is provided as an API reference only. It is not advised to use this code for production purposes. We advise the site builder to review this code and understand how our API works and then build the new site from scratch with no shared fingerprint with the reference code.

Available Functionality

The following functions are available for embedding.

A site can choose to integrate and embed all or a part of the available components.

  1. Host list – returns the list and details of hosts currently online.
  2. Host search - return a list of hosts matching a search criteria.
  3. Create user account.
  4. Log in to user account..
  5. Free live chat.

Host list

The host list feed service can be used to retrieve a list of webcam hosts that is currently available to chat.

The service receives a set of parameters that determines the type of hosts required.

The returned list contains full details of the host, including all properties and images.

This enables the embedding site to render pages of hosts galleries.

Full details of this service for integration is documented in the integration document API/host_list_feed.

Host search

The host search service can be used to retrieve a list of webcam hosts based on some provided search criteria..

The service receives a set of parameters that determines the search conditions..

The returned list contains full details of the host, including all properties and images.

Full details of this service for integration is documented in the integration document API/host_search.

Create user account

This service enables a site to register new user accounts in ImLive or a white label site.

It can be used to automatically create webcam user accounts from the user profiles in the embedding website so that existing users of the embedding site will have single-login experience and will not need to login to the webcam site separately.

Full details of this service for integration is documented in the integration document API/user_accounts.

Login to user account

This service logs into an existing webcam user account and creates a new session.

It can be used when sending a user from the embedding site to the webcam site so that the user will not need to manually login to the webcam site.

Full details of this service for integration is documented in the integration document API/user_accounts.

Free live chat

This is a fully functional and customizable webcam live video chat player that can be generated and embedded in the embedding site.

It enables the embedding site to provide its users with free live chat service without leaving the site.

Note: This player only support free chat. For private chats, the user will have to be redirected to ImLive or an ImLive white label.

Full details of this service for integration is documented in the integration document API/free_chat_player.