Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

  • Endpoints
    • /api/1/feedback/given
    • /api/1/feedback/received
    • /api/1/feedback/shared
    • /api/1/feedback/notes

Query Parameters

These REST APIs follow the same structure that is displayed within the app under 'My Feedback' page.

 
ParameterDescription Input ParameterInput type
perspectiveThis is a mandatory parameter that needs to be used after UpRaise key. This parameter provides the data from the specific user's perspective. 

Jira Userkey

(If the username has changed, you will need to use the original username)

String
startAtThe index of the first item returned in the page of results.Start record fromInt
maxResultsThe maximum number of feedback per request. Default maxResults is 20 and maximum limit is 50 per request.Max results on pageInt
creatorGet feedback by creators. You can retrieve data by using a comma-separated list of multiple creators. UsernameStrand
isLastIndicates whether the page returned is the last one (Optional).End record atInt
receiverGet feedback by receivers.You can retrieve data by using a comma-separated list of multiple receivers. usernameString
resourceYou can search for feedback shared on Jira issue/s. You can retrieve data by using a comma-separated list of multiple Jira issue ids. Jira issue IDString
labelRetrieves classified feedback on the basis of given label ids. Label ids are exposed in JSON, can be picked up from there and used in the APIs. You can retrieve data by using a comma-separated list of multiple label ids. IdInt
tagRetrieves feedback classified on the basis of given tag ids. Tag ids are exposed in JSON, can be picked up from there and used in the APIs. You can retrieve data by using a comma-separated list of multiple tag ids. IdInt
fromRetrieves data from a specific date.DateDate (only dd/mmm/yy or dd/mmm/yyyy)
toRetrieves data to a specific date.DateDate (only dd/mmm/yy or dd/mmm/yyyy)
toModifiedRetrieves data modified/edited to a specific date.DateDate (only dd/mmm/yy or dd/mmm/yyyy)
fromModified

Retrieves data modified/edited from a specific date.

DateDate (only dd/mmm/yy or dd/mmm/yyyy)

All the parameters are case sensitive. 

Super admin view

Employee Success has a super admin view option on my feedback page >> shared tab. To make use of super admin view use following API and its parameters from the table. 

  • /api/1/feedback/shared
ParameterDescription Input ParameterInput type
SuperAdminViewRetrieves data from super admin view available on shared tab withing my feedback page of Employee Success. true / falseboolean

Along with these parameters, you need to use the Employee Success API authentication key that is available from the app. Read How to access API authentication key from Employee Success?

How to use these APIs?

Programmatically hit the API endpoints with valid & correct data, the server should return data in JSON format.

https://atlassian-connect.upraise.io/api/1/feedback/given?key=<yourkey>&perspective=<youruser>&SuperAdminView=True

Note that, all APIs have been written to replicate behavior of the actual app.

Recommendation -

Following steps will get all your company data (for Continuous feedback) from Employee Success. You can store it in your own DB & then do the processing.

  • Use 'shared' api end point
  • Use perspective of a super admin user
    • Make sure that this super admin has not given any feedback (otherwise they will not be available in the results)
  • Set super admin view as true
  • Use modified date query parameter to limit the result set

Response Data

Respons JSON
{ "id":2689,
            "message":"Pornima,\r\n\r\nGlad to see that you have picked up the ARN cloud development fairly quickly. In a short span of time, you've become a reliable & go-to person for ARN. \r\nHope to see you get better as you learn more about the product & the relevant frameworks.\r\n\r\nBest,\r\nAnand",
            "creator":"anand@amoeboids.com",
            "receiver":"pornima",
            "sharedWith":"All Users",
            "feedbackTag":{  
               "id":71,
               "name":"Fantastic work",
               "description":"High quality performance that sets the high benchmark for others."
            },
            "labels":[  
               {  
                  "id":1995,
                  "name":"commitment"
               }
            ],
            "resource":null,
            "feedbackUserSharing":null,
            "feedbackTeamSharing":[  

            ],
            "created":"2018-05-30T04:31:35 +0000",
            "modified":"2018-05-30T04:31:35 +0000"
         }


ParameterDescription Input ParameterInput type
totalThe total number of items retrieved. Total number of feedbackInt
id

This parameter receives feedback id or label id depending on the other parameters. 

Feedback id or label idInt
messageThe message shows the entire text message shared as a feedback. Message as a feedback. Unstructured data
sharedWithIn Employee Success, there are three options for feedback sharing, all users, shared with the team and shared with users. This parameter returns the type of visibility. Feedback visibility typeString
feedbackUserSharingType of feedback visibility option. Feedback visibility typeString
feedbackTeamSharingType of feedback visibility option. Feedback visibility typeString
nameThe name parameter is used for the label name, tag name. tag/label nameString
typeJira issue type, when feedback is shared for a Jira issue.Jira issue typeString



On this page



In this section

Unable to render {children}. Page not found: REST APIs For Employee Success Cloud Version.


  • No labels