Обзор

Функции

  • postcalc_arr_from_txt
  • postcalc_autocomplete
  • postcalc_get_default_ops
  • postcalc_get_stat_arr
  • postcalc_request
  • Обзор
  • Функция
  • Загрузка

Функция 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: 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. При ошибке возвращает строку с сообщением об ошибке.
Библиотека и клиент PostcalcLight документация по API сгенерирована ApiGen 2.8.0