Теперь мы предлагаем простой в использовании library for Java, который позволит клиентам легко интегрировать InterFAX API в свою систему.
Для исходящего API для отправки факса вам потребуется только тот файл, который вы хотите отправить, номер факса получателя и учетные данные для InterFAX. Запрос на API для отправки факса должен выглядеть что-то похожее на следующее (если вы отправляете файл PDF):
POST /outbound/faxes?faxNumber=0018885551234&reference=this is my fax HTTP/1.1
Host: rest.interfax.net
Authorization: Basic ZXlhbG5ldm86WkFRIXphcTFuaHk2
Content-Type: application/pdf
Cache-Control: no-cache
[file binary content goes here]
Для входящего API, вы можете искать факсы, чтобы получить их метаданных, а затем вы загружаете факсимильное изображение определенного факса. Запрос на API для поиска факсов будет выглядеть примерно так:
GET /inbound/faxes?limit=10 HTTP/1.1
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Host: rest.interfax.net.
Interfax также предлагает систему обратного вызова (для входящих и исходящих факсов) - вы можете прочитать this article сравнивая различия между опрос и обратный вызов - которые будут отправлять уведомления и обновления статуса веб-службе клиента - для исходящих факсов, как только факс будет завершен, и для входящих факсов, как только будет получен новый факс.
Мы бы рекомендовали создать шлюз, который на основе обратного вызова InterFAX для входящих факсов, шлюз будет хранить все метаданные факса в обратном вызове, а затем продолжить загрузку факсимильного изображения - сохранение всей информации в местоположении, доступном по конечный пользователь. Для исходящих факсов вам необходимо будет создать представление какой-либо формы для конечных пользователей, чтобы отправить их факсимильную информацию. После отправки факс будет отправлен в InterFAX через API, и полученный в результате идентификатор транзакции факса (который возвращается вам в качестве ответа на отправку факса) будет храниться в локальной базе данных. После того, как факс будет завершен, обратный вызов приведет к обновлению вашей системы для обновления записей факсов в вашей базе данных.