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 2
Next »
Endpoint URLs and Schemas
Response Wrapper Schema
Responses with a body have a common "wrapper" around their result object (which may be empty) or a collection of errors.
These wrappers are not reflected in the below documentation. Assume they are the contents of result when successful.
Click to view response wrappers
| Response | Codes | Schema |
|---|
| Success | 200,201 | {
"status": 0,
"title": "string",
"result": object?
} |
|---|
| Error | 500,404,401,403 | {
"status": 0,
"title": "string",
"errors": [ "string" ]
} |
|---|
| Validation Error | 400 | {
"status": 0,
"title": "string",
"errors": [
{ "string": [ "string" ] }
]
} |
|---|
Vendors
Click to view /vendors endpoints
| Endpoint | HTTP Verb | Description | Request Schema | Response Schema (Success) |
|---|
v1/vendors/ | GET | Retrieves all vendors | - | [
{
"vendorId": 0,
"company": "string",
"namespacePrefixes": "string",
"contactName": "string",
"contactEmailAddress": "string"
}
] |
|---|
v1/vendors/{id} | GET | Retrieves a specific vendor by id | - |
|
|---|
v1/vendors/ | POST | Creates a new vendor | {
"company": "string",
"namespacePrefixes": "string",
"contactName": "string",
"contactEmailAddress": "string"
}
| {
"vendorId": 0,
"company": "string",
"namespacePrefixes": "string",
"contactName": "string",
"contactEmailAddress": "string"
} |
|---|
v1/vendors/{id} | PUT | Updates a specific vendor by id | {
"company": "string",
"namespacePrefixes": "string",
"contactName": "string",
"contactEmailAddress": "string"
} | {
"vendorId": 0,
"company": "string",
"namespacePrefixes": "string",
"contactName": "string",
"contactEmailAddress": "string"
} |
|---|
v1/vendors/{id} | DELETE | Deletes a vendor by id | - | - |
|---|
v1/vendors/{id}/applications | GET | Retrieves all applications associated with vendor of id | - | [
{
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
}
] |
|---|
Claimsets
Click to view /claimsets endpoints
| Endpoint | HTTP Verb | Description | Request Schema | Response Schema (Success) |
|---|
v1/claimsets/ | GET | Retrieves all claimsets | - | [ "string" ] |
|---|
Applications
Click to view /applications endpoints
| Endpoint | HTTP Verb | Description | Request Schema | Response Schema (Success) |
|---|
v1/applications/ | GET | Retrieves all applications | -| | [
{
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
}
] |
|---|
v1/applications/{id} | GET | Retrieves a specific application by id | - | {
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
} |
|---|
v1/applications/ | POST | Creates a new application | {
"applicationName": "string",
"vendorId": 0,
"claimSetName": "string",
"profileId": 0,
"educationOrganizationIds": [
0
]
} | {
"applicationId": 0,
"key": "string",
"secret": "string"
} |
|---|
v1/applications/{id} | PUT | Updates a specific application by id | {
"applicationId": 0,
"applicationName": "string",
"vendorId": 0,
"claimSetName": "string",
"profileId": 0,
"educationOrganizationIds": [ 0 ]
} | {
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
} |
|---|
v1/applications/{id} | DELETE | Deletes an application by id | - | - |
|---|
v1/applications/{id}/reset-credential | PUT | Resets an application credentials by id | - | {
"applicationId": 0,
"key": "string",
"secret": "string"
} |
|---|
Common Responses
Response Code | Description | Valid for Verbs | Notes |
|---|
200 SUCCESS | Request was successful | ALL |
|
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 details | POST, PUT |
|
401 UNAUTHORIZED | Missing or invalid authentication token | ALL |
|
403 FORBIDDEN | Authentication token is valid but resource is outside of authenticated scope | ALL |
|
404 NOT FOUND | Resource with given id not found | ALL |
|
500 INTERNAL SERVER ERROR | Unexpected error on the system - See error for details | ALL |
|
Click to view /vendors endpoints
| Endpoint | HTTP Verb | Description | Request Schema | Response Schema (Success) |
|---|
v1/applications/ | GET | Retrieves all applications | - | [
{
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
}
] |
|---|
v1/applications/{id} | GET | Retrieves a specific application by id | - | {
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
} |
|---|
v1/applications/ | POST | Creates a new application | {
"applicationName": "string",
"vendorId": 0,
"claimSetName": "string",
"profileId": 0,
"educationOrganizationIds": [
0
]
} | {
"applicationId": 0,
"key": "string",
"secret": "string"
} |
|---|
v1/applications/{id} | PUT | Updates a specific application by id | {
"applicationId": 0,
"applicationName": "string",
"vendorId": 0,
"claimSetName": "string",
"profileId": 0,
"educationOrganizationIds": [ 0 ]
} | {
"applicationId": 0,
"applicationName": "string",
"claimSetName": "string",
"profileName": "string",
"educationOrganizationId": 0,
"odsInstanceName": "string"
} |
|---|
v1/applications/{id} | DELETE | Deletes an application by id | - | - |
|---|
v1/applications/{id}/reset-credential | PUT | Resets an application credentials by id | - | {
"applicationId": 0,
"key": "string",
"secret": "string"
} |
|---|