Harvest(考勤卡应用)API

Question

Harvest是我在工作中使用的时间跟踪应用程序.虽然Web UI非常简单,但我想添加一些自定义功能.我注意到他们有一个API ......所以我想在C#中创建一个自定义桌面客户端.

只是看一下这个页面,它的信息量不大.您可以找到的C#示例(在进行一些挖掘之后)也没有多大帮助.那么......我在世界上如何使用C#的API？

链接到API页面

任何帮助将不胜感激 :)

Answer 1

Harvest正在使用REST API,那么你做的是对服务器上的web地址执行get/put/post请求,它会返回一个结果(通常用XML或JSON格式化(在这种情况下看似是XML) ).快速Google搜索返回了本教程,介绍了如何使用REST API,希望这足以满足您的需求.如果没有,请随时向我们询问您使用REST和C#时遇到的具体问题

在这里,我将尝试为他们的示例添加更多评论

using System;
using System.Net;
using System.IO;
using System.Text;
using System.Security.Cryptography.X509Certificates;
using System.Net.Security;

class HarvestSample
{
   //This is used to validate the certificate the server gives you, it allays assumes the cert is valid.
   public static bool Validator (object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors) {
     return true;
   }

   static void Main(string[] args)
   {
      //setting up the initial request.
      HttpWebRequest request;
      HttpWebResponse response = null;
      StreamReader reader;
      StringBuilder sbSource;
      // 1. Set some variables specific to your account.
      //This is the URL that you will be doing your REST call against. think of it as a function in normal library.
      string uri = "https://yoursubdomain.harvestapp.com/projects";
      string username="youremail@somewhere.com";
      string password="yourharvestpassword";
      string usernamePassword = username + ":" + password;

      //This checks the SSL cert that the server will give us, the function is above this one.
      ServicePointManager.ServerCertificateValidationCallback = Validator;

      try
      {
         //more setup of the connection
         request = WebRequest.Create(uri) as HttpWebRequest;
         request.MaximumAutomaticRedirections = 1;
         request.AllowAutoRedirect = true;

         // 2. It's important that both the Accept and ContentType headers are
         // set in order for this to be interpreted as an API request.
         request.Accept = "application/xml";
         request.ContentType = "application/xml";
         request.UserAgent = "harvest_api_sample.cs";
         // 3. Add the Basic Authentication header with username/password string.
         request.Headers.Add("Authorization", "Basic " + Convert.ToBase64String(new ASCIIEncoding().GetBytes(usernamePassword)));
         //actually perform the GET request
         using (response = request.GetResponse() as HttpWebResponse)
         {
            //Parse out the XML it returned.
            if (request.HaveResponse == true && response != null)
            {
               reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
               sbSource = new StringBuilder(reader.ReadToEnd());
               // 4. Print out the XML of all projects for this account.
               Console.WriteLine(sbSource.ToString());
            }
         }
      }
      catch (WebException wex)
      {
         if (wex.Response != null)
         {
            using (HttpWebResponse errorResponse = (HttpWebResponse)wex.Response)
            {
               Console.WriteLine(
                     "The server returned '{0}' with the status code {1} ({2:d}).",
                     errorResponse.StatusDescription, errorResponse.StatusCode,
                     errorResponse.StatusCode);
            }
         } else {
               Console.WriteLine( wex);

}
      } finally {
         if (response != null) { response.Close(); }
      }
   }
}