2018-09-28 Meeting Notes

Date

Attendees

Goals

  • Updates on continuing development
  • Review, organize and add to work items

Discussion items

TimeItemWhoNotes
Welcome
  • Greetings and salutations

General Info
  • UC Path
    • August and September is going to have UC Path as the priority



Google AnalyticsTeam
  • Dev portal was connected
  • Concerns with current implementation (Former user (Deleted))
  • Fixed - we added each user individually

API Health checkDiana Antova
  • Need a process to check the state or APIs and to notify the team if any are down.
  • Will need to use a cloud provider, something that just checks the Apigee APIs and emails developer-support@ucsb.edu
  • Ian recommends uptimerobot
  • Steven will look at Pingdom, Gary has used it
  • Steven will check the Statuspage.io functionality to see if we can integrate with it.

Workflow - Access RequestDiana Antova

Workflow - Publish a New APIDiana Antova
  • Dev Portal Documentation - How To Use the Publishing Workflow (APIGEE-119) - Ian Lessing (Unlicensed)
  • Diana Antova Test the workflow with the Registrar office and fill in the documents, and have them approved for all published APIs.


  • Brought up by Ann Crawford with the following questions:
    • How do we request a use case for an API
    • What is the work flow? Possible status are : received, rejected (with reason ie duplicate), closed ( with deploy date), in test,  in code
    • How do we search what's in the works?
    • Who will mange requests?
Specific use case from Ann Crawford:
Here is the API use case that I sent to housing for the photos.
Our use case is to get all new or changed photos for Type graduate or undergraduate with the perm (university ID)

New photos are perms we don't have a photo in the student health database.
Changed photos are those where the saved photo hash <> current photo hash for a given perm.   Currently the sproc returns a hash of the photo so we can compare and save, along with a perm (university ID), Type, first name, last name.  We don't use the first name or last name but it is good for testing.

Portal - Apigee Companies Add-OnIan Lessing (Unlicensed)Steven Maglio



Drupal 8 UpgradeIan Lessing (Unlicensed)

@apibot - Powershell Conversion & HostingKevin Wu
  • Working on Kevin's Computer (node 8.9.X) (APIGEE-105 & APIGEE-101)
  • Apigee Authorization Module (AuthApigee)
  • Replacement Functionality Progress Update
    • apps 
      • apps (no|approved|revoked|pending|all)
      • apps (approve|revoke) email developerApp
      • apps (approve|revoke) email developerApp apiProduct
      • apps search
      • apps users?
    • devs
      • devs created <days=1>
    • targetserver
    • companies
      • Kevin Wu will implement?
      • Need to build requirements
      • Need to build use cases
      • Need reporting that will display in developer.ucsb.edu
      • Need annual clean up times
  • Get operational on GCP
    • Kevin Wu has determined that GCP is not the right platform for the bot because of the difficulty in setting it up.
    • Kevin Wu tried out Heroku and found it really easy to work with. He wants to know if we can use this?
      • Kevin Wu will write-up a request form and submit it to Matt Hall/Elise Meyer.
  • Heroku for deployment
  • Loosing messages with the free UCSB slack. It is fine with us, no need to keep history for now.


Diana Antova
  • Feedback from IT connections
  • API dictionary and data governance - define field meaning, naming conventions (Bruce Miller)
  • More documentation, need testers that will help us define the optimal set. Can we have a link to a documentation page?
    • dedicate a meeting to documentation once a month, try it on  

DList for API System UpdatesSteven Maglio
  • A mailing list to send out general notifications for API Gateway/Developer Portal changes.
    • Things like when I updated the Pre- and Post- flow hooks
  • API Users/customers mailist for our users to subscribe, can use a google group, we can add any new API user to it. an issues is having access to the google API. 

Action Items From Previous Meeting



API Access Expected UsageFormer user (Deleted)
  • Expected Usage Text and Legal-ize (Terms of Service)
  • What do we do with separated employees
  • Use Scheduled Task to send Email asking for more information on new Access Requests
    • Need to include asking for Form to be filled out
    • Need to include list of API Products being asked for
    • Should include a line asking if a face to face meeting would be better


  • Do we have this documented? Has this been turned into an Apigee Ticket?

API Proxy Standards

Steven Maglio

  • Drop Minor Versions as a requirement
  • Write standard approach for departments that want to use Minor versions; using the approach is also optional.


  • Do we have this documented? Has this been turned into an Apigee Ticket?

Developer Portal Front Page Updates
  • In About Section
    • Diana Antova - Add page about winning the Sautter Award
    • Diana Antova - If Diana thinks its a good idea to add it to the main page, then she will work with Denise to do so
  • On front page
    • Ian Lessing (Unlicensed) - Will figure out how to add a message warning that there will be an outage of many APIs during the UC Path go line (9/16-9/17)

API VersioningSteven Maglio
  • Do we have this documented? Has this been turned into an Apigee Ticket?

DevOps DaysFormer user (Deleted)

CSF notificationDiana Antova
  • Email csf to notify developers of existing APIs and the roadmap




Action items

  •