Terminology mapping
| kb-ebsco | Auth Service | APIGEE | Cost-per-use |
|---|---|---|---|
credentials that are created authentication via Auth Service | client_secret | ||
| client_id | |||
| encrypted customer_id value | epCustomerID | ||
| atozCustomerID/eisholdingsid | X-HLM-EisHoldingsId | ||
| customerOwnerID | |||
| title id | kbid | ||
| package id | listId |
Q/A Section:
Auth Service Questions:
1. What other responses Auth Service can return except 200[OK]?
A.
2. Is it an option to check that token is expired?
A. Will find out about this from auth service but at least apigee tells us that the token we are trying to use has expired. See screenshot below for apigee response:
3. Does Auth Service have any request limits?
A.
APIGEE Questions
1. What is the mapping between APIGEE endpoints and Cost-per-use?
| KB ebsco | APIGEE | Cost-per-use |
|---|---|---|
| to be defined | GET https://apis.ebsco.com/uc/costperuse/package/{listId} + same parameters as for cost-per-use | |
| to be defined | GET https://apis.ebsco.com/uc/costperuse/title/{kbid}/{listId} + same parameters as for cost-per-use | |
| to be defined | POST https://apis.ebsco.com/uc/costperuse/titles |
2. Will APIGEE transform Cost-per-use data? It means will the body structure remain the same or it will be a different model?
A. Its the same but will confirm.
5. Could you explain this sentence in detail?
As new customers are added, APIGEE's KVM store will need to be updated to generate a new encrypted customer id (which will be shared with FOLIO)
q1. How new customers will be added?
A. When new customer(say university) is come, he needs to get an encrypted customer id on APIGEE side to be able to fetch the cost-per-use info. Unfortunately, his process is a manual action.
q2. What endpoint will update APIGEE KVM store?
A. No such endpoint for the current moment. #Please update this section if information is changed.
q3. "which will be shared with FOLIO" - how this will happen?
A. To be discussed. Right now it is like a messaage with the id.
4. Could you explain this sentence with details?
FOLIO will need to maintain epCustomerID and its APIGEE associated encrypted customer id.
A. mod-kb-ebsco-java module has to send an encrypted customer_id value as a request header. So inside the module we need to maintain mapping between university and its encrypted key for APIGEE
University name Encrypted customer_id TAMU <some_encrypted_key1> Duke University <some_encrypted_key2>
5. Does APIGEE have any request limits?
Cost-per-use Questions
1. Does Cost-Per-Use have any request limits?
A.
2. Could we have more info about "inline_model" structure?
3. What are possible values for "fiscalMonth", "analysisCurrency"? What "database" means in the context of an integer value for listId?
A. full list of values for "analysisCurrency" is available on this page Q-(6)What are the valid values that we can pass in for analysisCurrency?
A. Month are represented in a "MMM" format, for instance JAN, MAY, SEP
A. "Database" in description can be skipped, seems like a typo.
4. Will Folio use POST for Cost-per-use service?
A.
5. What are the possible values for "filter"?
6. Is it a correct assumption that on 200[Ok] endpoint will return empty body?
Additional Q/A