doRegister — описание SOAP и REST-метода в Users

Ссылка на конфлюенс. Там красивее смотрится верстка, но просмотр только после авторизации. Вот логин-пароль, но на всякий случай продублирую в блоге.

Это общедоступный API-метод, который вы можете подергать для ознакомления.

Ссылка на метод

REST — http://users.bugred.ru/tasks/rest/doregister (POST-запрос)

Описание метода

Регистрация нового пользователя в системе

Входные параметры

Имя параметра	Тип	Обязательный?	Описание
email	строка	да	email пользователя
name	строка	да	имя пользователя
password	строка	да	пароль

Результирующие данные

Имя параметра	Описание
party	Информация по сохраненному клиенту

Особенности использования

Пользователь создается и появляется в системе. Автор у него всегда будет «SOAP / REST», изменять его можно только через соответствующий-метод.

Имя и емейл должны быть уникальными.

Примеры вызова SOAP

Пример 1. Создание нового пользователя

Запрос:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wrap="http://foo.bar/wrappersoapserver">

   <soapenv:Header/>

   <soapenv:Body>

      <wrap:doRegister>

         <email>qq26@gmail.com</email>

         <name>qq555</name>

         <password>1</password>

      </wrap:doRegister>

   </soapenv:Body>

</soapenv:Envelope> 

Ответ:

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://users.bugred.ru/tasks/soap/WrapperSoapServer.php" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">

   <SOAP-ENV:Body>

      <ns1:doRegisterResponse>

         <return xsi:type="SOAP-ENC:Struct">

            <email xsi:type="xsd:string">qq26@gmail.com</email>

            <name xsi:type="xsd:string">qq555</name>

            <avatar xsi:type="xsd:string">http://users.bugred.ru//tmp/default_avatar.jpg</avatar>

            <password xsi:type="xsd:string">4dff4ea340f0a823f15d3f4f01ab62eae0e5da579ccb851f8db9dfe84c58b2b37b89903a740e1ee172da793a6e79d560e5f7f9bd058a12a280433ed6fa46510a</password>

            <birthday xsi:type="xsd:int">0</birthday>

            <gender xsi:type="xsd:string"/>

            <date_start xsi:type="xsd:int">0</date_start>

            <hobby xsi:type="xsd:string"/>

            <name1 xsi:type="xsd:string"/>

            <surname1 xsi:type="xsd:string"/>

            <fathername1 xsi:type="xsd:string"/>

            <cat xsi:type="xsd:string"/>

            <dog xsi:type="xsd:string"/>

            <parrot xsi:type="xsd:string"/>

            <cavy xsi:type="xsd:string"/>

            <hamster xsi:type="xsd:string"/>

            <squirrel xsi:type="xsd:string"/>

            <phone xsi:type="xsd:string"/>

            <adres xsi:type="xsd:string"/>

         </return>

      </ns1:doRegisterResponse>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Пример 2. Такой пользователь уже существует

Запрос:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wrap="http://foo.bar/wrappersoapserver">

   <soapenv:Header/>

   <soapenv:Body>

      <wrap:doRegister>

         <email>qq26@gmail.com</email>

         <name>qq555</name>

         <password>1</password>

      </wrap:doRegister>

   </soapenv:Body>

</soapenv:Envelope> 

Ответ:

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://users.bugred.ru/tasks/soap/WrapperSoapServer.php" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">

   <SOAP-ENV:Body>

      <ns1:doRegisterResponse>

         <return xsi:type="SOAP-ENC:Struct">

            <type xsi:type="xsd:string">error</type>

            <code xsi:type="xsd:int">0</code>

            <message xsi:type="xsd:string">email qq26@gmail.com уже есть в базе</message>

         </return>

      </ns1:doRegisterResponse>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Примеры вызова REST (JSON)

Пример 1. Создание нового пользователя

Запрос:

{

    "email": "milli@mail.ru",

    "name": " Машенька",

    "password": "1"

}

Ответ:

{

    "name": " Машенька",

    "avatar": "http://users.bugred.ru//tmp/default_avatar.jpg",

    "password": "4dff4ea340f0a823f15d3f4f01ab62eae0e5da579ccb851f8db9dfe84c58b2b37b89903a740e1ee172da793a6e79d560e5f7f9bd058a12a280433ed6fa46510a",

    "birthday": 0,

    "email": "milli@mail.ru",

    "gender": "",

    "date_start": 0,

    "hobby": ""

}

Все методы сделаны для моего курса «Тестирование REST API». Теорию я выкладываю на youtube и в блог, а за практикой заходите!