Viviot.Api

<back to all web services

GetProviders

Requires Authentication
Requires any of the roles:Admin, TenantAdmin, MarketplaceAdmin
The following routes are available for this service:
GET/providersGets a list of all supported providers by provider type.
GetProviders Parameters:
NameParameterData TypeRequiredDescription
ProviderTypequeryProviderTypeYesProvider type (payment, invoicing etc.)

Allowable Values

  • Payment
  • Invoicing
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
VersionformintegerNoApi version
ProviderType Enum:
NameValue
Payment1
Invoicing2
ProvidersResponse Parameters:
NameParameterData TypeRequiredDescription
DataformList<ProviderView>No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
ProviderView Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
OrganizationIdformGuidNo
NameformstringNo
DescriptionformstringNo
TypeformProviderTypeNo
ConfigurationformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /providers HTTP/1.1 
Host: api.4spaces.io 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	data: 
	[
		{
			id: 00000000000000000000000000000000,
			organizationId: 00000000000000000000000000000000,
			name: String,
			description: String,
			type: 1,
			configuration: String
		}
	],
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}