Introduction to the Subscribe-HR RESTful API

From Subscribe-HR Wiki Help
Jump to: navigation, search
(Created page with '{{page.name: Integration Module: Introduction to SOAP and Practical Examples - Subscribe-HR Wiki}} {{page.head: Introduction to SOAP API}} Tips and tricks, troubleshooting steps…')
 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{page.name: Integration Module: Introduction to SOAP and Practical Examples - Subscribe-HR Wiki}}
+
{{page.name: Integration Module: Introduction to the Subscribe-HR RESTful API - Subscribe-HR Wiki}}
{{page.head: Introduction to SOAP API}}
+
{{page.head: Introduction to the Subscribe-HR RESTful API}}
 
+
Tips and tricks, troubleshooting steps and other information for Integration with Subscribe-HR Software.
+
<br>
+
Subscribe-HR delivers Simpler Recruitment and HR Systems, On-Demand.
+
  
 
__TOC__
 
__TOC__
  
==Introduction to SOAP==
 
*[[Introduction to SOAP|Introduction to SOAP and Practical Examples]]
 
  
==Getting Started with the API==
 
*[[Authenticating|Authenticating]]
 
*[[Querying|Querying]]
 
*[[Upsert|Update and Insert]]
 
  
==Finding the Gateway and WSDL URLs==
+
=RESTful API=
 +
 
 +
Subscribe-HR API or SAPI for short is the primary way to get data out of, and put data into, the platform. It's an HTTP-based RESTful API that you can use to query, create, update and delete entities within Subscribe-HR. All the supported operations are outlined on apiary at the following link http://docs.subscribehr.apiary.io
 +
 
 +
==SHaRpi Integration Module==
 +
 
 +
The Integration Module provides a front-end configurable interface for setting up integrations using the RESTful API. Additional documentation can be found here: http://subscribehr.readthedocs.io/en/latest/sharpi.html
 +
 
 +
It contains the following two sections:
 +
 
 +
==Processes==
 +
 
 +
The Processes page allows you to define your JSONpath configuration file. There are 2 available tabs for this:
 +
# Configuration: This tab holds the configuration file to be edited. The configuration file process can be run from here.
 +
#*Run Processes: This will run the process currently loaded, hoever please note, the record needs to be saved and validated before running the process. Running process before saving it will execute previous version of configuration file.
 +
# Events: This tab holds the log of events that occur when running the process.
 +
 
 +
==Fields==
 +
<table border="1" width="700" id="table1" cellspacing="1">
 +
<tr>
 +
<td width="150"><b><font face="Arial" size="2">Field Name</font></b></td>
 +
<td width="550"><b><font face="Arial" size="2">Description</font></b></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Name</font></td>
 +
<td width="550"><font face="Arial" size="2">The name that will be assigned to the saved process</font></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Last Executed</font></td>
 +
<td width="550"><font face="Arial" size="2"> The last time the process was run</font></td>
 +
        </tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Last Successful Execution</font></td>
 +
<td width="550"><font face="Arial" size="2"> The last time process has completed successfully</font></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Enable Scheduler</font></td>
 +
<td width="550"><font face="Arial" size="2">Enable scheduler to run the process on predefined interval</font></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Interval</font></td>
 +
<td width="550"><font face="Arial" size="2">Scheduler interval - must be a whole number e.g. 10 minutes</font></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Units</font></td>
 +
<td width="550"><font face="Arial" size="2"> Interval units e.g. minutes, hours, days etc.</font></td>
 +
</tr>
 +
<tr>
 +
<td width="150"><font face="Arial" size="2">Start Date</font></td>
 +
<td width="550"><font face="Arial" size="2">Date when scheduler will become active.</font></td>
 +
</tr>
  
===The WSDL URL===
+
</table>
https://www.subscribe-hr.com/cb/app/hr/misc/?request=wsdl
+
===The Gateway URL===
+
https://www.subscribe-hr.com/cb/app/general/gateway
+
  
==Application Integration Support==
+
==Authentication==
* [[Subscribe-HR_Data_Integration|Getting Started with Application Integration]]
+
  
==Videos==
+
The Authentication records provide a record that can be referenced in your configuration Processes record. This authentication record holds the access tokens and keys depending on the authentication type.
*[[Subscribe-HR_HR_SaaS_Introduction|Subscribe-HR HR SaaS Introduction]]
+
*[[SaaS_Design_Layout_and_Key_Features_Overview|SaaS Design Layout and Key Features Overview]]
+
*[[Subscribe-HR_Security_Overview|Subscribe-HR Security Overview]]
+
*[[Developer_Module_Overview_Video|Developer Module Overview]]
+
  
==Troubleshooting and Problem Resolution==
+
The following fields are available:
*[[Contacting_Subscribe_HR|Contacting Subscribe-HR]]
+
* '''Type''': Determines the type of authentication. Options are: '''OAuth2.0''' and '''Authorization Header'''.
<br>
+
* '''Name''': The name of the integration.
<br>
+
* '''Grant Type''': The Authorisation grant type.
 +
* '''Client ID''': A field for the string that identifies the Client to be entered.
 +
* '''Client Secret''': An encrypted field for holding a key belonging to the client.
 +
* '''Refresh Token''': An encrypted field for holding the refresh token response after making a call.
 +
* '''Access Token Expiry''': The date and time the Access toekn expires.
 +
* '''Refresh Token Expiry''': The date and time the refresh token expires.
 +
* '''URL''': The initial URL that the authorisation is sent to.
 +
* '''Scope''': The scope of the access for the integration.
 +
* '''Access Token URL''': The inital URL the access token is sent to.
 +
* '''Request Parameters''': The parameters for SHaRpi to request new tokens.
 +
* '''Header Name''': The name of the Authorization Header.
 +
* '''Authorisation Method''': The method of Authorisation used by the header.
  
 
[[File:subscribehr_logo.gif]]
 
[[File:subscribehr_logo.gif]]

Revision as of 02:23, 13 February 2019


RESTful API

Subscribe-HR API or SAPI for short is the primary way to get data out of, and put data into, the platform. It's an HTTP-based RESTful API that you can use to query, create, update and delete entities within Subscribe-HR. All the supported operations are outlined on apiary at the following link http://docs.subscribehr.apiary.io

SHaRpi Integration Module

The Integration Module provides a front-end configurable interface for setting up integrations using the RESTful API. Additional documentation can be found here: http://subscribehr.readthedocs.io/en/latest/sharpi.html

It contains the following two sections:

Processes

The Processes page allows you to define your JSONpath configuration file. There are 2 available tabs for this:

  1. Configuration: This tab holds the configuration file to be edited. The configuration file process can be run from here.
    • Run Processes: This will run the process currently loaded, hoever please note, the record needs to be saved and validated before running the process. Running process before saving it will execute previous version of configuration file.
  2. Events: This tab holds the log of events that occur when running the process.

Fields

Field Name Description
Name The name that will be assigned to the saved process
Last Executed The last time the process was run
Last Successful Execution The last time process has completed successfully
Enable Scheduler Enable scheduler to run the process on predefined interval
Interval Scheduler interval - must be a whole number e.g. 10 minutes
Units Interval units e.g. minutes, hours, days etc.
Start Date Date when scheduler will become active.

Authentication

The Authentication records provide a record that can be referenced in your configuration Processes record. This authentication record holds the access tokens and keys depending on the authentication type.

The following fields are available:

  • Type: Determines the type of authentication. Options are: OAuth2.0 and Authorization Header.
  • Name: The name of the integration.
  • Grant Type: The Authorisation grant type.
  • Client ID: A field for the string that identifies the Client to be entered.
  • Client Secret: An encrypted field for holding a key belonging to the client.
  • Refresh Token: An encrypted field for holding the refresh token response after making a call.
  • Access Token Expiry: The date and time the Access toekn expires.
  • Refresh Token Expiry: The date and time the refresh token expires.
  • URL: The initial URL that the authorisation is sent to.
  • Scope: The scope of the access for the integration.
  • Access Token URL: The inital URL the access token is sent to.
  • Request Parameters: The parameters for SHaRpi to request new tokens.
  • Header Name: The name of the Authorization Header.
  • Authorisation Method: The method of Authorisation used by the header.

Subscribehr logo.gif