Home > Managing Projects, Data & The Organization > How To Use The SurveyToGo REST API

How To Use The SurveyToGo REST API

 


Overview

 

You can access your organization data using the SurveyToGo REST API. The REST API allows you to create a tight integration between the SurveyToGo system and any 3rd party system. Using the API requires prior knowledge of the REST protocol and experience in programming. You can use the REST API from any operating system and any programming language. The SurveyToGo REST API consists of a set of operations which are listed below. Please note we are adding to the list of operations so check back often or subscribe to this topic to stay on top of any new REST operation that is supported.

 

Downloading the Testbed App and Full Source code

 

Dooblo provides you with a free SurveyToGo REST API Testbed app that allows you to test all the available operations and see the output you will get to assist with the development process. In addition we provide the full C# source code of the Testbed app so that you can see the actual implementation of the code. Please note you can call the REST API from any language, not just C#:

 

SurveyToGo REST API Operations Available

 

The following operations are available:

 

General Account management:

  • GetCreditBalance – returns the current interview balance
  • GetStorageStatus – returns the current storage space usage

 

User Administration & Assignment

  • AddSurveyorUser – adds a new interviewer user to the organization
  • DeleteSurveyorUser – deletes the interviewer user from the organization
  • AssignSurveyorUserToProject – assigns the interviewer user to the project
  • UnassignSurveyorUserFromProject – unassign the interviewer user from the project
  • GetProjectSurveyorUsers – returns the list of interviewers users assigned to a project
  • GetProjectSurveyorGroups – returns the list of interviewer groups assigned to a project
  • GetGroupUsers – returns the list of users in a group

 

Projects & Customers

  • Customers – returns the list of customers in the organization
  • CustomerProjects – returns the list of projects of a certain customer
  • ProjectSurveys – returns the list of surveys within a project
  • CreateCustomer – creates a new customer
  • CreateProject – creates a new project within a customer
  • CloneSurvey – creates a copy of an existing survey in the same or different project
  • Surveys – returns the details of a specific survey
  • GetSurveyXML – returns the full survey XML structure of a specific survey

 

Data

  • OperationData – returns the interview operational data in a form similar to the operations console
  • SurveyInterviewIDs – returns the list of interview ID’s of a survey based on filters
  • SurveyInterviewData – returns the actual XML data of the interviews based on ID’s.

 

Interviews

  • ChangeStatus – changes the status of an interview

 

Additional Data Lists

 

 

 

URL For Calling the REST API

 

The SurveyToGo REST API is hosted at this URL: https://api.dooblo.net/newapi

Calling the actual operations involves referencing the correct URL and passing the relevant user/password details.

 

User ID for Accessing the REST API

 

To call the various operations you need to specify a valid user ID. The user ID is in the form of XXXX-XXXX-XXXX/YYYY where the first part is your organization REST API Key and the second part is the relevant user name you wish to use for the operations. Please note the user accessing the REST API needs to have the relevant permissions for the operations that user is calling. For example, if the user does not belong to a certain project that user will get an authorization error if that user attempts to call operations for that project.

 

For example, if the user you wish to use when calling the REST API is named “mark” and the organization REST API Key is: f150fc49-3a14-4ecb-9214-ca04698a9578 the user ID that you need to use when calling the REST API: f150fc49-3a14-4ecb-9214-ca04698a9578/mark

Contact support@dooblo.com to receive your organization REST API Key to use with the REST API.

 

JSON vs XML Output of requests

 

In some calls you can request to receive the output of the data in either JSON or XML format. This is intended to cater to each programmer preference. However, please keep in mind that for some operations that return either interview data or survey data in them, only XML will be supported as an output format. If you try to call these with JSON as format you will receive an error: “Error: This method supports only xml” from the API.

 

Sharing of your SurveyToGo REST API Integration Success Stories

 

If you developed a cool integration using the SurveyToGo REST API, we would love to hear about it and possibly share the project highlights with the rest of our community along with your name and details (if you wish) to promote your expertise and broaden the horizon of our community! Let us know by emailing us at ofer@dooblo.com .

 

Missing an API that will assist you in your integration? Let us know!

 

If during the development of your integration you are missing an API please let us know at support@dooblo.com and we will make sure our SurveyToGo REST API product team is notified of the request to be reviewed for adding to future versions.

 

 

Visit us at: http://www.dooblo.net

 

  1. MIkhail
    July 23, 2015 at 9:44 am

    Please, correct the URL under “operations console” from “mailto:http://support.dooblo.net/entries/30892072-Managing-Project-Data-and-Operations

    • July 23, 2015 at 1:12 pm

      Thanks Mikhail,
      This was corrected.
      Ofer

  2. MIkhail
    July 23, 2015 at 1:00 pm

    Hi Team,
    It will be interesting to be able to request a statistics of a Surveyor usage to identify Surveyors which are not used for a long time (or never) – to reduce the list of them.

    What do you think?

    • July 23, 2015 at 1:13 pm

      Hi Mikhail,
      Yes, this is a good report to have. I have added a request to add this to the product.
      Many thanks,
      Ofer

  3. May 3, 2016 at 2:29 pm

    Is it possible to develop plugin on surveyToGo, in a project ?

    • May 3, 2016 at 5:42 pm

      Hi,
      If you incorporate calls to the REST API in your project you will be able to develop an app / plugin that connects with SurveyToGo. Please send any specific questions to support@dooblo.com
      Regards,
      Ofer

  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: