Logs user into Medium One API and produces login cookies to identify the user's logged in state. The cookies must be passed in with subsequent requests to the other API endpoints. If
no_cookies
is specified, the returned token must be saved and from then on, token=<RETURNED TOKEN>
must be added to the URL parameters for each following request.Note: Cookie and token sessions last for 24 hours.
If you receive an "Exceeded bad login count" error, you need to log in from a different IP address or wait 5 minutes without any login attempts.
Login
Summary
- Endpoint: /v2/login
- Method: POST
- Permissions: This operation is permitted for all user roles.
Headers
Content-Type: application/json
Accept: application/json
Body
login_id
(required): Email address associated with userpassword
(required): User’s passwordapi_key
(required): Enabled API key for project
Path
no_cookies
: Value not used. Session cookie header will not be returned; instead a token will be returned in the response body.
HTTP Response
200 OK
- The user is successfully logged in. The response body will contain:
true
. However if no_cookies is specified, the return value will be the token.
400 BAD REQUEST
- The request was missing login_id/password/key parameters.
400 UNAUTHORIZED
- The parameters contained invalid data, or the password didn’t match
403 FORBIDDEN
- No user matching login_id can be found or insufficient permissions to login.
500 SERVER ERROR
- Could not complete the request due to an internal server error.
503 SERVICE UNAVAILABLE
- Temporarily unable to complete the login request. Please try again.
Examples
Curl
#!/bin/sh
curl -c cookie_user.txt -i -X POST -d '{"login_id":"biz_user","password":"12345","api_key":"ABCDEFGHIJKLmnopabcdefghijklmnop1234567890"}' https://api.mediumone.com/v2/login/ --header "Content-Type: application/json"
Python
import requests
import json
headers ={'Content-Type': 'application/json', 'Accept': 'application/json'}
data = {'login_id': 'biz_user', 'password': '12345', 'api_key': 'ABCDEFGHIJKLmnopabcdefghijklmnop1234567890'}
session = requests.session()
response = session.post('https://api.mediumone.com/v2/login', data=json.dumps(data), headers=headers)
Curl
#!/bin/sh
curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' 'https://api.mediumone.com/v2/login?no_cookies' -d '{"login_id": "biz_user", "password": "12345", "api_key": "ABCDEFGHIJKLmnopabcdefghijklmnop1234567890"}'
Python
import requests
import json
headers ={'Content-Type': 'application/json', 'Accept': 'application/json'}
data = {'login_id': 'biz_user', 'password': '12345', 'api_key': 'ABCDEFGHIJKLmnopabcdefghijklmnop1234567890'}
session = requests.session()
response = session.post('https://api.mediumone.com/v2/login?no_cookies', data=json.dumps(data), headers=headers)