Request_a_User_Account

OpenBook v4 - The HarperCollins Public API for Global Products, Contributors, and more

1. Request a User Account

Following these conventions enables us to provide faster support for any issues you may encounter, so thank you for helping us serve your needs!

Click Here to request a HarperCollins API User Account

QUICK TIPS

 - Within 24 hours we will respond with an email including a link inviting you to create your account.

 - Please check your SPAM folder for your invitation is not received promptly

 - The only special character your HCP AnyPoint Account name can include is a _dash_ '-', so the User Name you select cannot include your email address due to the presence of the @ character.

User Account Naming Conventions

HarperCollins global associates:
{firstName-lastName}-{HCPGlobalOrg} e.g. Pat-Smith-HCUK
All other users or global business partners please use:
{firstName-lastName}-{yourCompanyName} e.g. Pat-Smith-harpercollinspartner

2. Requesting API Access & Creating Client Application(s)

Create Client Apps with unique ClientID and ClientSecret pairs used for OAuth 2.0 Security for generaterating the Bearer Tokens that must accompany your API requests.

Client App Naming Conventions

a9575fc0-image.png

TESTING: Please use the following naming conventions when requesting a personal client application to request access to any HarperCollins API, regardless of environment:

{firstNameInitial}.{lastName}@{companyName} e.g. j.doe@hcp

Application(s): When you begin implementing your system(s), each of your unique application(s) create a unique Client Application, even if for the same HCP API.

As the @ is supported for Client App naming, please use the following convention:

{ApplicationName}@{CompanyName}  e.g. BookIngest@Bookperkinator
In addition, each of your unique applications will require a separate Client App per runtime, typically 'QA/Test' and 'Production'.
ProductionQA / TestDev*
SalesApp-PD@MyCoSalesApp-QA@MyCoMobileApp-DV@myCo
WebApp-QA@myCo
MobileApp-QA@myCo
  • A separate Client App may be required for an HCP API Development Runtime under certain circumstances. For example, if testing new API capabilities, including Resources, Methods, or Data Elements. Defect remediation may also require that you create a Dev Client App

638bbfa0-image.png