Direct Entitlement API documentation

Hi,
My company just purchased DPS a while ago.
I'd like to ask where we can find documentation on how to integrate into the direct entitlement API's, we are planning to control access to our folios through our own authentication system.
Thank you.

I know this is an old discussion. For the sake of those searching the web and forums for answers with keywords, i'd like to update here with links to documenations and and API's
Direct Entitlement API documentation: http://download.macromedia.com/pub/developer/dps/entitlement/direct-entitlement-api.pdf
Direct Entitlement starter kit: http://www.adobe.com/devnet/digitalpublishingsuite/articles/direct-entitlement-starter-kit .html
Landing page to all entitlement related doumentation: http://www.adobe.com/devnet/digitalpublishingsuite/entitlement.html

Similar Messages

Problems with Direct Entitlement API ( problems to download the issuenumbers and others)

Hi there.
Here we are using the last version of Direct Entitlement API , we had download on this url : http://www.adobe.com/devnet/digitalpublishingsuite/articles/direct-entitlement-starter-kit .html
But We are getting some problems
With https://dev01.cartacapital.com.br/adobe/api/entitlements.php?authToken=0fc82ad9b9c11703ad5 c8dee47d7ee26&appVersion=1.3.1&appId=468573252
This api is modificated to show only the issuenumbers that I have the right to read.
I'm getting this results
<result httpResponseCode="200">
<entitlements>
<productId>com.editoraconfianca.revistacartacapital.edicao753</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao754</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao755</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao756</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao757</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao758</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao759</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao760</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao761</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao762</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao763</productId>
<productId>com.editoraconfianca.revistacartacapital.edicao764</productId>
</entitlements>
</result>
That's ok
But on my Ipad ( for testing only) , show this entitlement on a first place, on top of my screen.
1) Why does the app is showing others entitlements too, like ( com.editoraconfianca.revistacartacapital.edicao752, 751 ... ) ?
2) When I try to download all the result in my xml , is not allowed to donwload, but the ( com.editoraconfianca.revistacartacapital.edicao752, 751 ... ) is allowed to download
When I verify if I can download the issue ( https://dev01.cartacapital.com.br/adobe/api/verifyEntitlement.php?authToken=0fc82ad9b9c117 03ad5c8dee47d7ee26&appId=com.editoraconfianca.revistacartacapital&productId=com.editoracon fianca.revistacartacapital.edicao753&appVersion=1.0.34 )
show this result
<result httpResponseCode="200">
<entitled>true</entitled>
</result>
But I can't do the download.
Help Please.

There is no license or serial number for the DVD installer.
If you can get access to a Mac with a working DVD Drive, make the DVD into a .dmg file in Disk Utility and then copy the .dmg file onto a USB key and install onto your Mac from that.
Peter

Adobe DPS: Direct Entitlement API Version 2

Hi guys,
I have some questions about Direct Entitlement API Version 2 (http://download.macromedia.com/pub/developer/dps/entitlement/direct-entitlement-api.pdf). Based on the API, SignInWithCredentials and entitlements request body will contain a XML document which contains information like email address, passwords, product IDs and cover dates. I'm able to get the email address and password from the parameter but I could not retrieve the product IDs and cover dates at all. Is it because we do not have a valid Integrator ID from Adobe yet?
Any help would be greatly appreciated.
Thank you.
Regards,
Gary.

Yes, I understand that I need to create a web services for these URLs. My main concern is how can I use Direct Entitlement API Version 2 in Sprint 26 only.
I have listed out the major differences between API version 1 and API version 2. I have also list out how I retrieve the data from my web services.
For SignInWithCredentials URL:
According to API version 1, emailAddress, password, appId, appVersion and uuid are passed in the queries using HTTP GET method. But in API version 2, emailAddress and password are in the request body as a XML document using HTTP POST method.
I built my app in Sprint 26 but I retrieved the emailAddress, password, appId, appVersion and uuid using HTTP GET methods only. My request body and HTTP POST methods are both empty.
For entitlements URL:
According to API version 1, the transaction must be done by HTTP GET method. It does not provide folios' product ID and cover date either. But in API version 2, the transaction must be done by HTTP POST method and it will provide folios' product ID and cover date in the request body as a XML document.
I built my app in Sprint 26 but I retrieved the authToken, appId and appVersion using HTTP GET method only. My request body and HTTP POST method are both empty.
It seems that in my app is still using API version 1. How can I use API version 2 for my app in Sprint 26?
You can get both API version from these links:
API version 1: http://download.macromedia.com/pub/developer/dps/entitlement/Entitlements_API.pdfAPI version 2: http://download.macromedia.com/pub/developer/dps/entitlement/direct-entitlement-api.pdf
Thank you.
Regards,
Gary.

Direct Entitlement API

Hi,
I've created a web service based from the direct entitlement api v2 - http://download.macromedia.com/pub/developer/dps/entitlement/direct-en titlement-api.pdf
Based from my testing, it passed the specification based from the API document.
All methods were created. The service is a .net web service (.asmx) and methods are below.
https://<website>/dps/entitlement.asmx/verifyEntitlement
https://<website>/dps/entitlement.asmx/SignInWithCredentials
https://<website>/dps/entitlement.asmx/RenewAuthToken
https://<website>/dps/entitlement.asmx/entitlements
What Service URL/Service Auth URL should I be using? I tried using https://<website>/dps/entitlement.asmx/ (with slash) and https://<website>/dps/entitlement.asmx (no slash) but both are not working.
Is there a way I can troubleshoot, like seeing what code from the dps app is consuming the web service to know if it really can connect to the service or see what error might be there?
Thanks!

Thanks for all replies. I was able to figure out what's causing the error using Charles proxy tool. Looking at the errors, pointed me to the issue of the integrator version. I just created the service having the specifications mentioned in the latest version of the integrator. The latest integrator details can be found here (direct-entitlement-api.pdf) - http://www.adobe.com/devnet/digitalpublishingsuite/articles/dps-entitlement.html
This issue is closed.

How to get "Request Body" in Direct Entitlement API ?

According to the API version 2 (http://download.macromedia.com/pub/developer/dps/entitlement/direct-entitlement-api.pdf), it said the Request Body contain the following xml document specifiying the user credentials
<credentials>
 <emailAddress>[email protected]</emailAddress>
 <password>stupid</password>
</credentials>
How can I get this xml in PHP? e.g. $_POST['credentials'] or somthing else?

And also this xml inside "/entitlements":
Request Body: The request should contain the following xml document.
<folios>
 <folio>
 <productId>com.bonnier.flying.10.01.2010</productId>
 <coverDate>2011-10-11T20:49:40Z</coverDate>
 </folio>
 <folio>
 <productId>com.bonnier.flying.11.01.2010</productId>
 <coverDate>2011-11-11T20:49:40Z</coverDate>
 </folio>
</folios>
Or how can I get testing requests from Adobe for the API development?

Direct Entitlement API - passing error code

Hi,
I'm trying to implement login API in our DPS application. I can see that there is a possibility to provide an errorCode in the SignInWithCredentials action.
Error Results:
HTTP 401 Unauthorized
Body:
<result httpResponseCode=”401” errorCode=””/>
How can I read this error code on the app side (in login action from adobeDPS.authenticationService.login(username.val(), password.val()); ) ?
Will it be available in the error field of this transaction ?
Or I should retrieve it some other way ?
I need this error code to show revelant message to the user that din't succeed to log in.
regards,
Piotr

But I get -150 (TransactionAuthenticationUnrecognizedCredentialsError) no matter what errorCode i set in the XML response.
And I'd like to get the error code which I've set on the server.
Can I pass a custom code there somehow ?
Or I need to set the error code to one of the values from that list ?
Adobe DPS - Library and Store SDK 2.32 : adobeDPS-TransactionErrorType : JsDoc Reference

Entitlement API Call as GET Docs State POST

Hello,
I am integrating the Entitlement API for our DPS apps and came into this problem. According the the docs here:
http://download.macromedia.com/pub/developer/dps/entitlement/direct-entitlement-api.pdf
The 'Get Entitlements' call states that it is done via POST but yet my server receives the request as GET and therefore do not have access to the XML in the body of the request that contains the list of folios.
When building the app with the DPS App Builder I enter the value 'starterkit' as the Integrator ID. I'm not sure if this could be the reason for this behavior.
Has anyone experienced this or have any ideas?
Thank You

I have chnaged my code to
ReportRequest req = new ReportRequest();
req.setAttributeTemplate("Letter v1.0.rtf");
req.setAttributeFormat("pdf");
req.setAttributeLocale("en-US");
req.setReportAbsolutePath("/Shared Folders/Test/Letters");
// issue the reques
ReportResponse reportResp = (ReportResponse) call.invoke(
new Object[] {req, "weblogic", "oracle123"} );
System.out.println("Return ReportResponse: ContentType = " + reportResp.getReportContentType());
It throws
PublicReportService::generateReport failed: due to oracle.xdo.servlet.CreateException: Report definition not found:/Shared Folders/Test/Letters
In the BIP I have uploaded templated and mapped to dataset /Shared Folders/Test/Letters/Letter v1.0.rtf
Please advice me what must be the setReportAbsolutePath and setAttributeTemplate?

Your Direct Entitlement Service Exception

Dear All,
I have the problem with Entitlement Server.
i was read the tutorial : Your Direct Entitlement Service | Adobe Developer Connection and test it with : Digital Publishing Suite Help | Test your Direct Entitlement API V2
This is the result :
https://www.anakku.id/V2/api/entitlements?uuid=postman&appId=net.anakku.majalah&appVersion =0.1&authToken=54196d77d45c10b…
<result httpResponseCode="200">
<entitlements>
<productId>net.anakku.majalah.mediakit1</productId><productId>net.anakku.dps_retail</productId>
<productId>net.anakku.majalah.perdana.iphone</productId>
<productId>net.anakku.majalah.mediakit</productId>
</entitlements>
</result>
And if i test wiht verifyEntitlement :
 
Fatal error: Uncaught exception 'Exception' with message 'String could not be parsed as XML' in /home/anakku/public_html/V2/api/verifyEntitlement.php:62
Stack trace:
#0 /home/anakku/public_html/V2/api/verifyEntitlement.php(62): SimpleXMLElement->__construct('')
#1 {main}
thrown in
/home/anakku/public_html/V2/api/verifyEntitlement.php on line
62
 
Fatal error: Uncaught exception 'Exception' with message 'String could not be parsed as XML' in /home/anakku/public_html/V2/api/verifyEntitlement.php:62 Stack trace: #0 /home/anakku/public_html/V2/api/verifyEntitlement.php(62): SimpleXMLElement->__construct('') #1 {main} thrown in/home/anakku/public_html/V2/api/verifyEntitlement.php on line 62
verifyEntitlement
(Method:GET)
https://anakku.id/V2/api/verifyEntitlement?uuid=postman&appId=net.anakku.majalah&appVersio n=0.1&authToken=54196d77d45c10…
Result:
 
Fatal error: Uncaught exception 'Exception' with message 'String could not be parsed as XML' in /home/anakku/public_html/V2/api/verifyEntitlement.php:62
Stack trace:
#0 /home/anakku/public_html/V2/api/verifyEntitlement.php(62): SimpleXMLElement->__construct('')
#1 {main}
thrown in /home/anakku/public_html/V2/api/verifyEntitlement.php on line 62 
Whats wrong in this framework or configuration ?
Thanks
Message was edited by: HARDIONO PUSPONEGORO

When you did the test call for verifyEntitlement did you correctly include proper XML? That exception is saying the XML you sent wasn't valid.
Neil

V25 and Direct Entitlement

We have 15 apps in the app store using direct entitlement and it has been working well for over a month.
In testing some upgraded versions using v25 in the App Builder, those apps seem to be unable to Sign In.
Have there been changes to the Entitlement API? If so, where can I find documentation on those changes?
UPDATE: Never mind. User error on our part. v25 is fine in this respect.

Please check the difference between the Android and iOS Entitlement Application details. Where can I set the entitlement server on the Android application? On iOS it is the 'Service URL'. Thanks.

Online Javascript API Documentation??

Where is the online Javascript API Documentation? This link has been broken for over two weeks:
http://livedocs.adobe.com/acrobat_sdk/11/Acrobat11_HTMLHelp/wwhelp/wwhimpl/js/html/wwhelp. htm?href=JS_Dev_Overview.71.1.html&accessible=true
If this information has moved can someone point me in the right direction?
thx
PP

Thanks Gilad--
I didn't think to check the downloads--thanks for that tip.
Do you know if the online documentation will return?
thx
PP

Where's the Oracle Forms Java API documentation for 11g?

Hi,
Can anyone point me in the direction of the Oracle Forms Java API documentation?
The only thing I can find is this: http://www.oratransplant.nl/1012jdapiDoc/oracle/forms/jdapi/JdapiModule.html but this seems to be for 10.1.2 and it doesn’t correspond to the version I’m using (11.1.1.3).
Help appreciated,
Donal.

i couldn't find the api either however if you implement the class you will simply get compiler errors explaining what you left out.

Direct path api ?

Hi,
how can I use the direct path api to speed up the unload tables
process. export uses it so there IS a direct path api.
Can we use it, were is it documented, is it valid for 7.3.4 as
wel as for 8 ?
thanks for the input,
Ronald.
null

Do you have support.oracle.com access?
If you check the Ora-600 lookup tool it seems that there are various known oracle bugs that cause this error, related to the use of synonyms in the direct path loading API, or possibly to do with CLOBS over database links.
From what you've said it looks likely to be related to the use of synonyms. Oddly, it seems to be in both 10.2.0.3 and 10.2.0.5 so I'm not sure why you'd hit it on upgrade. Did you change your client side driver at the same time? or make any database changes?

Where can you find Premiere Pro api documentation(com.adobe.premiere / com.adobe.csawlib.premiere.Pr

Where can you find Premiere Pro api documentation(com.adobe.premiere / com.adobe.csawlib.premiere.Premiere) for Flash Builder / CS Extension Builder?

There is no documentation to give you. However, our Broadcast Engineering team supports panel development, for our Broadcast partners. Please write to me directly <mailto:[email protected]> describing what you'd like to build.

Direct Entitlement request form

Hi,
I've made the setup for the DPS Entitlement Server following this guide:
How to install the DPS Entitlement Server | Adobe Developer Connection
The setup_check.html page returns everything ok.
I am about to fill this form to get Adobe's feedback and my Integrator ID:
http://download.macromedia.com/pub/developer/dps/adobe_dps_direct_entitlement_request_form .pdf
Where can I send it ? to who ?
thanks a lot!

Thank you Vik,
Actually its almost impossible to contact any support by phone from here (swiss)
anyway I am lucky enought to find this post from Storycode in the morning:
Code Corner: Adventures in DPS Entitlement | Storycode
Thanks to them they explain a bit more clearly where to send this form
Once you’ve filled out the form, email it to [email protected], including the following info in the body of the message:
1. a friendly request for Direct Entitlement whitelisting
2. your Service URL
3. your Integrator ID
4. that your Direct Entitlement Server is API version 2
5. your test username and password
Hope this can help
Flo

Where to find API documentation on massage handling from Email to PDA?

Where to find API documentation on massage handling from Email to PDA? and vice versa..?

You'll have to help me understand what you want to do.
:"message handliing from e-mail to pda" doesn't mean much to me.
We prrovide ENS, which is what most folks that want notification to pda's want.

Direct Entitlement API documentation

Similar Messages

Maybe you are looking for