How to obtain the logged-in Client and logged-in user
To obtain the logged-in Partition- and logged-in user, please make an authentication request using OAuth with response_type=code. After that, obtain the AccessToken using Token API.
※ Please note that you cannot obtain logged-in information with response_type=code_direct.
※ When making a request with response_type=code, the browser will check whether it is logged into PORTERS (if not logged in, it will prompt to log in to PORTERS, and after logging in, it will redirect to the Redirect URL). At that time, the code will be returned in the URL parameter.
Example: Response when the Redirect URL is "https://www.porters.jp/"
https://www.porters.jp/?response_type=code&code=a1b2c3d4e5f6g7h8i9…
- To check which PORTERS environment is being accessed, use Partition Read.
By specifying request_type=0 , you can obtain information about the logged-in Partition.
- To check which user is accessing, use User Read.
By specifying request_type=0 , you can obtain the logged-in user.
OAuth Parameter: state
When performing OAuth with response_type=code, you can specify any value for the Parameter "state".
Then, when redirecting to the URL specified in "redirect_url", the content of "state" can be carried over.
Example: Specifying the resume ID in state when accessing the app from PORTERS Resume Action Menu
https://{Request Host}/v1/oauth?app_id=[value]&redirect_url=[value]&response_type=[value]&scope=[value]&state=resumeid:10001
Response from Oauth for the above
https://www.porters.jp/?response_type=code&code=3baa1ddd071492e3eea056b36ffb0e81&state=resumeid:10001
※ In PORTERS, you can create any Action Menu.