# -*- coding: utf-8 -*-
import mainsms    # Объект mainsms

# При перечислении номеров или иных идентификаторов через запятую, избегайте использования пробелов.
#
# Что бы указать не все необязательные параметры, необходимо указать имя параметра, при вызове функции, например:
# sms.create('10000', 'текст сообщения', name='имя рассылки', test=1) 
# 
# результат любой функции - словарь, элементы словарей описаны на домашней странице сервиса


# Переменные авторизации
project='o-black'      # Имя проекта
api_key='590aaaac792d2'    # API-ключ

# Создаём объект
sms = mainsms.SMS(project, api_key)


#отправка SMS на указанный номер или номера "recipients", с указанным текстом "text"
sendSMS(recipients, message, sender, run_at='', test=0)
#например:
sms.sendSMS("79999999999","с новым годом!", run_at="01.01.2013 00:00")

#получение баланса
sms.getBalance()

#рачёт стоимости
messagePrice(recipients, message)
#например:
sms.messagePrice("79999999991,79999999992,79999999993", "проверка ghjdthrf")

#запрос информации (названия операторов, регион, etc)
info(phones)

#Пример - вывод имени опреатора первого указанного телефона:
info = sms.info("79999999991,79999999992,79999999993")
print info['info'][0]["name"]

#статус сообщения, id сообщений, например "15553126,15553516"
print sms.statusSMS(id)
#например:
print sms.statusSMS("15553126,15553516")


# Создание смс рассылки
create(include, message, exclude=0, sender='', run_at='', slowtime='', slowsize='', name='', test=0)
#обязательные параметры:
#include - id группы получателя. 
#message - текстовое сообщение (текст SMS)
#необязательные параметры:
#exclude - id группы исключённых из рассылки
#sender - имя отправителя
#run_at - время отправки сообщения, например "03.10.2011 17:00"
#slowtime - время для плавной рассылки, например 10
#slowsize - количество сообщений для плавной рассылки, например 500
#name - имя рассылки, по умолчанию: "API рассылка от ГГГГ-ММ-ДД"
#test - флаг тестирования, если 1 - рассылка не осуществляется, выдаётся цена рассылки
# П.С.: Что бы узнать id группы, используйте groups('all') 
# П.С.: Пример ввывода id рассылки:
test = sms.create('10000', 'текст сообщения', name='имя рассылки')
print test['id']


#Запрос групп
groups(type) #, где type - строка, варианты из all, system, user, main, stop
#например: 
sms.groups("all")

#Запрос статуса рассылки
status(id) #, где id - ID-рассылки
#например:
sms.status("555555")