René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Best practice for registering GraphQL with SmartAPI","articleBody":"What is the best practice for registering graphql APIs? This is a different framework than OpenAPI (see any number of blog posts). There are converters, but there is a big impedance mismatch between the frameworks meaning any automated conversion will likely be unsatisfactory.\r\n\r\nFor example, using https://github.com/yarax/swagger-to-graphql on MyChem.info\r\n\r\n```\r\n$ curl http://smart-api.info/api/metadata/8f08d1446e0bb9c2b323713ce83e2bd3 \u003e mychem.json\r\n$ swagger-to-graphql --swagger mychem.json \r\ntype get_drug_drugid {\r\n  # default field\r\n  empty: String\r\n}\r\n\r\ntype get_query {\r\n  # default field\r\n  empty: String\r\n}\r\n\r\n# DrugBank ID, InCHIKey, CHEBI ID, CHEMBL ID\r\ninput param_get_drug_drugid_drugid {\r\n  # default field\r\n  empty: String\r\n}\r\n\r\n# Query string. Examples \"Fludara\", \"CHEMBI:63599\", \"DB01073\".\r\ninput param_get_query_q {\r\n  # default field\r\n  empty: String\r\n}\r\n\r\ntype Query {\r\n  viewer: viewer\r\n}\r\n\r\ntype viewer {\r\n  get_query(q: param_get_query_q): get_query\r\n  get_drug_drugid(drugid: param_get_drug_drugid_drugid): get_drug_drugid\r\n}\r\n```\r\n\r\nit's not clear what the best practice should be. Should we create a stub entry for the main graphql path? What is the best way of pointing to the garphql schema?","author":{"url":"https://github.com/cmungall","@type":"Person","name":"cmungall"},"datePublished":"2017-12-19T16:45:28.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/3/smartapi_registry/issues/3"}