要从您的应用程序或服务访问ADManager Plus API,您将需要来自ADManager Plus的身份验证令牌,可以使用“生成AuthToken API”获得身份验证令牌。
请求URL(JSON)格式: http://<hostname>:<port>/RestAPI/APIAuthToken
请求参数:
| 参数名称 | 强制性的 | 描述 |
| loginName | Yes | |
| password | Yes | |
| domainName | Yes | |
| AuthToken | 可选的 | 如果包含在请求中,则给定的AuthToken将无效 |
响应:
响应将是JSON格式的键/值对。响应字符串将包含以下密钥。
| 参数名称 | 描述 |
| LoginStatusMessage | 发送请求的状态消息。 |
| AuthTicket | 使用其他REST API时要使用的身份验证令牌 |
| ValidDate | AuthTicket的有效时间(以Java毫秒格式)。也就是说,自格林威治标准时间1970年1月1日00:00:00以来的毫秒数。 |
| domainNameList | 有关技术人员可以在其中执行Active Directory管理操作的域的详细信息。 |
样本输入/输出:
请求:
http://Byron:8080/RestAPI/APIAuthToken?loginName=admin&password=admin&domainName=ADManager Plus Authentication
响应:
{"AuthTicket":"6cd3830f-835f-4e7a-b6d1-7a87caffa4be","LoginName":"admin","LoginId":"1","L oginStatus":"true","ValidDate":"1506865249923","LoginStatusMessage":"Success"}
注意:
确保您对REST API请求中使用的所有特殊和保留字符进行URL编码。由于发送请求的客户端(浏览器,邮递员或TP工具)不属于ADManager Plus,因此,对特殊,保留和不安全字符的URL进行编码仅由用户负责。
保留字符包括; /?:@ =&
不安全字符包括<>#%{} | \ ^〜[]`“'