All URIs are relative to https://ecotaxa.obs-vlfr.fr/api
Method | HTTP request | Description |
---|---|---|
activate_user | POST /users/activate/{user_id}/{status} | Activate User |
create_user | POST /users/create | Create User |
get_admin_users | GET /users/user_admins | Get Admin Users |
get_current_user_prefs | GET /users/my_preferences/{project_id} | Get Current User Prefs |
get_user | GET /users/{user_id} | Get User |
get_users | GET /users | Get Users |
get_users_admins | GET /users/admins | Get Users Admins |
reset_user_password | POST /users/reset_user_password | Reset User Password |
search_organizations | GET /organizations/search | Search Organizations |
search_user | GET /users/search | Search User |
set_current_user_prefs | PUT /users/my_preferences/{project_id} | Set Current User Prefs |
show_current_user | GET /users/me | Show Current User |
update_user | PUT /users/{user_id} | Update User |
object activate_user(user_id, status, user_activate_req, no_bot=no_bot)
Activate User
Activate a new user if external validation is on., return NULL upon success. 🔒 Depending on logged user, different authorizations apply: - An administrator or user administrator can activate a user or bypass the activation and inform the user when a modification request value/reason is provided. - An ordinary logged user cannot activate another account. If back-end configuration for self-creation check is Google reCAPTCHA, then no_bot is a pair [remote IP, reCAPTCHA response].
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.user_activate_req import UserActivateReq
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
user_id = 1 # int | Internal, the unique numeric id of this user.
status = '1' # str | Internal, the status name assign to this user.
user_activate_req = ecotaxa_py_client.UserActivateReq() # UserActivateReq |
no_bot = ['['127.0.0.1', 'ffqsdfsdf']'] # List[str] | not-a-robot proof (optional)
try:
# Activate User
api_response = api_instance.activate_user(user_id, status, user_activate_req, no_bot=no_bot)
print("The response of UsersApi->activate_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->activate_user: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
user_id | int | Internal, the unique numeric id of this user. | |
status | str | Internal, the status name assign to this user. | |
user_activate_req | UserActivateReq | ||
no_bot | List[str] | not-a-robot proof | [optional] |
object
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
object create_user(user_model_with_rights, no_bot=no_bot, token=token)
Create User
Create a new user, return NULL upon success. 🔒 Depending on logged user, different authorizations apply: - An administrator or user administrator can create a user. - An unlogged user can self-create an account. But must eventually provide a no-robot proof. - An ordinary logged user cannot create another account. If back-end configuration for self-creation check is Google reCAPTCHA, then no_bot is a pair [remote IP, reCAPTCHA response].
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.user_model_with_rights import UserModelWithRights
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
user_model_with_rights = ecotaxa_py_client.UserModelWithRights() # UserModelWithRights |
no_bot = ['['127.0.0.1', 'ffqsdfsdf']'] # List[str] | not-a-robot proof (optional)
token = 'token_example' # str | token in the url to validate request (optional)
try:
# Create User
api_response = api_instance.create_user(user_model_with_rights, no_bot=no_bot, token=token)
print("The response of UsersApi->create_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->create_user: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
user_model_with_rights | UserModelWithRights | ||
no_bot | List[str] | not-a-robot proof | [optional] |
token | str | token in the url to validate request | [optional] |
object
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List[MinUserModel] get_admin_users()
Get Admin Users
List application administrators, themselves being users. 🔒 Any authenticated user can access the list.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.min_user_model import MinUserModel
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
try:
# Get Admin Users
api_response = api_instance.get_admin_users()
print("The response of UsersApi->get_admin_users:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->get_admin_users: %s\n" % e)
This endpoint does not need any parameter.
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
str get_current_user_prefs(project_id, key)
Get Current User Prefs
Returns one preference, for a project and the currently authenticated user. Available keys are cwd, img_import and filters.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
project_id = 1 # int | Internal, numeric id of the project.
key = 'filters' # str | The preference key, as text.
try:
# Get Current User Prefs
api_response = api_instance.get_current_user_prefs(project_id, key)
print("The response of UsersApi->get_current_user_prefs:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->get_current_user_prefs: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
project_id | int | Internal, numeric id of the project. | |
key | str | The preference key, as text. |
str
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
MinUserModel get_user(user_id)
Get User
Returns information about the user corresponding to the given id.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.min_user_model import MinUserModel
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
user_id = 1 # int | Internal, the unique numeric id of this user.
try:
# Get User
api_response = api_instance.get_user(user_id)
print("The response of UsersApi->get_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->get_user: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
user_id | int | Internal, the unique numeric id of this user. |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List[UserModelWithRights] get_users(ids=ids, summary=summary)
Get Users
Returns the list of all users with their full information, or just some of them if their ids are provided. 🔒 For admins only.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.user_model_with_rights import UserModelWithRights
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
ids = '' # str | String containing the list of one or more id separated by non-num char. **If several ids are provided**, one full info is returned per user. (optional) (default to '')
summary = true # bool | Return users except rights and last_used_projects if set to True. For users list display purpose. (optional)
try:
# Get Users
api_response = api_instance.get_users(ids=ids, summary=summary)
print("The response of UsersApi->get_users:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->get_users: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
ids | str | String containing the list of one or more id separated by non-num char. If several ids are provided, one full info is returned per user. | [optional] [default to ''] |
summary | bool | Return users except rights and last_used_projects if set to True. For users list display purpose. | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List[MinUserModel] get_users_admins()
Get Users Admins
List users administrators, themselves being users. 🔒 Public, no auth.
import ecotaxa_py_client
from ecotaxa_py_client.models.min_user_model import MinUserModel
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
try:
# Get Users Admins
api_response = api_instance.get_users_admins()
print("The response of UsersApi->get_users_admins:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->get_users_admins: %s\n" % e)
This endpoint does not need any parameter.
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
object reset_user_password(reset_password_req, no_bot=no_bot, token=token)
Reset User Password
reset user password return NULL on success 🔒 Depending on logged user, different authorizations apply: - An administrator or user administrator can reset a user password. - An unlogged user can ask for a reset in two steps. and receive a mail with a token. But must eventually provide a no-robot proof. If back-end configuration for self-creation check is Google reCAPTCHA, then no_bot is a pair [remote IP, reCAPTCHA response].
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.reset_password_req import ResetPasswordReq
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
reset_password_req = ecotaxa_py_client.ResetPasswordReq() # ResetPasswordReq |
no_bot = ['['127.0.0.1', 'ffqsdfsdf']'] # List[str] | not-a-robot proof (optional)
token = 'token_example' # str | token in the url to validate request (optional)
try:
# Reset User Password
api_response = api_instance.reset_user_password(reset_password_req, no_bot=no_bot, token=token)
print("The response of UsersApi->reset_user_password:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->reset_user_password: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
reset_password_req | ResetPasswordReq | ||
no_bot | List[str] | not-a-robot proof | [optional] |
token | str | token in the url to validate request | [optional] |
object
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List[str] search_organizations(name)
Search Organizations
Search for organizations. So far, organizations are just names in users table.
import ecotaxa_py_client
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
name = '%vill%' # str | Search by name, use % for searching with 'any char'.
try:
# Search Organizations
api_response = api_instance.search_organizations(name)
print("The response of UsersApi->search_organizations:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->search_organizations: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
name | str | Search by name, use % for searching with 'any char'. |
List[str]
No authorization required
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
List[MinUserModel] search_user(by_name=by_name)
Search User
Search users using various criteria, search is case-insensitive and might contain % chars.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.min_user_model import MinUserModel
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
by_name = '%userNa%' # str | Search by name, use % for searching with 'any char'. (optional)
try:
# Search User
api_response = api_instance.search_user(by_name=by_name)
print("The response of UsersApi->search_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->search_user: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
by_name | str | Search by name, use % for searching with 'any char'. | [optional] |
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
object set_current_user_prefs(project_id, key, value)
Set Current User Prefs
Sets one preference, for a project and for the currently authenticated user. Available keys are cwd, img_import and filters. The key disappears if set to empty string. Returns NULL upon success.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
project_id = 1 # int | Internal, numeric id of the project.
key = 'filters' # str | The preference key, as text.
value = '{\"dispfield\": \" dispfield_orig_id dispfield_classif_auto_score dispfield_classif_when dispfield_random_value\", \"ipp\": \"500\", \"magenabled\": \"1\", \"popupenabled\": \"1\", \"sortby\": \"orig_id\", \"sortorder\": \"asc\", \"statusfilter\": \"\", \"zoom\": \"90\"}' # str | The value to set this preference to, as text.
try:
# Set Current User Prefs
api_response = api_instance.set_current_user_prefs(project_id, key, value)
print("The response of UsersApi->set_current_user_prefs:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->set_current_user_prefs: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
project_id | int | Internal, numeric id of the project. | |
key | str | The preference key, as text. | |
value | str | The value to set this preference to, as text. |
object
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
UserModelWithRights show_current_user()
Show Current User
Returns currently authenticated user's (i.e. you) information, permissions and last used projects.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.user_model_with_rights import UserModelWithRights
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
try:
# Show Current User
api_response = api_instance.show_current_user()
print("The response of UsersApi->show_current_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->show_current_user: %s\n" % e)
This endpoint does not need any parameter.
- Content-Type: Not defined
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
object update_user(user_id, user_model_with_rights)
Update User
Update the user, return NULL upon success. 🔒 Depending on logged user, different authorizations apply: - An administrator or user administrator can change any field with respect of consistency. - A user can update own password and name. - An ordinary user cannot update anything for another user.
- OAuth Authentication (BearerOrCookieAuth):
import ecotaxa_py_client
from ecotaxa_py_client.models.user_model_with_rights import UserModelWithRights
from ecotaxa_py_client.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://ecotaxa.obs-vlfr.fr/api
# See configuration.py for a list of all supported configuration parameters.
configuration = ecotaxa_py_client.Configuration(
host = "https://ecotaxa.obs-vlfr.fr/api"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
configuration.access_token = os.environ["ACCESS_TOKEN"]
# Enter a context with an instance of the API client
with ecotaxa_py_client.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = ecotaxa_py_client.UsersApi(api_client)
user_id = 760 # int | Internal, numeric id of the user.
user_model_with_rights = ecotaxa_py_client.UserModelWithRights() # UserModelWithRights |
try:
# Update User
api_response = api_instance.update_user(user_id, user_model_with_rights)
print("The response of UsersApi->update_user:\n")
pprint(api_response)
except Exception as e:
print("Exception when calling UsersApi->update_user: %s\n" % e)
Name | Type | Description | Notes |
---|---|---|---|
user_id | int | Internal, numeric id of the user. | |
user_model_with_rights | UserModelWithRights |
object
- Content-Type: application/json
- Accept: application/json
Status code | Description | Response headers |
---|---|---|
200 | Successful Response | - |
422 | Validation Error | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]