API сервиса «timeMarker.org»
ВНИМАНИЕ: API работает в тестовом режиме. Параметры запросов могут измениться.
В качестве прикладного протокола «timeMarker.org» использует HTTP.
Вы можете общаться с сервисом по средствам SOAP-сообщений или GET-запросов.
GET-запросы
Пользоваться сервисом с помощью GET-запросов просто, вы можете делать это набирая команды в адресной строке ваше браузера. Будь то «Fire Fox», «Opera», «Internet Explorer» или любой другой.
Например, что бы создать метку времени (timestamp) наберите
http://srv.timeMarker.org/Service.svc/getStamp/file/?data=base64str
и сервис выдаст вам PGP-файл с новой меткой времени, основанной на массиве байт содержащемся в «base64str».
Если же вы хотите только создать метку, но не намерены сейчас её загружать воспользуйтесь ссылкой
http://srv.timeMarker.org/Service.svc/getStamp/number/?data=base64str.
«timeMarker.org» сделает новую метку времени и сообщит её порядковый номер.
Зная порядковый номер метки, можно в любой момент её загрузить с помощью ссылки
http://srv.timeMarker.org/Service.svc/download/stamp/file/{number}
, где {number} это порядковый номер метки времени. Благодаря этой возможности, что бы распространить timestamp среди всех заинтересованных лиц достаточно сообщить им нужную ссылку.
Электронный нотариус «timeMarker.org» предоставляет еще несколько методов. Все доступные возможности перечислены в таблице 1.
Таблица 1. Адреса GET-запросов
| Создание новой метки времени |
|
http://srv.timeMarker.org/Service.svc/getStamp/file/?data={base64str}
|
| Параметры |
{base64str} - пользовательская информация, требующая заверения, в виде base64 строки (максимальный размер 4096 байт). |
| Результат |
PGP файл представляющий только что созданную новую метку времени |
|
http://srv.timeMarker.org/Service.svc/getStamp/number/?data={base64str}
|
| Параметры |
{base64str} - пользовательская информация, требующая заверения, в виде base64 строки (максимальный размер 4096 байт). |
| Результат |
Порядковый номер только что созданной новой метки времени |
| Скачивание меток времени |
|
http://srv.timeMarker.org/Service.svc/download/stamp/file/{number}
|
| Параметры |
{number} – порядковый номер скачиваемой метки времени |
| Результат |
PGP файл представляющий метку времени с указанным номером |
|
http://srv.timeMarker.org/Service.svc/download/stamp/zip/?numFrom={numberFrom}&numTo={numberTo}
|
| Параметры |
{numberFrom } – порядковый номер первой метки времени в скачиваемоей цепочке;
{numberTo} – порядковый номер крайней метки времени в скачиваемой цепочке
|
| Результат |
Zip архив содержащий PGP файлы меток времени указанной цепочки. (не более 50 файлов в архиве) |
| Скачивание PGP-ключей |
|
http://srv.timeMarker.org/Service.svc/download/key/file/{keyId}
|
| Параметры |
{keyId} – идентификатор PGP-ключа |
| Результат |
PGP файл, содержащий указанный PGP-ключ |
Примечание: сервис «timeMarker.org» поддреживает возможность заверять «метками времени» файлы размером до 10MB.
Эта возможность не доступна при использовании Get-запросов. Заверение фалов доступно только при использовании SOAP.
SOAP
WSDL-файл располагается по адресу
http://srv.timemarker.org/Service.svc?wsdl