Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 61 Next »

NOTE:  Dev protected to ODS Tools & Ed-Fi All Hands while in 2.x draft status

Below are the endpoints and their request and response objects for v2.x of the Ed-Fi ODS / API Admin API.

For the most accurate and detailed documentation of active endpoints in a version, configure and launch your application with SwaggerEnabled : true (this is not recommended in production).

All functional endpoints require authentication to access. See Securing Admin API for details.

Endpoint URLs and Schemas

Actions

 Click to view /actions endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/actions
GET

Retrieves all actions

-
[
{
  "id": 0
  "name": "string"
  "uri": "string"
  }
]

AuthStrategies

 Click to view /auth strategies endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/authStrategies
GET

Retrieves all auth strategies

-
[
{
  "authStrategyId": 0
  "authStrategyName": "string"
  "displayName": "string"
  }
]


Applications

 Click to view /applications endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/applications/
GET

Retrieves all applications

-|
[
 {
"id": 0,
  "applicationName": "string",
   "vendorId": 0,
  "claimSetName": "string",
"profileIds": [],
  "educationOrganizationIds": [],
"odsInstanceId": 0
}
]
v2/applications/{id}
GET

Retrieves a specific application by id 

-
{
"id": 0,
  "applicationName": "string",
 "vendorId": 0,
  "claimSetName": "string",
 "profileIds": [],
"educationOrganizationIds": [],
"odsInstanceId": 0
}
v2/applications/
POST

Creates a new application

{
  "applicationName": "string",
  "vendorId": 0,
  "claimSetName": "string",
  "profileIds": [ 0 ],
  "educationOrganizationIds": [ 0 ],
"odsInstanceId": 0
}
{
"id": 0,
  "key": "string",
  "secret": "string"
}
v2/applications/{id}
PUT

Updates a specific application by id

{
"id": 0,
"applicationName": "string",
"vendorId": 0,
"claimSetName": "string",
"profileIds": [ 0 ],
"educationOrganizationIds": [ 0 ],
 "odsInstanceId": 0
}
HTTP response as documented below
v2/applications/{id}
DELETE

Deletes an application by id 

-
HTTP response as documented below
v2/applications/{id}/reset-credential
PUTResets an application credentials by id -
{
"id": 0,
  "key": "string",
  "secret": "string"
}

ClaimSets

 Click to view /claimsets endpoints
Note: Property names start with _ represents read-only properties.
Endpoint
HTTP Verb
Description
Request Schema
Response Schema (Success)
v2/claimSets
GET

Retrieves all claimsets

-
[
  {
    "id": 0,
    "name": "string",
    "_isSystemReserved": true,
    "_applications": []
  }
]
v2/claimSets
POST

Creates a new claimset.

{ "name": "string"}
{
  "id": 0,
  "name": "string",
"_isSystemReserved": false,
"_applications": []
}

v2/claimSets/{id}
GET

Retrieves a specific claimset by id 

-
{
  "id": 0,
  "name": "string",
  "_isSystemReserved": false,
  "_applications": [],
  "resourceClaims": [
    {
"id": "string",
     "name": "string", "read": true, "create": true, "update": true, "delete": true, "_defaultAuthStrategiesForCRUD": [ {
"actionName": string, "authStrategies": [], "isInheritedFromParent": true } ], "authStrategyOverridesForCRUD": [ {          
"actionName": string,
"authStrategies": [],          
"isInheritedFromParent": true } ], "children": [ "list of resource claims" ] } ] }
v2/claimSets/{id}
PUT
Update the claim set name.
{ 
"id": 0,
"name": "string"
}
HTTP response as documented below
v2/claimSets/{id}
DELETEDeletes a claimset by id -HTTP response as documented below
v2/claimSets/{claimSetId}/resourceClaimActions
POST

Add resourceclaimaction association to claim set. At least one action should be enabled (read, create, update, delete). 
resouceclaimId is required fields.

{
"resouceclaimId" : 0,
"resourceClaimActions":
 { 
  "read": true,
  "create": true,
  "update": true,
    "delete": true
  }   
}

HTTP response as documented below

v2/claimSets/{claimSetId}/
resourceClaimActions/{resourceClaimid}





PUT

Updates  the resourceclaimActions to a  specific resource claim on a claimset. At least one action should be enabled (read, create, update, delete). 

{   
"resourceClaimActions":
 {
     "read": true,
      "create": true,
      "update": true,
    "delete": true
  } 
}
HTTP response as documented below
v2/claimSets/{claimSetId}/resourceClaimActions/
{resourceClaimId}/overrideAuthStrategy


POST

Override the default authorization strategies on provided resource claim for a specific action.

ex: actionName = read,  authstrategyName=Ownershipbased

{
"actionName": string,
"authstrategyName: string
}

HTTP response as documented below

v2/claimSets/{claimSetId}/resourceClaimActions/
{resourceClaimId}/resetAuthStrategies

POST

Reset to default authorization strategies on provided resource claim.

-
HTTP response as documented below
v2/claimSets/{claimSetId}/
resourceClaimActions/{resourceClaimId}
DELETE

Deletes a resource claims association from a claim set

-
HTTP response as documented below
v2/claimSets/copy
POST

Copy the existing claimset and create new.

{
 "originalId": 0,
 "name": "string"
}
HTTP response as documented below


v2/claimSets/importPOST

Import new claimset 

{
  "name": "string",
  "resourceClaims": [
    {
      "name": "string",
      "read": true,
      "create": true,
      "update": true,
      "delete": true,     
      "authStrategyOverridesForCRUD": [
        {
"actionName": string, "authStrategies": [] } ], "children": [        "list of resource claims" ] } ] }
HTTP response as documented below

OdsInstances

 Click to view /odsInstances endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/odsInstances
GET

Retrieves all ODS Instances

-
[
{
  "id": 0
  "name": "string"
  "instanceType": "string"
  }
]

Profiles

 Click to view /profiles endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/profiles
GET

Retrieves all profiles

-
[
  {
  "id": 0,
  "name":string
  }
]
v2/profiles
POST

Creates a new profile

{
"name": "string",
"definition": "string"
}
HTTP response as documented below
v2/profiles/{id}
GET

Retrieves a specific profile by id 

-
{
  "id": 0,
"name":string,
"definition":string
}
v2/profiles/{id}
PUT

Updates a specific profile by id

{
"name": "string",
"definition": "string"
}
HTTP response as documented below
v2/profiles/{id}
DELETE

Deletes a profile by id 

-
HTTP response as documented below

ResourceClaims

 Click to view /resource claims endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/resourceClaims
GET

Retrieves all resourceclaims

-
[
{
  "id": 0
  "name": "string",
  "parentId": null,
  "parentName": "",
  "children": [
    {
  "id": 0
"name": "string",
"parentId": 0,
"parentName": "",
"children": []
}
  ]
}
]
v2/resourceClaims/{id}
GET

Retrieves a specific resource claim by id 

-
 {
  "id": 0
  "name": "string",
"parentId": null,
  "parentName": "",
  "children": [
{
    "id": 0
"name": "string",
"parentId": 0,
"parentName": "",
"children": []
}
  ]
}

Vendors

 Click to view /vendors endpoints
EndpointHTTP VerbDescriptionRequest SchemaResponse Schema (Success)
v2/vendors
GET

Retrieves all vendors

-
[
  {
  "id": 0,
    "company": "string",
    "namespacePrefixes": "string",
    "contactName": "string",
    "contactEmailAddress": "string"
  }
]
v2/vendors
POST

Creates a new vendor

{
"company": "string",
"namespacePrefixes": "string",
  "contactName": "string",
  "contactEmailAddress": "string"
}
HTTP response as documented below
v2/vendors/{id}
GET

Retrieves a specific vendor by id 

-
{
"id": 0,
  "company": "string",
  "namespacePrefixes": "string",
  "contactName": "string",
  "contactEmailAddress": "string"
}
v2/vendors/{id}
PUT

Updates a specific vendor by id

{
  "company": "string",
  "namespacePrefixes": "string",
  "contactName": "string",
  "contactEmailAddress": "string"
}
HTTP response as documented below
v2/vendors/{id}
DELETE

Deletes a vendor by id 

-
HTTP response as documented below
v2/vendors/{id}/applications
GETRetrieves all applications associated with vendor of id -
[
 {
"id": 0,
  "applicationName": "string",
"vendorId": 0,
  "claimSetName": "string",
"profileIds": [],
  "educationOrganizationIds": [],
"odsInstanceId": 0
}
]

Common Responses

Response Code

DescriptionValid for VerbsNotes
200 SUCCESS
Request was successfulALL
201 CREATED
Resource was created successfully

POST

Response will also include a location  header which directs to the new resource
400 BAD REQUEST
Invalid request payload - See errors for detailsPOST, PUT
401 UNAUTHORIZED
Missing or invalid authentication tokenALL
403 FORBIDDEN
Authentication token is valid but resource is outside of authenticated scopeALL
404 NOT FOUND
Resource with given id  not foundALL
500 INTERNAL SERVER ERROR
Unexpected error on the system - See error for detailsALL
  • No labels