helpcenter/helpcenter.r7-office.ru/Web/Controls/Help/Portals/Auth.ascx

94 lines
4.4 KiB
Plaintext
Raw Normal View History

2019-02-13 12:53:47 +00:00
<%@ 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>
2019-02-13 12:53:47 +00:00
</h1>
<p>Для прохождения авторизации нужно совершить следующие действия:</p>
2019-02-13 12:53:47 +00:00
<ol>
<li>Отправить POST-запрос, содержащий два параметра: <b>userName</b> и <b>password</b>, на адрес <a href="<%=VirtualPathUtility.ToAbsolute("~/api/portals/section.aspx?section=authentication")%>">api/2.0/authentication</a>
2019-02-13 12:53:47 +00:00
<div class="header-gray">Запрос авторизации</div>
2019-02-13 12:53:47 +00:00
<pre>
POST /api/2.0/authentication.json HTTP/1.1
Host: yourportal.r7-office.ru
2019-02-13 12:53:47 +00:00
Content-Type: application/json
Accept: application/json
{
&quot;userName&quot;: &quot;yourusername&quot;,
&quot;password&quot;: &quot;yourpassword&quot;
2019-02-13 12:53:47 +00:00
}
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>Host: yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
2019-02-13 12:53:47 +00:00
<div class="header-gray">Ответ</div>
2019-02-13 12:53:47 +00:00
<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;
2019-02-13 12:53:47 +00:00
},
&quot;status&quot;: 0,
&quot;statusCode&quot;: 201
2019-02-13 12:53:47 +00:00
}
</pre>
</li>
<li>В случае успешной авторизации будет получен токен следующего вида: <b>sdjhfskjdhkqy739459234</b></li>
<li>Используйте этот токен каждый раз, когда вы будете обращаться к методам API, включая его в заголовок HTTP: Авторизация
2019-02-13 12:53:47 +00:00
<div class="header-gray">Пример запроса API</div>
2019-02-13 12:53:47 +00:00
<pre>
GET api/2.0/people/@self.json HTTP/1.1
Host: yourportal.r7-office.ru
2019-02-13 12:53:47 +00:00
Accept: application/json
Authorization:sdjhfskjdhkqy739459234
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>Host: yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
2019-02-13 12:53:47 +00:00
</li>
</ol>
<div id="csharp" class="header-gray">Пример запроса авторизации на языке C#</div>
2019-02-13 12:53:47 +00:00
<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;;
2019-02-13 12:53:47 +00:00
var body = &quot;{\&quot;userName\&quot;:\&quot;yourusername\&quot;,\&quot;password\&quot;:\&quot;yourpassword\&quot;}&quot;;
2019-02-13 12:53:47 +00:00
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>
2019-02-13 12:53:47 +00:00
<div id="curl" class="header-gray">Пример запроса авторизации в формате cURL</div>
2019-02-13 12:53:47 +00:00
<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;
2019-02-13 12:53:47 +00:00
</pre>
<div class="note">Обратите внимание, что необходимо ввести адрес вашего собственного портала в поле <em>yourportal.r7-office.ru</em> вместо адреса yourportal.r7-office.ru.</div>
2019-02-13 12:53:47 +00:00
</div>