Loading...
Wisenet

      OLD API Endpoint: Student’s Next of Kin

      In September 2018 Wisenet released a beta version of a new API named Wisenet API. This became live in December 2018. The Wisenet API is a complete rewrite and is designed to replace the now named OLD API. While we will be keeping the OLD API active for at least a year, it will no longer be updated.

      Go to Wisenet API Docs 

      The Wisenet Next of Kin Endpoint allows your applications to get information about the next of kin for a student.

      Related Endpoints

      API Endpoint: Students 

      Next of Kin Properties

      The following are mandatory for a PUT / POST request:

      • InternationalNextOfKin
        • Address
      • LocalNextOfKin
        • Address
      • StudentId

      The following are optional for a PUT / POST request:

      • InternationalNextOfKin
        • Email (maxlength:100)
        • FirstName (maxlength:20)
        • HomePhone (maxlength:20)
        • LastName (maxlength:50)
        • MiddleName (maxlength:20)
        • Mobile (maxlength:20)
        • WorkPhone (maxlength:20)
      • LocalNextOfKin
        • Email (maxlength:100)
        • FirstName (maxlength:20)
        • HomePhone (maxlength:20)
        • LastName (maxlength:40)
        • MiddleName (maxlength:20)
        • Mobile (maxlength:20)
        • Nationality (see dropdowns: Country)
        • Occupation (maxlength:100)
        • PassportCountry (see dropdowns: Country)
        • PassportNumber (maxlength:20)
        • Relationship (custom dropdown: available in References)
        • WorkPhone (maxlength:20)

      The following are only returned on a GET request:

      • Link
      • RefInternal
      • StudentFirstName
      • StudentLastName
      • StudentLink

      Read Next of Kin for Student

      GET /students/student/{id}/nextofkin

      Returns the next of kin for the student with the given {id}

      Sample request:

       curl _X GET \
   -H "Accept: application/vnd.mywisenet.api.v1+xml" \
   https://tst-api.wisenet.co/students/student/1/nextofkin

      Sample response:

       xmlns="http://api.mywisenet.com.au/v1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  >
    >
      >Pemberley>
      >1 Darcy Street>
      >Lambton>
      >
        >2100>
        >United Kingdom>
      >
      >1080>
      >Derbyshire>
    >
    >old.mr@darcy.com.au>
    >Old>
    >0211111111>
    >Darcy>
    >Mister>
    >0411111111>
    >0211111112>
  >
  >
    >students/student/1/nextofkin>
    >self>
    >STD0000001: Fitzwilliam Darcy - Next Of Kin>
  >
  >
    >
      >1 Darcy Street>
      >Parramatta>
      >
        >1101>
        >Australia>
      >
      >2150>
      >
        >01>
        >NSW>
      >
    >
    >lady.anne@darcy.com.au>
    >Lady>
    >0211111111>
    >Darcy>
    >Anne>
    >0411111111>
    >
      >1101>
      >Australia>
    >
    >Homemaker>
    >
      >1101>
      >Australia>
    >
    >AU1234>
    >Mother>
  >
  <RefInternal>STD0000001RefInternal>
  >Fitzwilliam>
  >1>
  >Darcy>
  >
    >students/student/1>
    >student>
    >STD0000001: Fitzwilliam Darcy>
  >
>

      C# Code Sample

      public static void GetCourseEnrolmentsSample()
{
    const string url = "https://tst-api.wisenet.co/students/student/{id}/nextofkin";
 
    var request = HttpWebRequest.Create(url) as HttpWebRequest;
    request.Accept = "application/vnd.mywisenet.api.v1+xml";
    request.Method = "GET";
    request.UserAgent = "C# Sample Client";
 
    try
    {
        // Get response  
        using (var response = request.GetResponse() as HttpWebResponse)
        {
            // Get the response stream  
            using (var responseReader = new StreamReader(response.GetResponseStream()))
            {
                string responseBody = responseReader.ReadToEnd();
 
                // Console application output  
                Console.WriteLine(responseBody);
            }
        }
    }
    catch (WebException ex)
    {
        Console.WriteLine("Error: {0}", ex.Message);
    }
}

      Update Next of Kin for a Student

      PUT /students/student/{id}/nextofkin

      Updates the next of kin for the student record with the specified {id}.

      If you like to receive newly updated object back please use reload=true param

      PUT /students/student/{id}/nextofkin?reload=true

      Sample request:

       curl -X PUT \
   -H "Content-Type: application/vnd.mywisenet.api.v1+xml" \
   -v \
   -d @NextOfKin1.xml \
   https://tst-api.wisenet.co/students/student/1/nextofkin

      NextOfKin1.xml:

       xmlns="http://api.mywisenet.com.au/v1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  >
    >
      >Pemberley>
      >1 Darcy Street>
      >Lambton>
      >
        >2100>
        >United Kingdom>
      >
      >1080>
      >Derbyshire>
    >
    >old.mr@darcy.com.au>
    >Old>
    >0211111111>
    >Darcy>
    >Mister>
    >0411111111>
    >0211111112>
  >
  >
    >
      >1 Darcy Street>
      >Parramatta>
      >
        >1101>
        >Australia>
      >
      >2150>
      >
        >01>
        >NSW>
      >
    >
    >lady.anne@darcy.com.au>
    >Lady>
    >0211111111>
    >Darcy>
    >Anne>
    >0411111111>
    >
      >1101>
      >Australia>
    >
    >Homemaker>
    >
      >1101>
      >Australia>
    >
    >AU1234>
    >Mother>
  >
  >1>
>

      Sample response:

      < HTTP/1.1 200 OK
< Date: Mon, 04 Jul 2011 23:34:04 GMT
< Content-Length: 0

      C# Code Sample

      private static void UpdateSample()
{
    const string url = "https://tst-api.wisenet.co/students/student/1/nextofkin";
 
    var request = HttpWebRequest.Create(url) as HttpWebRequest;
    request.ContentType = "application/vnd.mywisenet.api.v1+xml";
    request.Method = "PUT";
    request.UserAgent = "C# Sample Client";
 
    byte[] byteData = File.ReadAllBytes("NextOfKin1.xml");   
 
    // Set the content length in the request headers  
    request.ContentLength = byteData.Length;
 
    // Write data  
    using (Stream postStream = request.GetRequestStream())
    {
        postStream.Write(byteData, 0, byteData.Length);
    } 
 
    try
    {
        // Get response  
        using (var response = request.GetResponse() as HttpWebResponse)
        {
            // Get the response stream  
            using (var responseReader = new StreamReader(response.GetResponseStream()))
            {
                string responseBody = responseReader.ReadToEnd();
 
                // Console application output  
                Console.WriteLine(responseBody);
            }
        }
    }
    catch (WebException ex)
    {
        Console.WriteLine("Error: {0}", wex.Message);
    }
}

      Related Articles

      API Endpoints

      API Developers Resources

      API FAQ

      API

      Was this Resource helpful?