Core Capture Services REST API Authentification

A_N · January 19

Hi,
We are trying to implement the Core Capture Services REST API(https://developer.opentext.com/imservices/products/captureservice/apis/captureservice), but I am having a hard time putting it in place.
I am trying to make calls to the Core Capture Services REST API via Postman to our development server.
Some calls were not secured, so I was able to get an answer, but for others I received an 401 error.
GET {{host}}/cp-rest/about?suppress_response_codes=suppress_response_codes
and I get



{

"returnStatus": {

"status": 401,

"substatus": 0,

"code": "ER8012",

"message": "[M8012] La demande a été rejetée en raison d'un ticket de session d'authentification non valide ou ayant expiré.",

"server": "WI"

}

}

I would like to know how I can generate an OAuth2 token.
Which endpoint should be called? otds endpoint? What information is needed to be passed?
If a client-id/secret is needed, how can one be generated?

It would be greatly appreciated if you could provide any help.

Thanks.

LazarescuA · January 23

Sure:

IntelligentCapture 23.4 Installation Guide: https://webapp.opentext.com/piroot/ecpcore/v230400/ecpcore-igd/en/html/_manual.htm

IntelligentCapture 23.4 REST API Developer Guide: https://support.opentext.com/csm?id=kb_article_view&sysparm_article=KB0795917

Karen Weir · January 19

Have you had a chance to review the Authentication documentation?

https://developer.opentext.com/imservices/developertools/developeradmin/documentation/authentication/1

LazarescuA · January 19

Hello, Core Capture comes in two flavours: a SaaS application, stand alone, with UI - and as Micro Services (REST API) - no UI, just REST calls. In order to use the REST API, you will need to have a Core Capture Services subscription or a Developer Cloud Subscription (that includes Core Capture Services).

Which one do you have?

If you don't have one, you can setup your free trial on developer.opentext.com - go to Plans and create your free trial there. After that, go to the link @Karen Weir posted above and that should get you going with the authentication.

A_N · January 22

In fact, we have installed intelligent capture on our servers and we already have a web client to consume our capture flows. We saw that the webclient is making REST API calls. What we want is to be able to access that REST API through another application, such as our Postman.
The {{host}} is the URL of our on-premises server.
I found out that we need to get a token from the OTDS server in order to call the secured endpoints of the REST API, such as /session/files, etc.
The question is how to make the REST API accept the OTDS token ?
Thanks

LazarescuA · January 22

Well, this is a question for the Intelligent Capture discussion forum, but I can give you some info:

WebClient is using a trimmed down version of the IntelligentCapture REST Server. In order to use the full REST capabilities, you should have a separate license for the Intelligent Capture REST Server
Once you have that, the Installation Guide will help you with all the settings needed:
Then, the REST API developer guide will guide you through getting a new token to work: