Функция postcalc_request
Основная функция опроса сервера Postcalc.RU
Настройки хранятся в конфигурационном
файле файле postcalc_light_config.php.
Принимает следующие данные: отправитель,
получатель, вес, оценка, страна.
1). Проверяет эти данные, при ошибке
возвращает строку с сообщением об ошибке.
2). В цикле опрашивает сервера проекта
Postcalc.RU (переменная servers конфигурационного
файла).
3). В случае успеха возвращает массив с
полученными от сервера данными, при ошибке -
строку с сообщением об ошибке.
4). Использует кэширование: в случае успеха
записывает ответ в каталог cache_dir, хранит
ответ в течение cache_valid секунд.
$Response=postcalc_request('101000', 'Александровка, Алтайский край, Локтевский район', 505.1, 1000, 'RU'); if (is_array($Response)) { echo $Response['Отправления']['ПростаяБандероль']['Тариф']; } else { echo "Ошибка: $Response"; }
Author:
Postcalc.RU <postcalc@mail.ru>
Version: 2.0
Since: 10.05.2014
Uses:
Используется при валидации отправителя и получателя.
Uses:
Используется при валидации страны.
Находится в файле postcalc_light_lib.php
Version: 2.0
Since: 10.05.2014
Uses:
postcalc_get_default_ops()
Используется при валидации отправителя и получателя.
Uses:
postcalc_arr_from_txt()
Используется при валидации страны.
Находится в файле postcalc_light_lib.php
string |
$From |
Отправитель. Либо 6-значный индекс ОПС, который проверяется по файлу postcalc_light_post_indexes.txt или таблице postcalc_light_post_indexes, либо наименование населенного пункта, которое проверяется по файлу postcalc_light_cities.txt или таблице postcalc_light_cities. |
string |
$To |
Получатель. Либо 6-значный индекс ОПС, который проверяется по файлу postcalc_light_post_indexes.txt или таблице postcalc_light_post_indexes, либо наименование населенного пункта, которое проверяется по файлу postcalc_light_cities.txt или таблице postcalc_light_cities. |
float |
$Weight |
Вес в граммах, от 1 до 100000. |
float |
$Valuation = 0 |
Оценка почтового отправления в рублях, от 0 до 100000. |
string |
$Country = 'RU' |
Двухбуквенный код страны, проверяется по файлу postcalc_light_countries.txt или таблице postcalc_light_countries. Если отличается от RU, поле $To игнорируется. |
array|string
|
В случае успеха возвращает массив с данными, полученными от сервера Postcalc.RU. При ошибке возвращает строку с сообщением об ошибке. |