dpazuic/aits_terms

用于联系AITS术语API的包装器

dev-master 2018-01-08 16:43 UTC

This package is not auto-updated.

Last update: 2024-09-25 08:39:58 UTC


README

PHP库,用于使用AITS术语API(联系AITS获取API的详细信息)

用法

要使用此库,您需要

  • 将库包含到您的程序中
include_once('aits_terms.php');
  • 或使用composer composer require dpazuic\aits_terms
include_once('vendor/autoload.php');
  • 实例化dpazuic\aits_term类的对象
$period = 'current'; // Also accepted: 22017X|current|nextterm|lastterm|nextsemester|lastsemester|nextyear|lastyear 
$campusCode = 'uic'; // Also accepted: uic|uiuc|uis|100|200|400
$senderAppID = 'YOUR_SENDER_APP_ID'; // Contact AITS for this
$termAPI = new dpazuic\aits_terms($period, $campusCode, $senderAppID);
  • 使用对象上的公共方法之一

从API调用获取结果

#3
$outputFormat = 'json';
$data = $termAPI->getAITSTerms($outputFormat);
print_r($data);

$data 输出

{  
   "object":"Term",
   "version":"1_0",
   "list":[  
      {  
         "queryPeriod":"current",
         "queryCampus":"uic",
         "term":[  
            {  
               "termCode":"220178",
               "termDescription":"Fall 2017 - Chicago",
               "startDate":"2017-08-28",
               "endDate":"2017-12-16",
               "finaidProcYear":{  
                  "code":"1718",
                  "description":"2017-2018"
               },
               "academicYear":{  
                  "code":"1718",
                  "description":"2017-2018"
               },
               "housingStartDate":"2017-08-28",
               "housingEndDate":"2017-12-16",
               "termType":{  
                  "code":"S",
                  "description":"Semester"
               },
               "termPart":[  
                  {  
                     "termCode":"220178",
                     "description":"Full Term",
                     "startDate":"2017-08-28",
                     "endDate":"2017-12-08",
                     "weeks":16,
                     "censusDate":"2017-08-28"
                  },
                  {  
                     "termCode":"220178",
                     "description":"First Half",
                     "startDate":"2017-08-28",
                     "endDate":"2017-10-20",
                     "weeks":8,
                     "censusDate":"2017-08-28"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Second Half",
                     "startDate":"2017-10-23",
                     "endDate":"2017-12-08",
                     "weeks":8,
                     "censusDate":"2017-10-23"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Dentistry",
                     "startDate":"2017-08-28",
                     "endDate":"2017-12-15",
                     "weeks":16,
                     "censusDate":"2017-08-28"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Medicine",
                     "startDate":"2017-08-14",
                     "endDate":"2017-12-15",
                     "weeks":16,
                     "censusDate":"2017-08-14"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Tuition Waiver Fall",
                     "startDate":"2017-08-21",
                     "endDate":"2017-12-15",
                     "weeks":17,
                     "censusDate":"2017-08-28"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Urbana Calendar",
                     "startDate":"2017-08-28",
                     "endDate":"2017-12-13",
                     "weeks":16,
                     "censusDate":"2017-08-28"
                  },
                  {  
                     "termCode":"220178",
                     "description":"Extramural",
                     "startDate":"2017-08-28",
                     "endDate":"2017-12-08",
                     "weeks":16,
                     "censusDate":"2017-08-28"
                  }
               ]
            }
         ]
      }
   ]
}

返回上一个调用结果(PHP对象)

#3
$outputFormat = 'json';
$data = $termAPI->getCachedResult();
print_r($data);

$data 输出

stdClass Object
(
    [type] => json
    [data] => {"object":"Term","version":"1_0","list":[{"queryPeriod":"current","queryCampus":"uic","term":[{"termCode":"220178","termDescription":"Fall 2017 - Chicago","startDate":"2017-08-28","endDate":"2017-12-16","finaidProcYear":{"code":"1718","description":"2017-2018"},"academicYear":{"code":"1718","description":"2017-2018"},"housingStartDate":"2017-08-28","housingEndDate":"2017-12-16","termType":{"code":"S","description":"Semester"},"termPart":[{"termCode":"220178","description":"Full Term","startDate":"2017-08-28","endDate":"2017-12-08","weeks":16,"censusDate":"2017-08-28"},{"termCode":"220178","description":"First Half","startDate":"2017-08-28","endDate":"2017-10-20","weeks":8,"censusDate":"2017-08-28"},{"termCode":"220178","description":"Second Half","startDate":"2017-10-23","endDate":"2017-12-08","weeks":8,"censusDate":"2017-10-23"},{"termCode":"220178","description":"Dentistry","startDate":"2017-08-28","endDate":"2017-12-15","weeks":16,"censusDate":"2017-08-28"},{"termCode":"220178","description":"Medicine","startDate":"2017-08-14","endDate":"2017-12-15","weeks":16,"censusDate":"2017-08-14"},{"termCode":"220178","description":"Tuition Waiver Fall","startDate":"2017-08-21","endDate":"2017-12-15","weeks":17,"censusDate":"2017-08-28"},{"termCode":"220178","description":"Urbana Calendar","startDate":"2017-08-28","endDate":"2017-12-13","weeks":16,"censusDate":"2017-08-28"},{"termCode":"220178","description":"Extramural","startDate":"2017-08-28","endDate":"2017-12-08","weeks":16,"censusDate":"2017-08-28"}]}]}]}
)

示例

您可以使用附带的examples/cli-test.php文件从命令行测试功能。php cli-test.php YOUR_SENDER_APP_ID 220178 uic json