liblynx-api 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0fe4d72c4727a875b22339767d341ddad10d4ea67c7d696f197e958bc047cfa9
+  data.tar.gz: d78d47e1de2396924105918a335667928e37d7b33463fcc605d8f49b2cbbcc05
+SHA512:
+  metadata.gz: f9e1097852ad4a367f0c9c661307c9145aaac7b84ccf99eb026aa170529eaa51c266442decbac36d7cda52622f47a9a79332082db9ff61360a44310b50a0a5d5
+  data.tar.gz: 6981696e13fa5ff3fb251287545982cd585b655f3828bcd9c4895fca46cfe805a40d9048d232edce81f66aa22f5266b820326ec35cb1fd5a39ee9ffa15ecd9b7

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,53 @@
+PATH
+  remote: .
+  specs:
+    liblynx-api (1.0.0)
+      heroics
+      moneta
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    erubis (2.7.0)
+    excon (0.60.0)
+    heroics (0.0.24)
+      erubis (~> 2.0)
+      excon
+      moneta
+      multi_json (>= 1.9.2)
+    json_schema (0.17.0)
+    moneta (1.0.0)
+    multi_json (1.13.1)
+    prmd (0.13.0)
+      erubis (~> 2.7)
+      json_schema (~> 0.3, >= 0.3.1)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+    yard (0.9.12)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  liblynx-api!
+  prmd
+  rake (< 11.0)
+  rspec
+  yard
+
+BUNDLED WITH
+   1.16.1

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Denis Sablic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# LibLynx API
+
+Ruby HTTP client for the LibLynx API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```
+gem 'liblynx-api'
+```
+
+And then execute:
+
+```
+bundle
+```
+
+Or install it yourself as:
+
+```
+gem install liblynx-api
+```
+
+## Usage example
+
+```ruby
+require 'liblynx-api'
+
+client = LibLynxAPI.connect_oauth2(CLIENT_ID, CLIENT_SECRET)
+# print account resources
+pp client.account.list
+```

data/Rakefile

@@ -0,0 +1,35 @@
+require 'bundler/gem_tasks'
+require 'prmd/rake_tasks/combine'
+require 'prmd/rake_tasks/verify'
+require 'prmd/rake_tasks/doc'
+
+namespace :schema do
+  Prmd::RakeTasks::Combine.new do |t|
+    t.options[:meta] = 'meta.json'
+    t.paths << 'schemata'
+    t.output_file = 'schema.json'
+  end
+
+  Prmd::RakeTasks::Verify.new do |t|
+    t.files << 'schema.json'
+  end
+
+  Prmd::RakeTasks::Doc.new do |t|
+    t.options[:settings] = 'config.json'
+    t.files = { 'schema.json' => 'api.md' }
+  end
+end
+
+desc 'Build the client'
+task :client do
+  sh 'bundle exec heroics-generate ./config/config.rb > lib/liblynx-api/client.rb'
+end
+
+task build: ['schema:combine', 'schema:verify', 'schema:doc', 'client']
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+  task default: [:spec]
+rescue LoadError
+end

data/api.md

@@ -0,0 +1,713 @@
+
+## <a name="resource-account">Account</a>
+
+Stability: `production`
+
+
+
+### Attributes
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **active** | *boolean* | active | `true` |
+| **created_at** | *date-time* | when account was created | `"2015-01-01T12:00:00Z"` |
+| **email_domains** | *string* | cr separated email domains | `"*.somedomain.com\nalt.somedomain2.com"` |
+| **enable_archimed** | *boolean* | enable archimed | `true` |
+| **enable_individual** | *boolean* | enable individual | `true` |
+| **enable_ip** | *boolean* | enable ip | `true` |
+| **enable_lib_portal_stats** | *boolean* | enable lib portal stats | `true` |
+| **enable_library_card** | *boolean* | enable library card | `true` |
+| **enable_open_athens** | *boolean* | enable open athens | `true` |
+| **enable_pass_code** | *boolean* | enable pass code | `true` |
+| **enable_referrer** | *boolean* | enable referrer | `true` |
+| **enable_saml** | *boolean* | enable saml | `true` |
+| **enable_self_registration** | *boolean* | enable self registration | `true` |
+| **enable_shibboleth** | *boolean* | enable shibboleth | `true` |
+| **id** | *integer* | unique identifier of account | `42` |
+| **individual** | *boolean* | individual | `true` |
+| **individual_limit** | *integer* | individual limit | `42` |
+| **name** | *string* | unique name of account | `"example"` |
+| **publisher_reference** | *string* | publisher reference | `"example"` |
+| **shibboleth_entity_id** | *uri* | shibboleth entity id |  |
+| **type** | *string* | type | `"example"` |
+| **updated_at** | *date-time* | when account was updated | `"2015-01-01T12:00:00Z"` |
+
+### <a name="link-POST-account-/api/accounts">Account Create</a>
+
+Create a new account.
+
+```
+POST /api/accounts
+```
+
+#### Required Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **account_name** | *string* | unique name of account | `"example"` |
+
+
+#### Optional Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **active** | *boolean* | active | `true` |
+| **email_domains** | *string* | cr separated email domains | `"*.somedomain.com\nalt.somedomain2.com"` |
+| **enable_archimed** | *boolean* | enable archimed | `true` |
+| **enable_individual** | *boolean* | enable individual | `true` |
+| **enable_ip** | *boolean* | enable ip | `true` |
+| **enable_lib_portal_stats** | *boolean* | enable lib portal stats | `true` |
+| **enable_library_card** | *boolean* | enable library card | `true` |
+| **enable_open_athens** | *boolean* | enable open athens | `true` |
+| **enable_pass_code** | *boolean* | enable pass code | `true` |
+| **enable_referrer** | *boolean* | enable referrer | `true` |
+| **enable_saml** | *boolean* | enable saml | `true` |
+| **enable_self_registration** | *boolean* | enable self registration | `true` |
+| **enable_shibboleth** | *boolean* | enable shibboleth | `true` |
+| **individual** | *boolean* | individual | `true` |
+| **individual_limit** | *integer* | individual limit | `42` |
+| **publisher_reference** | *string* | publisher reference | `"example"` |
+| **shibboleth_entity_id** | *uri* | shibboleth entity id |  |
+| **type** | *string* | type | `"example"` |
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X POST https://connect.liblynx.com/api/accounts \
+  -d '{
+  "account_name": "example",
+  "publisher_reference": "example",
+  "email_domains": "*.somedomain.com\nalt.somedomain2.com",
+  "enable_saml": true,
+  "enable_shibboleth": true,
+  "shibboleth_entity_id": "example",
+  "enable_ip": true,
+  "enable_pass_code": true,
+  "enable_referrer": true,
+  "enable_library_card": true,
+  "enable_individual": true,
+  "enable_open_athens": true,
+  "enable_archimed": true,
+  "active": true,
+  "enable_self_registration": true,
+  "enable_lib_portal_stats": true,
+  "individual_limit": 42,
+  "individual": true,
+  "type": "example"
+}' \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 201 Created
+```
+
+```json
+{
+  "created_at": "2015-01-01T12:00:00Z",
+  "id": 42,
+  "name": "example",
+  "publisher_reference": "example",
+  "enable_saml": true,
+  "enable_shibboleth": true,
+  "email_domains": "*.somedomain.com\nalt.somedomain2.com",
+  "updated_at": "2015-01-01T12:00:00Z",
+  "shibboleth_entity_id": "example",
+  "enable_ip": true,
+  "enable_pass_code": true,
+  "enable_referrer": true,
+  "enable_library_card": true,
+  "enable_individual": true,
+  "enable_open_athens": true,
+  "enable_archimed": true,
+  "active": true,
+  "enable_self_registration": true,
+  "enable_lib_portal_stats": true,
+  "individual_limit": 42,
+  "individual": true,
+  "type": "example"
+}
+```
+
+### <a name="link-DELETE-account-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}">Account Delete</a>
+
+Delete an existing account.
+
+```
+DELETE /api/accounts/{account_id}
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X DELETE https://connect.liblynx.com/api/accounts/$ACCOUNT_ID \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+null
+```
+
+### <a name="link-GET-account-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}">Account Info</a>
+
+Info for existing account.
+
+```
+GET /api/accounts/{account_id}
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n https://connect.liblynx.com/api/accounts/$ACCOUNT_ID
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "created_at": "2015-01-01T12:00:00Z",
+  "id": 42,
+  "name": "example",
+  "publisher_reference": "example",
+  "enable_saml": true,
+  "enable_shibboleth": true,
+  "email_domains": "*.somedomain.com\nalt.somedomain2.com",
+  "updated_at": "2015-01-01T12:00:00Z",
+  "shibboleth_entity_id": "example",
+  "enable_ip": true,
+  "enable_pass_code": true,
+  "enable_referrer": true,
+  "enable_library_card": true,
+  "enable_individual": true,
+  "enable_open_athens": true,
+  "enable_archimed": true,
+  "active": true,
+  "enable_self_registration": true,
+  "enable_lib_portal_stats": true,
+  "individual_limit": 42,
+  "individual": true,
+  "type": "example"
+}
+```
+
+### <a name="link-GET-account-/api/accounts">Account List</a>
+
+List existing accounts.
+
+```
+GET /api/accounts
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n https://connect.liblynx.com/api/accounts
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "accounts": [
+    {
+      "id": 42,
+      "account_name": "example",
+      "individual": true,
+      "active": true,
+      "publisher_reference": "example",
+      "type": "example",
+      "modified_date": "2015-01-01T12:00:00Z",
+      "creation_date": "2015-01-01T12:00:00Z"
+    }
+  ]
+}
+```
+
+### <a name="link-PUT-account-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}">Account Update</a>
+
+Update an existing account.
+
+```
+PUT /api/accounts/{account_id}
+```
+
+#### Optional Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **account_name** | *string* | unique name of account | `"example"` |
+| **active** | *boolean* | active | `true` |
+| **email_domains** | *string* | cr separated email domains | `"*.somedomain.com\nalt.somedomain2.com"` |
+| **enable_archimed** | *boolean* | enable archimed | `true` |
+| **enable_individual** | *boolean* | enable individual | `true` |
+| **enable_ip** | *boolean* | enable ip | `true` |
+| **enable_lib_portal_stats** | *boolean* | enable lib portal stats | `true` |
+| **enable_library_card** | *boolean* | enable library card | `true` |
+| **enable_open_athens** | *boolean* | enable open athens | `true` |
+| **enable_pass_code** | *boolean* | enable pass code | `true` |
+| **enable_referrer** | *boolean* | enable referrer | `true` |
+| **enable_saml** | *boolean* | enable saml | `true` |
+| **enable_self_registration** | *boolean* | enable self registration | `true` |
+| **enable_shibboleth** | *boolean* | enable shibboleth | `true` |
+| **individual** | *boolean* | individual | `true` |
+| **individual_limit** | *integer* | individual limit | `42` |
+| **publisher_reference** | *string* | publisher reference | `"example"` |
+| **shibboleth_entity_id** | *uri* | shibboleth entity id |  |
+| **type** | *string* | type | `"example"` |
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X PUT https://connect.liblynx.com/api/accounts/$ACCOUNT_ID \
+  -d '{
+  "account_name": "example",
+  "publisher_reference": "example",
+  "email_domains": "*.somedomain.com\nalt.somedomain2.com",
+  "enable_saml": true,
+  "enable_shibboleth": true,
+  "shibboleth_entity_id": "example",
+  "enable_ip": true,
+  "enable_pass_code": true,
+  "enable_referrer": true,
+  "enable_library_card": true,
+  "enable_individual": true,
+  "enable_open_athens": true,
+  "enable_archimed": true,
+  "active": true,
+  "enable_self_registration": true,
+  "enable_lib_portal_stats": true,
+  "individual_limit": 42,
+  "individual": true,
+  "type": "example"
+}' \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "created_at": "2015-01-01T12:00:00Z",
+  "id": 42,
+  "name": "example",
+  "publisher_reference": "example",
+  "enable_saml": true,
+  "enable_shibboleth": true,
+  "email_domains": "*.somedomain.com\nalt.somedomain2.com",
+  "updated_at": "2015-01-01T12:00:00Z",
+  "shibboleth_entity_id": "example",
+  "enable_ip": true,
+  "enable_pass_code": true,
+  "enable_referrer": true,
+  "enable_library_card": true,
+  "enable_individual": true,
+  "enable_open_athens": true,
+  "enable_archimed": true,
+  "active": true,
+  "enable_self_registration": true,
+  "enable_lib_portal_stats": true,
+  "individual_limit": 42,
+  "individual": true,
+  "type": "example"
+}
+```
+
+
+## <a name="resource-identification">Identification</a>
+
+Stability: `production`
+
+
+
+### Attributes
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **authorizations** | *array* | authorizations |  |
+| **created** | *date-time* | when identification was created | `"2015-01-01T12:00:00Z"` |
+| **id** | *uuid* | unique identifier of identification | `"01234567-89ab-cdef-0123-456789abcdef"` |
+| **ip** | *ipv4* | ip address | `"192.0.2.1"` |
+| **publisher:id** | *integer* |  | `42` |
+| **publisher:publisher_name** | *string* |  | `"example"` |
+| **status** | *string* | status | `"example"` |
+| **target_account:account_name** | *string* |  | `"example"` |
+| **target_account:id** | *integer* |  | `42` |
+| **target_account:individual** | *boolean* |  | `true` |
+| **target_account:publisher_reference** | *string* |  | `"example"` |
+| **target_account:type** | *string* |  | `"example"` |
+| **terms** | *string* | terms | `"example"` |
+| **unit_requests** | *array* | unit requests |  |
+| **url** | *uri* | callback url |  |
+| **user_agent** | *string* | user agent | `"example"` |
+| **user_institution:account_name** | *string* |  | `"example"` |
+| **user_institution:country_code** | *string* |  | `"example"` |
+| **user_institution:id** | *integer* |  | `42` |
+| **user_institution:type** | *string* |  | `"example"` |
+
+### <a name="link-POST-identification-/api/identifications">Identification Create</a>
+
+create a new identification resource to try and identify an account to link a new session with
+
+```
+POST /api/identifications
+```
+
+#### Required Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **ip** | *ipv4* | ip address | `"192.0.2.1"` |
+| **url** | *uri* | callback url |  |
+| **user_agent** | *string* | user agent | `"example"` |
+
+
+#### Optional Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **email** | *email* | user email address | `"username@example.com"` |
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X POST https://connect.liblynx.com/api/identifications \
+  -d '{
+  "email": "username@example.com",
+  "ip": "192.0.2.1",
+  "user_agent": "example",
+  "url": "example"
+}' \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 201 Created
+```
+
+```json
+{
+  "created": "2015-01-01T12:00:00Z",
+  "id": "01234567-89ab-cdef-0123-456789abcdef",
+  "url": "example",
+  "ip": "192.0.2.1",
+  "status": "example",
+  "terms": "example",
+  "authorizations": null,
+  "unit_requests": null,
+  "publisher": {
+    "id": 42,
+    "publisher_name": "example"
+  },
+  "user_agent": "example",
+  "user_institution": {
+    "id": 42,
+    "account_name": "example",
+    "country_code": "example",
+    "type": "example"
+  },
+  "target_account": {
+    "id": 42,
+    "account_name": "example",
+    "individual": true,
+    "type": "example",
+    "publisher_reference": "example"
+  }
+}
+```
+
+### <a name="link-GET-identification-/api/identifications/{(%23%2Fdefinitions%2Fidentification%2Fdefinitions%2Fidentity)}">Identification Info</a>
+
+retrieve a single identification object
+
+```
+GET /api/identifications/{identification_id}
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n https://connect.liblynx.com/api/identifications/$IDENTIFICATION_ID
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "created": "2015-01-01T12:00:00Z",
+  "id": "01234567-89ab-cdef-0123-456789abcdef",
+  "url": "example",
+  "ip": "192.0.2.1",
+  "status": "example",
+  "terms": "example",
+  "authorizations": null,
+  "unit_requests": null,
+  "publisher": {
+    "id": 42,
+    "publisher_name": "example"
+  },
+  "user_agent": "example",
+  "user_institution": {
+    "id": 42,
+    "account_name": "example",
+    "country_code": "example",
+    "type": "example"
+  },
+  "target_account": {
+    "id": 42,
+    "account_name": "example",
+    "individual": true,
+    "type": "example",
+    "publisher_reference": "example"
+  }
+}
+```
+
+
+## <a name="resource-samlidp">Samlidp</a>
+
+Stability: `production`
+
+
+
+### Attributes
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **descriptor_url** | *string* | saml descriptor url | `"example"` |
+| **entity_id** | *string* | entity_id | `"example"` |
+| **id** | *integer* | unique identifier of samlidp | `42` |
+| **type** | *string* | type | `"example"` |
+| **xml_descriptor** | *string* | xml descriptor | `"example"` |
+
+### <a name="link-POST-samlidp-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}/samlidps">Samlidp Create</a>
+
+Create a new samlidp.
+
+```
+POST /api/accounts/{account_id}/samlidps
+```
+
+#### Required Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **descriptor_url** | *string* | saml descriptor url | `"example"` |
+
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X POST https://connect.liblynx.com/api/accounts/$ACCOUNT_ID/samlidps \
+  -d '{
+  "descriptor_url": "example"
+}' \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 201 Created
+```
+
+```json
+{
+  "id": 42,
+  "descriptor_url": "example",
+  "xml_descriptor": "example",
+  "type": "example",
+  "entity_id": "example"
+}
+```
+
+### <a name="link-DELETE-samlidp-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}/samlidps/{(%23%2Fdefinitions%2Fsamlidp%2Fdefinitions%2Fidentity)}">Samlidp Delete</a>
+
+Delete an existing samlidp.
+
+```
+DELETE /api/accounts/{account_id}/samlidps/{samlidp_id}
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X DELETE https://connect.liblynx.com/api/accounts/$ACCOUNT_ID/samlidps/$SAMLIDP_ID \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+null
+```
+
+### <a name="link-GET-samlidp-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}/samlidps/{(%23%2Fdefinitions%2Fsamlidp%2Fdefinitions%2Fidentity)}">Samlidp Info</a>
+
+Info for existing samlidp.
+
+```
+GET /api/accounts/{account_id}/samlidps/{samlidp_id}
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n https://connect.liblynx.com/api/accounts/$ACCOUNT_ID/samlidps/$SAMLIDP_ID
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "id": 42,
+  "descriptor_url": "example",
+  "xml_descriptor": "example",
+  "type": "example",
+  "entity_id": "example"
+}
+```
+
+### <a name="link-GET-samlidp-/api/accounts/{(%23%2Fdefinitions%2Faccount%2Fdefinitions%2Fidentity)}/samlidps">Samlidp List</a>
+
+List existing samlidps.
+
+```
+GET /api/accounts/{account_id}/samlidps
+```
+
+
+#### Curl Example
+
+```bash
+$ curl -n https://connect.liblynx.com/api/accounts/$ACCOUNT_ID/samlidps
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 200 OK
+```
+
+```json
+{
+  "samlidps": [
+    {
+      "id": 42,
+      "descriptor_url": "example",
+      "xml_descriptor": "example",
+      "type": "example",
+      "entity_id": "example"
+    }
+  ]
+}
+```
+
+
+## <a name="resource-token">OAuth2 token</a>
+
+Stability: `production`
+
+
+
+### Attributes
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **account_token** | *string* | unique identifier of identification | `"example"` |
+
+### <a name="link-POST-token-/oauth/v2/token">OAuth2 token Create</a>
+
+Create a new oauth2 token
+
+```
+POST /oauth/v2/token
+```
+
+#### Required Parameters
+
+| Name | Type | Description | Example |
+| ------- | ------- | ------- | ------- |
+| **grant_type** | *string* | grant_type | `"client_credentials"` |
+
+
+
+#### Curl Example
+
+```bash
+$ curl -n -X POST https://connect.liblynx.com/oauth/v2/token \
+  -d '{
+  "grant_type": "client_credentials"
+}' \
+  -H "Content-Type: application/json"
+```
+
+
+#### Response Example
+
+```
+HTTP/1.1 201 Created
+```
+
+```json
+{
+  "account_token": "example"
+}
+```
+
+