[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Отправляет коллекцию одиночных сообщений

Namespace: Infosyst.SmsHost
Assembly:  SmsHostWs (in SmsHostWs.dll)

Syntax

C#
[WebMethodAttribute(Description = "Отправляет коллекцию одиночных сообщений")]
[SoapHeaderAttribute("authentication")]
public Collection<WsSubmitSmResp> SumbitSm(
	Collection<WsSubmitSm> messageList
)
Visual Basic (Declaration)
<WebMethodAttribute(Description := "Отправляет коллекцию одиночных сообщений")> _
<SoapHeaderAttribute("authentication")> _
Public Function SumbitSm ( _
	messageList As Collection(Of WsSubmitSm) _
) As Collection(Of WsSubmitSmResp)
Visual C++
[WebMethodAttribute(Description = L"Отправляет коллекцию одиночных сообщений")]
[SoapHeaderAttribute(L"authentication")]
public:
Collection<WsSubmitSmResp^>^ SumbitSm (
	Collection<WsSubmitSm^>^ messageList
)

Parameters

messageList
Collection<(Of <WsSubmitSm>)>
Коллекция сообщений (экземпляров класса WsSubmitSm) для отправки

Return Value

Коллекция результатов отправки (экземпляров класса WsSubmitSmResp)

Remarks

Метод SumbitSm отправляет одиночные сообщения, переданные ему в виде коллекции в параметре messageList. В ответ метод возвращает коллекцию объектов - результатов отправки. Для каждого сообщения в коллекции создается один ответ. В возвращаемой коллекции столько же объектов, сколько было в сообщений в исходной коллекции.
Сообщения в отправляемой коллекции являются независимыми, не связанными между собой. Они никак не агрегируются - отправка сообщений коллекциями предназначена для снижения нагрузки на вычислительные ресурсы и каналы передачи данных. То есть если необходимо отправить N сообщений, достаточно одного запроса и одного ответа вместо N запросов и ответов.
Идентификатором сообщения является GUID. Желательно не использовать для создания идентификатора нестандартных генераторов, которые могут возвращать одинаковые значения. В случае, если сообщение будет иметь идентификатор, который уже существует на сервере sms-host.ru, сообщение не будет обрабатываться и в ответе будет установлен соответствующий код ошибки.
Служба может возвратить вместо ответа SoapException если:
  • Сообщение не удалось десериализовать
  • Пользователь не прошел аутентификацию

В ответе на запрос каждый элемент содержит аттрибут ErrorCode Коды ошибок подразделяются на следующие категории:
Диапазон значенийКатегория
0Ошибок нет
1-10Текст сообщения не прошел проверку
11-20Номер получателя не прошел проверку
21-30Номер отправителя не прошел проверку
31-40Ошибки при постановке в очередь на отправку (например, если сообщение с таким идентфиикатором уже отправлялось)

See Also