helpcenter/helpcenter.r7-office.ru/Web/Controls/Help/Portals/Auth.ascx
2019-02-22 17:45:39 +03:00

94 lines
4.4 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<%@ Control Language="C#" Inherits="BaseContentUserControls" %>
<script runat="server">
protected override void Init()
{
PageTitle = PageCaption = "Authentication";
MetaKeyWords = "";
MetaDescription = "";
}
</script>
<div class="MainHelpCenter PageGuides">
<h1>
<span class="hdr">Как пройти авторизацию?</span>
</h1>
<p>Для прохождения авторизации нужно совершить следующие действия:</p>
<ol>
<li>Отправить POST-запрос, содержащий два параметра: <b>userName</b> и <b>password</b>, на адрес <a href="<%=VirtualPathUtility.ToAbsolute("~/api/portals/section.aspx?section=authentication")%>">api/2.0/authentication</a>
<div class="header-gray">Запрос авторизации</div>
<pre>
POST /api/2.0/authentication.json HTTP/1.1
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
&quot;userName&quot;: &quot;yourusername&quot;,
&quot;password&quot;: &quot;yourpassword&quot;
}
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>Host: yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
<div class="header-gray">Ответ</div>
<pre>
HTTP/1.1 201 Created
Cache-Control: private
Content-Type: application/json; charset=utf-8
{
&quot;count&quot;: 1,
&quot;response&quot;: {
&quot;expires&quot;: &quot;2010-07-07T17:06:03.5845502+03:00&quot;,
&quot;token&quot;: &quot;sdjhfskjdhkqy739459234&quot;
},
&quot;status&quot;: 0,
&quot;statusCode&quot;: 201
}
</pre>
</li>
<li>В случае успешной авторизации будет получен токен следующего вида: <b>sdjhfskjdhkqy739459234</b></li>
<li>Используйте этот токен каждый раз, когда вы будете обращаться к методам API, включая его в заголовок HTTP: Авторизация
<div class="header-gray">Пример запроса API</div>
<pre>
GET api/2.0/people/@self.json HTTP/1.1
Host: yourportal.r7-office.ru
Accept: application/json
Authorization:sdjhfskjdhkqy739459234
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>Host: yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
</li>
</ol>
<div id="csharp" class="header-gray">Пример запроса авторизации на языке C#</div>
<pre>
var request = System.Net.WebRequest.Create(&quot;https://yourportal.r7-office.ru/api/2.0/authentication.json&quot;);
request.Method = &quot;POST&quot;;
request.ContentType = &quot;application/json&quot;;
var body = &quot;{\&quot;userName\&quot;:\&quot;yourusername\&quot;,\&quot;password\&quot;:\&quot;yourpassword\&quot;}&quot;;
var data = System.Text.Encoding.UTF8.GetBytes(body);
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (System.Net.HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
<div id="curl" class="header-gray">Пример запроса авторизации в формате cURL</div>
<pre>
curl --request POST --header &quot;Content-Type: application/json&quot; --data &quot;{\&quot;username\&quot;:\&quot;yourusername\&quot;,\&quot;password\&quot;:\&quot;yourpassword\&quot;}&quot; &quot;https://yourportal.r7-office.ru/api/2.0/authentication.json&quot;
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
</div>