Gurulize Video API Documentation

Gurulize Video API Documentation

Instead of launching an all-in-one e-consultancy application with Gurulize,  you can integrate your existing application utilizing  Gurulize Video API.

Method: GET

https://webrtc.gurulize.com/webrtc-meeting/room/create

Parameters

durationInMinutes = Max call duration in minutes
type = Video (fixed for now)
startDate = The time to start the conversation in unix timestamp format and the start time
in milliseconds (not seconds) and should be sent according to the UTC timezone value
username = [Username]
password = [Password]
endHow = AUTOMATIC, BY_HOST
endWhen = END_TIME, END_OF_DURATION
lang = en, tr

Sample Request:

https://webrtc.gurulize.com/webrtc-meeting/room/create?durationInMinutes=50&type=video&startDate=1597148937000&username=xxx&password=yyy&endHow=AUTOMATIC&endWhen=END_TIME

Sample response:

{

   "uuid": "444f4061-3494-4e60-a552-c4316ac6702d",

   "hostUrl": "https://webrtc.gurulize.com/?rop=V_US2qRjrTFn&urp=gN-mYTXkrV7pVPMr_jUfqSE4gBmZzEKi2MI1cOfnUxtFr4S-YacER5lkFG2dkFIUU%22,

   "guestUrl": "https://webrtc.gurulize.com/?rop=GFPyacAAOrPc&urp=gN-mYTXkrV7pVPMr_jUfqSE4gBmZzEKi2MI1cOfnUxtFr4S-YacER5lkFG2dkFIU%22

}

Callback Method:

To an address to be forwarded by the user:

METHOD: POST

BODY: JSON DATA

Sample Payload:

{

   "code": "JOIN",

   "eventSource": "GUEST",

   "receivedTime": "1600938359259",

   "reason": "",

   "roomUuid": "444f4061-3494-4e60-a552-c4316ac6702d",

   "meetingTotalDuration": "0"

}

  • The parameters except reason and meetingTotalDuration always returns, these two parameters ​​exist in the response only for certain codes.
code: Event codes
JOIN: Occurs when the person entering the room says join the conversation
ROOM_ACTIVATED: It is produced only once when two people start to meet.
MEETING_STARTED: Occurs every time a conversation starts in the room
(including breaks and returns)
LEFT: Occurs when one party leaves the room (including ruptures)
MEETING_ENDED: Occurs every time the call ends (including breaks)

eventSource: Indicates by whom the event occurred
HOST: At all events
GUEST: At all events
SERVER: This is set at the end of time only in rooms created as endHow = AUTOMATIC and
comes with the MEETING_ENDED event.

receivedTime: The timestamp value in utc and milliseconds of the moment the event occurred.
roomUuid: Is the unique id of the conversation room , the same as the uuid value
returned from the create room method.

reason: Only comes in the MEETING_ENDED event
HANGUP: When the call is ended with the end call button
END_MEETING: endHow = When the host says end the call in rooms with BY_HOST
END_MEETING_FORCED: endHow = Set at the end of time in rooms created as AUTOMATIC

meetingTotalDuration: returns the total service time in milliseconds that has passed so far
in this room in MEETING_ENDED events
  • It is a cumulative value, that is, it does not return the value of that moment for each start end, it returns the sum by putting it on each time.
  • This time is different from the time between the moment when the room is first entered and when the last exit is made.
  • MEETING_START and MEETING_END events can occur multiple times for a room (breaks, drops)

Get Help

Gurulize offers several support resources designed to help e-consultancy professionals with every step of the e-consultancy digital creation process. To learn more about available support resources, visit our Where to Get Help guide.

    • Related Articles

    • Gurulize Voice API Documentation

      Instead of launching an all-in-one e-consultancy application with Gurulize, you can integrate your existing application utilizing Gurulize Voice API. You can start marketing your audio consultancy to your clients from your existing site, the phone, ...
    • What is a Gurulize Click2Call Server?

      Gurulize Click2Call Server is a robust server application developed by the Gurulize team connected to all GSM operators around the world. Gurulize Click2Call Server calls the customer via a standard GSM call via their GSM operator, then the server ...
    • What is a WEBRTC Server?

      WEBRTC Server is a robust server application developed by the Gurulize team utilizing Google's state of the art technology for video calls. This framework is integrated into most popular browsers so end users do not have to install anything to their ...