Organization Logo Data by Organization ID
Overview
This API returns logo data configured for the requested Organization ID from the EZ Config Default Data application. This API is available for direct use, but the intended use case flow is for Expere Document Services (with or without usage of an EZ Config Packages and Packet Package) to use this API to obtain the logo configuration and be able to apply the logo when generating documents.
Request
| Method | URL | Description |
|---|---|---|
| GET | https://<hostname>/DefaultData/api/v1/integration/accounts/{accountId}/organizations/{organizationId}/logo | Used to pass in the accountId and organizationId to retrieve logo configuration data added as part of the Organization Policy setup in EZ Config Default Data. |
| Name | Type | Constraints | Description |
|---|---|---|---|
| accountId | integer | required | The "accountId" parameter is used to validate the user credentials provided have permission to the account provided. If the account value provided does not have permission, the response will return Http Status Code 403 (Forbidden). |
| organizationId | string | required | The "OrganizationId" parameter retrieves the logo configuration data for the organization requested that is associated with the account. |
Response
The response returns the logo configuration data defined in Default Data for the OrganizationId requested.
Response Message: the response message displays an HTTP Status Code of either 200, 401, 404, or 500 with the respective Reason.
| HTTP Status Code | Reason | Response Model | Headers |
|---|---|---|---|
| 200 | Success |
Response Body: provides the image, justification,
placement, heightInInches, and widthInInches parameters within the response.
{
"image": "BASE64VALUEOFLOGOIMAGEFILE”,
"justification": "Center",
"placement": "FirstPageOnly",
"heightInInches": .75
"widthInInches": 1.25
}
Response Code: provides the user with the appropriate HTTP status code based on the request:
200
Response Headers: the response header provides
cache-control: no-store,no-cache content-type: application/json; charset=utf-8 date: Fri, 30 Aug 2019 13:50:02 GMT pragma: no-cache server: Kestrel transfer-encoding": "chunked", x-frame-options: SAMEORIGIN x-powered-by: ASP.NET