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.

Similar Messages

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?

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

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

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

Problem Direct Entitlement

Hi everyone
i’m developing dps direct entitlement and was having a problems
I've followed the tutorial for the testing of direct entitlement on adobe tv
all according to those in the tutorial adobe tv, start from signinwithcredentials, entitlement and verifyEntitlement
The following result
but when i test on my android app can’t log in and there is an error “that username and password did not work. Double check them and try again.”
why it could happen? and please give a solution

Did you register your integrator ID with Adobe? I suggest you call enterprise support for assistance, they're good at tracking down problems with entitlement server implementations.
Neil

Direct entitlement on Android devices - DPS App Builder

Hi,
We already have a direct entitlement application based on Adobe DPS - Library and Store SDK published to the Apple Store. This application works perfectly. I needed to build this same application for android devices and upload to the google play store.
If I choose iOS as my target device in the Adobe DPS App Builder then I select Multi Folio with Entitlement as App type under the Entitlement Details I can set our custom Entitlement server as Service URL.
But if I choose Android as target device, there are no option to set the custom Entitlement server so if I build the application and test on the Android tablet the application shows all the folios as it has no connection with our entitlement server.
Thank you for your answers,
Peter

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.

How can I replace an existing app on iTunes that was created with PhoneGap to a new version created with Adobe DPS? I get a 'supported devices' error message when I try to upload to iTunes! HELP!

I created an app using PhoneGap a couple of months ago, and have now just amended it using Adobe DPS. But when I come to upload it to iTunes, I get the error message "This bundle does not support on or more of the device supported by the previous app version" How can I correct this?

I suspect your PhoneGap app was flagged as running on both iPad and iPhone. You'll need the same from DPS. You can do this in AppBuilder at the start of the wizard where it asks what kind of devices you want to support. Note that this is only available to DPS Professional and Enterprise customers. If you are a Creative Cloud customer building a Single Edition application it will only support iPad.
Neil

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

Adobe DPS - using video

I am trying to set up an FAQ page with a list of questions on the left which activate videos that appear in the same frame area on the right. I’ve uploaded the video as an object state, and used the button to activate and play the relevant video/state. It works ok in the SWF preview, but crashes InDesign everytime I attempt to upload it as an article. can anyone help me?

Having spent quite a bit of time scratching my head and googling i ended up finding the answer to this myself - so i thought i best post it to help others out.
What i could not comprehend was why a functioning backbone example on the ipad could not be directly copied across to work on the android device - what transpired was that the backbone example was using an older version of the AdobeLibraryAPI - taken from Derek Lu articles (from a few years ago) whilst the Angular version was using the most up to date version of the AdobeLibraryAPI. I found this mentioned and explained on another forum post:
https://forums.adobe.com/thread/1622729
so i went to Adobe DPS - Library and Store SDK 2.32 : Class Index : JsDoc Reference and got the latest version of the API, swopped it out and hey presto the backbone version now works on the android.

Adobe DPS Android custom viewer using Angular

Hi
I have recently developed a custom viewer app for the ipad using the excellent articles and code examples that Derek Lu provided.
This app used backbone as the MVP framework and communicated with Adobe DPS to retrieve folios and information using the provided API.
I have now been tasked with developing a similar version for the Android device and have been able to get hold of example code for the Android device from.
https://www.dpsapps.com/dpsapps/store_configurator/
However this code uses Angular as the MVP framework instead of Backbone - whilst i appreciate there are going to be device specific differences between the IPad and Android which will impact on what can / cannot be done on Android, i wondered if there was any particular reason why the code example for the Android viewer uses Angular over Backbone?
I was hoping to be able to leverage the Backbone code written for the IPad version but when i try to put this on the Android device i seem to recall it either not allowing me (when using the webbuilder) or that nothing seemed to work / appear on the device, whilst the Angular version (freshly downloaded and unchanged - but configured to bring down my folios with the relevant guid) from the dps app store configuration link (provided above) does work.
Additionally i seem to be unable to test the Android Angular version on my desktop in the same way i was the backbone version.
Has anyone else encountered similar problems?
Thanks
Dave

Having spent quite a bit of time scratching my head and googling i ended up finding the answer to this myself - so i thought i best post it to help others out.
What i could not comprehend was why a functioning backbone example on the ipad could not be directly copied across to work on the android device - what transpired was that the backbone example was using an older version of the AdobeLibraryAPI - taken from Derek Lu articles (from a few years ago) whilst the Angular version was using the most up to date version of the AdobeLibraryAPI. I found this mentioned and explained on another forum post:
https://forums.adobe.com/thread/1622729
so i went to Adobe DPS - Library and Store SDK 2.32 : Class Index : JsDoc Reference and got the latest version of the API, swopped it out and hey presto the backbone version now works on the android.

Can you move a magazine app designed by another company to Adobe DPS?

My company had a digital company (who shall remain nameless) produce their magazine app under the (digital company's) information. I want to transfer everything over to Adobe DPS because frankly, this digital company did not live up to their promises, have terrible customer service, and are strictly just adding buttons to a pdf (not interactive at all). With that said, do I need to start from scratch and build a new app? Or can I just obtain the app that's already been created? If not, do I just tell the other company to delete our app? Thanks!

If you move to DPS you'll wind up building a new application using our tools and submitting that to Apple as an update to the existing application. Your readers will see an update to the app and when they download it they'll have the new version.
What is more complicated to sort out is whether readers would still be entitled to content they'd previously purchased. That depends a lot on you previous setup, how the previous product handled purchases, etc.
Neil

Adobe DPS: Direct Entitlement API Version 2

Similar Messages

Maybe you are looking for