add get-tag-signature-verification endpoint (octokit#389)

kaizensoze · web-flow · commit 0e674d63e114 · 2016-06-29T20:21:36.000-04:00
diff --git a/doc/apidoc.js b/doc/apidoc.js
@@ -1072,6 +1072,19 @@ github.gitdata.getReferences({ ... });
 github.gitdata.getTag({ ... });
  */
 
+/**
+ * @api {get} /repos/:user/:repo/git/tags/:sha getTagSignatureVerification
+ * @apiName getTagSignatureVerification
+ * @apiDescription Get a Tag Signature Verification. (In preview period. See README.)
+ * @apiGroup gitdata
+ *
+ * @apiParam {String} user  
+ * @apiParam {String} repo  
+ * @apiParam {String} sha  
+ * @apiExample {js} ex:
+github.gitdata.getTagSignatureVerification({ ... });
+ */
+
 /**
  * @api {get} /repos/:user/:repo/git/refs/tags getTags
  * @apiName getTags
diff --git a/lib/routes.json b/lib/routes.json
@@ -1458,6 +1458,17 @@
             },
             "description": "Create a Tag Object"
         },
+        
+        "get-tag-signature-verification": {
+            "url": "/repos/:user/:repo/git/tags/:sha",
+            "method": "GET",
+            "params": {
+                "$user": null,
+                "$repo": null,
+                "$sha": null
+            },
+            "description": "Get a Tag Signature Verification. (In preview period. See README.)"
+        },
 
         "get-tree": {
             "url": "/repos/:user/:repo/git/trees/:sha",
diff --git a/test/gitdataTest.js b/test/gitdataTest.js
@@ -219,6 +219,21 @@ describe("[gitdata]", function() {
         );
     });
 
+    it("should successfully execute GET /repos/:user/:repo/git/tags/:sha (getTagSignatureVerification)",  function(next) {
+        client.gitdata.getTagSignatureVerification(
+            {
+                user: "String",
+                repo: "String",
+                sha: "String"
+            },
+            function(err, res) {
+                Assert.equal(err, null);
+                // other assertions go here
+                next();
+            }
+        );
+    });
+
     it("should successfully execute GET /repos/:user/:repo/git/refs/tags (getTags)",  function(next) {
         client.gitdata.getTags(
             {
