Presentation is loading. Please wait.

Presentation is loading. Please wait.

Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 1.

Similar presentations


Presentation on theme: "Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 1."— Presentation transcript:

1 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 1

2 2 Safe Harbor Statement The following is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracles products remains at the sole discretion of Oracle.

3 Powered by Automation Strategies with the Eloqua API An Oracle | Eloqua Power Hour

4 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 4 Presenters T.J. Fields – Oracle | Eloqua, Senior Product Manager Chris Campbell – Oracle | Eloqua, Senior Product Manager

5 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 5 Power Hour Agenda First, Some Background A Closer Look Using Eloquas RESTful APIs Where to find information

6 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 6 In the beginning Eloquas first public API 2008 Basic entity CRUD operations Bulk operations (DTS)

7 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 7 Extending the marketing automation system Step-based Apps (Cloud Connectors) SOAP API Cloud Connectors Perform external operations on campaign members

8 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 8 Time for REST Application API SOAP API Cloud Connectors Application API 2008 Built for E10 Asset & Data Access Real time! 2014

9 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 9 Scale It… Bulk API 1.0 SOAP API Cloud Connectors Application API Bulk API Simple Scalable Complete 2014 RESTful APIs

10 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 10 Activities Anyone? Bulk API 2.0 Retrieve Activity Data Enhanced Filtering capabilities offers more customized datasets Access to import errors in the staging area SOAP API Cloud Connectors Application API Bulk API 1.0 Bulk API RESTful APIs

11 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 11 A Closer Look

12 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 12 API Uses Integration with external systems Build Cloud Apps – appcloud.eloqua.com Solve more complex use cases Perform specific, repeatable tasks or functions Many possibilities

13 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 13 Eloquas APIs 13 Protocol for exchanging data relies on XML. Eloqua's SOAP API has been available since 2008 (primarily used with the E9 platform) SOAP Web services Single record create/update and multiple record retrieval Data and asset creation available E10 is built using this API Direct Access Web services Designed to handle large volumes of records Import/export of Data Contacts, Custom Objects, Activities, Cloud Connectors Bulk

14 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 14 Eloquas APIs SOAP APIs (v1 – 1.2) – Maintenance only, heavily used Direct Access RESTful APIs – Broad access to most of Application Bulk Access RESTful API – access to a subset of the system Current Status Consumers 3 rd Party Apps & Integrations – CRM Integration Eloqua Apps – E10, Mailer, EPP AppCloud Apps

15 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 15 Using Eloquas RESTful APIs

16 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 16 Uri Format https:// /api/ / / [/ ][/child resource>][/ ][?parameters] All endpoints in a given API will have the same root/base Uri (not including host). https://secure.eloqua.com/api/bulk/1.0 An example of the format in use is: https://secure.eloqua.com/api/bulk/1.0/contact/lists?page=2&pageSize=50 An example with child resources: https://secure.eloqua.com/api/bulk/1.0/customObject/5/field/6 Eloqua REST APIs

17 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 17 Authenticate – Determine endpoint from Eloqua API (https://login.eloqua.com/id) – Basic HTTP authentication or OAUTH Construct object – Needed for POST, PUT – Not needed for GET, DELETE Call the API endpoint – /assets/contact/fields?depth=complete&count=1&page=1 – Full list of parameters: rest-api--request-url-parametershttp://topliners.eloqua.com/community/code_it/blog/2012/09/27/eloqua- rest-api--request-url-parameters Read response (next slide) REST API: Process Overview 17

18 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 18 {"elements": [ {"type":"ContactField", "id":"100001", "createdAt":" ", "depth":"complete", "name":" Address", "updatedAt":" ", "updatedBy":"8", "dataType":"text", "displayType":"text", "internalName":"C_ Address", "isReadOnly":"false", "isRequired":"false", "isStandard":"true", "isAccountLinkageField":"false", "isPopulatedInOutlookPlugin":"false", "updateType":"always" }, {"type":"ContactField", "id":"100002", "createdAt":" ", "depth":"complete", "name":"First Name", "updatedAt":" ", "dataType":"text", "displayType":"text", "internalName":"C_FirstName", "isReadOnly":"false", "isRequired":"false", "isStandard":"true", "isAccountLinkageField":"false", "isPopulatedInOutlookPlugin":"false", "updateType":"newNotBlank" },... REST API: Response (JSON) 18

19 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 19 Common Patterns CRUD support using POST, GET, PUT and DELETE – POST /contact/import – GET /contact/import/5 – PUT /contact/import/5 – DELETE /contact/import/5 Search using GET with plural resource – GET /contact/imports?page=2&pageSize=50&search=name=a*&orderBy=n ame%20ASC Eloqua REST APIs POST Tunneling available with X-HTTP-Method-Override header

20 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 20 Partial Requests depth – Minimal/partial/complete fields – Json syntax fieldsUri – Persisted fields value, for re-use Eloqua REST APIs

21 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 21 Response Codes & Errors Status Codes – 2XX for success (200/201/204) – 4XX for client resolvable error (400/401/403/404/409/412/413) – 5XX for server error (500/503) Error Responses – Path to invalid Field – Invalid value – Failed constraint text Eloqua REST APIs Status Code Tunneling available with X-HTTP-Status-Code-Override header { "failures": [ { "field": "destinationUri", "value": "/contact/list/ ", "constraint": "Must reference an existing item, by uri." } ] }

22 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 22 Async Processing (Bulk API) Import Flow – Create Import definition – POST data to staging area – Create sync task & monitor Export Flow – Create Export definition – Create sync task & monitor – GET data from staging area Eloqua REST APIs Staged data access

23 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 23 Where to find information

24 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 24 Code It Eloquas Developer Community

25 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 25 Thank you and Questions…

26 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 26

27 Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 27


Download ppt "Copyright © 2013, Oracle and/or its affiliates. All rights reserved. 1."

Similar presentations


Ads by Google