Logo Wocoexis

API Documentation

Starting

The use of this API is restricted to programmers and people with knowledge of RESTApi services. All of the functions implemented in this API are also available in the Web interface, so if you don’t have the technologic knowledge, you can do it by the website.

Client Email and token

To use our API, you will need an email and a token. You will only see this information in this page if you are logged with the main user of the company, do not share this information with anybody out of your organization.

Method of calling functions

Our API have a REST format, that means that it doesn’t matter the programming language you are using, the calls will be always with the next endpoint:

https://www.wocoexis.com/api/{module}/{method}

To this endpoint you will pass the incoming parameters. Our recommendation is that you always use POST method to call our endpoint, but also we support GET methods in our API.

Return values

All the calls with return the data of the response in a JSON, but also will return and http status code that you can check. There are three different codes depending of the type of response we are sending.

Return values
200 The request have process in the right way
400 Wrong request: there is something bad with your request
401 Not allowed, something wrong with your login data
500 Something is wrong in our server the we could not process your call at this time

Incoming parameters

In all the calls we recommend to send the incoming parameters with the POST method, but we also support GET method.

User methods

getAll

With this method you can get the list of all the users associated with the main user of the company

endPoint: https://www.wocoexis.com/api/users/getAll

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API

Return values

This method return a JSON with multiples registries, each one with this keys:
Name Desctiption
id Correspond to the ID of the user in our platform; you will need this ID in other cases
email Correspond to the email of the user
nombre Correspond to the name of the user
apellido Correspond to the lastname of the user
nick Correspond to the nickname of the user
nombrePantalla Correspond of how we show the user name on the screen

getByEmail

With this method you can get the data of a users associated with the main user of the company giving the email address

endPoint: https://www.wocoexis.com/api/users/getByEmail

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
email This correspond to the email of the user to get the data

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
id Correspond to the ID of the user in our platform; you will need this ID in other cases
email Correspond to the email of the user
nombre Correspond to the name of the user
apellido Correspond to the lastname of the user
nick Correspond to the nickname of the user
nombrePantalla Correspond of how we show the user name on the screen

get

With this method you can get the data of a users associated with the main user of the company giving the ID

endPoint: https://www.wocoexis.com/api/users/get

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the id of the user in our platform to get the data

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
id Correspond to the ID of the user in our platform; you will need this ID in other cases
email Correspond to the email of the user
nombre Correspond to the name of the user
apellido Correspond to the lastname of the user
nick Correspond to the nickname of the user
nombrePantalla Correspond of how we show the user name on the screen

delete

With this method you can complete delete the data of a users associated with the main user of the company giving the email address

endPoint: https://www.wocoexis.com/api/users/delete

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
email This correspond to the email of the user to delete the data

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
response Will have OK if everything was good

create

With this method you can update or create a new user associated with the main user of the company

endPoint: https://www.wocoexis.com/api/users/create

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
email This correspond to the email of the user that you want to create
name This correspond to the name of the user that you want to create
lastname This correspond to the lastname of the user that you want to create

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
userId If everything is OK, this is the ID of the user in our platform

getquestions

With this method you can get the test questions.

endPoint: https://www.wocoexis.com/api/users/getquestions

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
lang This corresponds to the language of the questions, can be for Spanish (es) or for English (en)

Return values

This method returns an XLS document (Excel) with the required information, only the yellow cells are enabled, all these cells are obligatory to answer them.

savequestions

With this method you can save the test of the users, this test is answered with the XLS (Excel) document downloaded from the getquestions method.

endPoint: https://www.wocoexis.com/api/users/savequestions

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
file This corresponds to the file downloaded from the getquestions method

Data to complete in the downloaded file

Name Desctiption
Email This corresponds to the email of the user who answers the test
Item listado You will find a list of interests only choose those 4 that most match your preference in the short future.
N° Escala Each question of the test must be answered on a scale of 1 to 5. In the file you will find the description of that scale, There are no correct and incorrect answers. We are each as we are.

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
response Will have OK if everything was good

Groups methods

getAll

With this method you can get the list of all the groups associated with the main user of the company

endPoint: https://www.wocoexis.com/api/groups/getAll

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API

Return values

This method return a JSON with multiples registries, each one with this keys:
Name Desctiption
id Correspond to the ID of the group in our platform; you will need this ID in other cases
name Correspond to the name of the group
description Correspond to the description of the group
groupId Correspond to the parent group ID in case of sub-groups

getSubgroups

With this method you can get the list of all the sub-groups of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/groups/getSubgroups

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the sub-groups

Return values

This method return a JSON with multiples registries, each one with this keys:
Name Desctiption
id Correspond to the ID of the group in our platform; you will need this ID in other cases
name Correspond to the name of the group
description Correspond to the description of the group
groupId Correspond to the parent group ID in case of sub-groups

get

With this method you can get the data of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/groups/get

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the data

Return values

This method return a JSON with single registry, with this keys:
Name Desctiption
id Correspond to the ID of the group in our platform; you will need this ID in other cases
name Correspond to the name of the group
description Correspond to the description of the group
groupId Correspond to the parent group ID in case of sub-groups

getByName

With this method you can get the data of a group associated with the main user of the company giving the name of the group

endPoint: https://www.wocoexis.com/api/groups/getByName

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
name This correspond to the group name that you want to get the data

Return values

This method in case of success return a JSON with single registry, with this keys:
Name Desctiption
id Correspond to the ID of the group in our platform; you will need this ID in other cases
name Correspond to the name of the group
description Correspond to the description of the group
groupId Correspond to the parent group ID in case of sub-groups

getUsers

With this method you can get a list of all the users of this group associated with the main user of the company giving the ID of the group

endPoint: https://www.wocoexis.com/api/groups/getUsers

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the user list

Return values

This method return a JSON with multiples registries, each one with this keys:
Name Desctiption
id Correspond to the ID of the user in our platform; you will need this ID in other cases
email Correspond to the email of the user
nombre Correspond to the name of the user
apellido Correspond to the lastname of the user
nick Correspond to the nickname of the user
nombrePantalla Correspond of how we show the user name on the screen

delete

With this method you can complete delete the data of a group associated with the main user of the company giving the ID of the group

endPoint: https://www.wocoexis.com/api/groups/delete

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the ID of the group to delete the data

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
response Will have OK if everything was good

create

With this method you can update or create a new group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/groups/create

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
name This correspond to the name of the group that you want to create
description This correspond to the description of the group that you want to create
groupId (Optional) This correspond to the parent group ID of the user that you want to create in case of a sub-group

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
groupId If everything is OK, this is the ID of the group in our platform

addUser

With this method you can add a user to a group giving the user and group ID

endPoint: https://www.wocoexis.com/api/groups/addUser

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
userId This correspond to the ID of the user to be added
groupId This correspond to the ID of the group where we goanna add the user

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
response Will have OK if everything was good

removeUser

With this method you can remove a user from a group giving the user and group ID

endPoint: https://www.wocoexis.com/api/groups/removeUser

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
userId This correspond to the ID of the user to be removed
groupId This correspond to the ID of the group where we goanna remove the user

Return values

This method return a JSON with a single registry, with this keys:
Name Desctiption
response Will have OK if everything was good

Reports

selection

With this method you can get the selection report of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/reports/selection

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the report

Return values

This method return a XLS (Excel) document with the required information

training

With this method you can get the training report of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/reports/training

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the report

Return values

This method return a XLS (Excel) document with the required information

team

With this method you can get the team report of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/reports/team

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the report

Return values

This method return a XLS (Excel) document with the required information

userPdf

With this method you can get the personal report of a user associated with the main user of the company

endPoint: https://www.wocoexis.com/api/reports/userPdf

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
email This correspond to the email of the user that you want to get the report

Return values

This method return a PDF document with the required information

team csv

With this method you can get the team report of a group associated with the main user of the company

endPoint: https://www.wocoexis.com/api/reports/teamcsv

Incoming values

Name Desctiption
emailLogin This correspond to the email of the main user of the application
token This correspond to the token to get access to the API
id This correspond to the group ID that you want to get the report

Return values

This method return a CSV (Excel) document with the required information