{"id":37,"date":"2019-03-13T10:36:00","date_gmt":"2019-03-13T08:36:00","guid":{"rendered":"https:\/\/blog.keyserv.solutions\/?p=37"},"modified":"2024-01-15T08:24:01","modified_gmt":"2024-01-15T06:24:01","slug":"apis-guru-specification-document","status":"publish","type":"post","link":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/","title":{"rendered":"The Specification Document For APIs.GURU"},"content":{"rendered":"\n<p style=\"text-align: justify;\"><a href=\"https:\/\/apis.guru\/\">Apis.Guru<\/a> is an interesting one, basically it&#8217;s a massive list of APIs that MUST have a specification document to be listed.<\/p>\n\n\n\n<p style=\"text-align: justify;\">As of the date of this article there are two forerunners in the specification document game: Swagger and OpenAPI. They are not really competing types, more like versions. Swagger is a version 2.0 doc and OpenAPI is v3.0 at the moment.<\/p>\n\n\n\n<div style=\"width:100%;height:0;padding-bottom:56%;position:relative;\"><iframe loading=\"lazy\" src=\"https:\/\/giphy.com\/embed\/UyPpKZScnl7na\" width=\"100%\" height=\"100%\" style=\"position:absolute\" frameBorder=\"0\" class=\"giphy-embed\" allowFullScreen><\/iframe><\/div><p><a href=\"https:\/\/giphy.com\/gifs\/leonardo-dicaprio-catch-me-if-you-can-lawyer-UyPpKZScnl7na\">via GIPHY<\/a><\/p>\n\n\n\n<p style=\"text-align: justify;\">Spec docs are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with but more importantly computers can ingest\/ consume them and spin up more precise machine-written code. Theoretically interfaces can be spun up on the fly although I don&#8217;t know if that&#8217;s being really done at the moment. Might be a future thing to watch for!<\/p>\n\n\n\n<p>For the interested reader to get a taste of, the following are our spec docs:<br><a href=\"https:\/\/keyserv.solutions\/v1\/spec.json\">https:\/\/keyserv.solutions\/v1\/spec.json<\/a><br><a href=\"https:\/\/keyserv.solutions\/v1\/s2.json\">https:\/\/keyserv.solutions\/v1\/s2.json<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Apis.Guru is an interesting one, basically it&#8217;s a massive list of APIs that MUST have a specification document to be listed. As of the date of this article there are two forerunners in the specification document game: Swagger and OpenAPI. They are not really competing types, more like versions. Swagger is a version 2.0 doc&hellip; <a class=\"more-link\" href=\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\">Continue reading <span class=\"screen-reader-text\">The Specification Document For APIs.GURU<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[13,16,14,17,15],"class_list":["post-37","post","type-post","status-publish","format-standard","hentry","category-blog-posts","tag-apis-guru","tag-openapi","tag-spec-doc","tag-specification-document","tag-swagger","entry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.9 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\r\n<title>The Specification Document For APIs.GURU : KeyServ Blog<\/title>\r\n<meta name=\"description\" content=\"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with\" \/>\r\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\r\n<link rel=\"canonical\" href=\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\" \/>\r\n<meta property=\"og:locale\" content=\"en_US\" \/>\r\n<meta property=\"og:type\" content=\"article\" \/>\r\n<meta property=\"og:title\" content=\"The Specification Document For APIs.GURU : KeyServ Blog\" \/>\r\n<meta property=\"og:description\" content=\"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with\" \/>\r\n<meta property=\"og:url\" content=\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\" \/>\r\n<meta property=\"og:site_name\" content=\"KeyServ Blog\" \/>\r\n<meta property=\"article:published_time\" content=\"2019-03-13T08:36:00+00:00\" \/>\r\n<meta property=\"article:modified_time\" content=\"2024-01-15T06:24:01+00:00\" \/>\r\n<meta name=\"author\" content=\"admin\" \/>\r\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\r\n<meta name=\"twitter:creator\" content=\"@thetechcomp\" \/>\r\n<meta name=\"twitter:site\" content=\"@thetechcomp\" \/>\r\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\r\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\"},\"author\":{\"name\":\"admin\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/1bd4ac278de1ca37f6447ccf067f1fd1\"},\"headline\":\"The Specification Document For APIs.GURU\",\"datePublished\":\"2019-03-13T08:36:00+00:00\",\"dateModified\":\"2024-01-15T06:24:01+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\"},\"wordCount\":166,\"publisher\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/#organization\"},\"keywords\":[\"apis.guru\",\"openapi\",\"spec doc\",\"specification document\",\"swagger\"],\"articleSection\":[\"Blog Posts\"],\"inLanguage\":\"en-ZA\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\",\"url\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\",\"name\":\"The Specification Document For APIs.GURU : KeyServ Blog\",\"isPartOf\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/#website\"},\"datePublished\":\"2019-03-13T08:36:00+00:00\",\"dateModified\":\"2024-01-15T06:24:01+00:00\",\"description\":\"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with\",\"breadcrumb\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#breadcrumb\"},\"inLanguage\":\"en-ZA\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.keyserv.solutions\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Specification Document For APIs.GURU\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#website\",\"url\":\"https:\/\/blog.keyserv.solutions\/\",\"name\":\"KeyServ Blog\",\"description\":\"The Official Blog of KeyServ By SmartQ (Pty) Ltd\",\"publisher\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.keyserv.solutions\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-ZA\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#organization\",\"name\":\"SmartQ (Pty) Ltd\",\"url\":\"https:\/\/blog.keyserv.solutions\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-ZA\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/blog.keyserv.solutions\/wp-content\/uploads\/2020\/06\/KSLogo.jpg\",\"contentUrl\":\"https:\/\/blog.keyserv.solutions\/wp-content\/uploads\/2020\/06\/KSLogo.jpg\",\"width\":1280,\"height\":1280,\"caption\":\"SmartQ (Pty) Ltd\"},\"image\":{\"@id\":\"https:\/\/blog.keyserv.solutions\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/x.com\/thetechcomp\",\"https:\/\/www.youtube.com\/channel\/UCjMrhGWMm70k5gzrTAOJxsA\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/1bd4ac278de1ca37f6447ccf067f1fd1\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-ZA\",\"@id\":\"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/fb3759727df8c056cc0cd9290dc3813bec012cfedac67f320c45cebfafac78c1?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/fb3759727df8c056cc0cd9290dc3813bec012cfedac67f320c45cebfafac78c1?s=96&d=mm&r=g\",\"caption\":\"admin\"},\"sameAs\":[\"https:\/\/blog.keyserv.solutions\"]}]}<\/script>\r\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"The Specification Document For APIs.GURU : KeyServ Blog","description":"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/","og_locale":"en_US","og_type":"article","og_title":"The Specification Document For APIs.GURU : KeyServ Blog","og_description":"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with","og_url":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/","og_site_name":"KeyServ Blog","article_published_time":"2019-03-13T08:36:00+00:00","article_modified_time":"2024-01-15T06:24:01+00:00","author":"admin","twitter_card":"summary_large_image","twitter_creator":"@thetechcomp","twitter_site":"@thetechcomp","twitter_misc":{"Written by":"admin","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#article","isPartOf":{"@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/"},"author":{"name":"admin","@id":"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/1bd4ac278de1ca37f6447ccf067f1fd1"},"headline":"The Specification Document For APIs.GURU","datePublished":"2019-03-13T08:36:00+00:00","dateModified":"2024-01-15T06:24:01+00:00","mainEntityOfPage":{"@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/"},"wordCount":166,"publisher":{"@id":"https:\/\/blog.keyserv.solutions\/#organization"},"keywords":["apis.guru","openapi","spec doc","specification document","swagger"],"articleSection":["Blog Posts"],"inLanguage":"en-ZA"},{"@type":"WebPage","@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/","url":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/","name":"The Specification Document For APIs.GURU : KeyServ Blog","isPartOf":{"@id":"https:\/\/blog.keyserv.solutions\/#website"},"datePublished":"2019-03-13T08:36:00+00:00","dateModified":"2024-01-15T06:24:01+00:00","description":"Specification documents are incredibly useful, not only can humans read them in order to understand the intricacies of an API they may be interfacing with","breadcrumb":{"@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#breadcrumb"},"inLanguage":"en-ZA","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/blog.keyserv.solutions\/index.php\/2019\/03\/13\/apis-guru-specification-document\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.keyserv.solutions\/"},{"@type":"ListItem","position":2,"name":"The Specification Document For APIs.GURU"}]},{"@type":"WebSite","@id":"https:\/\/blog.keyserv.solutions\/#website","url":"https:\/\/blog.keyserv.solutions\/","name":"KeyServ Blog","description":"The Official Blog of KeyServ By SmartQ (Pty) Ltd","publisher":{"@id":"https:\/\/blog.keyserv.solutions\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.keyserv.solutions\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-ZA"},{"@type":"Organization","@id":"https:\/\/blog.keyserv.solutions\/#organization","name":"SmartQ (Pty) Ltd","url":"https:\/\/blog.keyserv.solutions\/","logo":{"@type":"ImageObject","inLanguage":"en-ZA","@id":"https:\/\/blog.keyserv.solutions\/#\/schema\/logo\/image\/","url":"https:\/\/blog.keyserv.solutions\/wp-content\/uploads\/2020\/06\/KSLogo.jpg","contentUrl":"https:\/\/blog.keyserv.solutions\/wp-content\/uploads\/2020\/06\/KSLogo.jpg","width":1280,"height":1280,"caption":"SmartQ (Pty) Ltd"},"image":{"@id":"https:\/\/blog.keyserv.solutions\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/thetechcomp","https:\/\/www.youtube.com\/channel\/UCjMrhGWMm70k5gzrTAOJxsA"]},{"@type":"Person","@id":"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/1bd4ac278de1ca37f6447ccf067f1fd1","name":"admin","image":{"@type":"ImageObject","inLanguage":"en-ZA","@id":"https:\/\/blog.keyserv.solutions\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/fb3759727df8c056cc0cd9290dc3813bec012cfedac67f320c45cebfafac78c1?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/fb3759727df8c056cc0cd9290dc3813bec012cfedac67f320c45cebfafac78c1?s=96&d=mm&r=g","caption":"admin"},"sameAs":["https:\/\/blog.keyserv.solutions"]}]}},"_links":{"self":[{"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/posts\/37","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/comments?post=37"}],"version-history":[{"count":0,"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/posts\/37\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/media?parent=37"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/categories?post=37"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.keyserv.solutions\/index.php\/wp-json\/wp\/v2\/tags?post=37"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}