Hi guys.
We are useing Datahub and have a number o...
# getting-startedb
bitter-translator-92563
05/25/2023, 9:38 AMHi guys.
We are useing Datahub and have a number of OpenAPI contracts ingested in it. Our next step is to link those specifications with Terms in glossary. I'd appreciate hearing any best practice or advice on how your are managing linking API Specifications with the terms.
Here are two of the ways we've came up so far:
- link terms and API methods/fields in UI after ingestion of API specification;
- make an additional development in Datahub in order to parse term urn from the specification during ingestion and turn it to relation within Datahub.
Seems that the second way is the one we are considering to implement. But would appreciate if anyone could share any experience for this type of task.
m
mammoth-bear-12532
05/25/2023, 5:10 PM
the second way would be super aligned with how we'd like to do it
mammoth-bear-12532
05/25/2023, 5:10 PM
please let us know if you need any help / guidance on this
b
bitter-translator-92563
05/25/2023, 5:41 PMHi Shirshanka, thanks for your feedback. At the moment we're considering two options for the second way:
• include terms' urns to description in specification (with some prefix, like "__") of the contract and parse the description to "extract" terms from it
bitter-translator-92563
05/25/2023, 5:41 PM...and the second one - is to make an additional field in specification and take the urns from it
bitter-translator-92563
05/25/2023, 5:43 PMDefinitely - the second one is more reliable, but will take some efforts from the teams who creates the specifications (as the field seems to be mandatory).
bitter-translator-92563
05/25/2023, 5:44 PMIf you have any reccomendation or advice on the details of that way - I would really appreciate it
m
mammoth-bear-12532
05/30/2023, 1:21 PM
Does OpenAPI contract have any extension mechanism like a map of properties you can assign?
mammoth-bear-12532
05/30/2023, 1:22 PM
is the format the same as Json Schema?