Использование API Key

После регистрации, Вам на почту будет предоставлен собственный, уникальный API ключ в виде строки из 40 символов. Ваш API ключ:

  • Уникальный, идентифицирует вас.
  • Предоставляет Вам доступ к веб-сервисам RIA.
  • Полностью приватен, не может передаваться другим лицам.

Чтобы использовать свой ключ, просто вставьте его в качестве параметра URL-адреса при создании запросов веб-сервиса. Например:

GET http://developers.ria.com/states?api_key=YOUR_KEY_HERE

Независимо от используемого HTTP метода, API ключ всегда должен передаваться в качестве параметра GET в запросе URL. Таким образом, даже если Вы будете использовать метод POST или PUT для конкретного сервиса, параметр запроса api_key должен всегда указываться в URL запросе.

Альтернативный Метод

В зависимости от того, как Вы будете использовать API, иногда может быть легче передать API ключ в качестве базовой аутентификации HTTP. Если Вы хотите использовать этот метод, отправьте Ваш API ключ в качестве имени пользователя, оставив пароль пустым. Например:

GET http://YOUR_KEY_HERE@developers.ria.com/states