2. Security
2.1. oauth2_password
Type : oauth2
Flow : password
Token URL : https://localhost:9002/authorizationserver/oauth/token
Name |
---|
basic |
2.2. oauth2_client_credentials
Type : oauth2
Flow : application
Token URL : https://localhost:9002/authorizationserver/oauth/token
Name |
---|
extended |
3. Resources
3.1. Party Role
Pr Party Role Controller
3.1.1. Creates a PartyRole
POST /partyRole
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
No Content |
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.2. List or find PartyRole objects
GET /partyRole
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Query |
fields |
Comma-separated properties to be provided in response |
string |
Query |
limit |
Requested number of resources to be provided in response |
integer(int32) |
Query |
name |
For filtering: The name of PartyRole |
string |
Query |
offset |
Requested index for start of resources to be provided in response |
integer(int32) |
Query |
status |
For filtering: The status of PartyRole |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
< PartyRole > array |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.3. Retrieves a PartyRole by ID
GET /partyRole/{id}
Description
This operation retrieves a PartyRole entity. Attribute selection is enabled for all first level attributes.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the PartyRole |
string |
Query |
fields |
Comma-separated properties to provide in response |
string |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Success |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.4. Deletes a PartyRole
DELETE /partyRole/{id}
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
OK |
No Content |
204 |
Deleted |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
3.1.5. Updates partially a PartyRole
PATCH /partyRole/{id}
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path |
id |
Identifier of the PartyRole |
string |
Body |
partyRole |
The PartyRole to be updated |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Updated |
|
204 |
No Content |
No Content |
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not allowed |
|
409 |
Conflict |
|
500 |
Internal Server Error |
4. Definitions
4.1. AccountRef
Account reference. A account may be a party account or a financial account.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
description |
Detailed description of the account |
string |
href |
Reference of the account |
string |
id |
Unique identifier of the account |
string |
name |
Name of the account |
string |
4.2. AgreementRef
Agreement reference. An agreement represents a contract or arrangement, either written or verbal and sometimes enforceable by law, such as a service level agreement or a customer price agreement. An agreement involves a number of other business entities, such as products, services, and resources and/or their specifications.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the agreement |
string |
4.3. Characteristic
Describes a given characteristic of an object or entity through a name/value pair.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
name |
Name of the characteristic |
string |
value |
The value of the characteristic |
object |
valueType |
Data type of the value of the characteristic |
string |
4.4. ContactMedium
Indicates the contact medium that could be used to contact the party.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
characteristic |
Any additional characteristic(s) of this contact medium |
|
mediumType |
Type of the contact medium, such as: email address, telephone number, postal address |
string |
preferred |
If true, indicates that is the preferred contact medium |
boolean |
validFor |
The time period that the contact medium is valid for |
4.5. CreditProfile
Credit profile for the party (containing credit scoring, …). By default only the current credit profile is retrieved. It can be used as a list to give the party credit profiles history, the first one in the list will be the current one.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
creditProfileDate |
The date the profile was established |
string(date-time) |
creditRiskRating |
This is an integer whose value is used to rate the risk |
integer(int32) |
creditScore |
A measure of a person or organizations creditworthiness calculated on the basis of a combination of factors such as their income and credit history |
integer(int32) |
validFor |
The period for which the profile is valid |
4.6. Error
Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx)
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name. |
string |
code |
Application relevant detail, defined in the API or a common list. |
string |
message |
More details and corrective actions related to the error which can be shown to a client user. |
string |
reason |
Explanation of the reason for the error which can be shown to a client user. |
string |
referenceError |
URI of documentation describing the error. |
string |
status |
HTTP Error code extension |
string |
4.7. MediumCharacteristic
Describes the contact medium characteristics that could be used to contact a party (an individual or an organization)
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
city |
The city |
string |
contactType |
The type of contact, for example: phone number such as mobile, fixed home, fixed office. postal address such as shipping instalation… |
string |
country |
The country |
string |
emailAddress |
Full email address in standard format |
string |
faxNumber |
The fax number of the contact |
string |
phoneNumber |
The primary phone number of the contact |
string |
postCode |
Postcode |
string |
socialNetworkId |
Identifier as a member of a social network |
string |
stateOrProvince |
State or province |
string |
street1 |
Describes the street |
string |
street2 |
Complementary street description |
string |
4.8. PartyRole
The part played by a party in a given context.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
account |
< AccountRef > array |
|
agreement |
< AgreementRef > array |
|
characteristic |
Describes the characteristic of a party role. |
< Characteristic > array |
contactMedium |
< ContactMedium > array |
|
creditProfile |
< CreditProfile > array |
|
engagedParty |
||
href |
Url used to reference the party role. |
string |
id |
Unique identifier for PartyRoles |
string |
name |
A word, term, or phrase by which the PartyRole is known and distinguished from other PartyRoles. |
string |
paymentMethod |
< PaymentMethodRef > array |
|
relatedParty |
< RelatedParty > array |
|
status |
Used to track the lifecycle status of the party role. |
string |
statusReason |
A string providing an explanation on the value of the status lifecycle. For instance if the status is Rejected, statusReason will provide the reason for rejection. |
string |
validFor |
The time period that the PartyRole is valid for. |
4.9. PaymentMethodRef
PaymentMethod reference. A payment method defines a specific mean of payment (e.g direct debit).
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the payment mean |
string |
id |
Unique identifier of the payment mean |
string |
name |
Name of the payment mean |
string |
4.10. RelatedParty
Related Entity reference. A related party defines party or party role linked to a specific entity.
Name | Description | Schema |
---|---|---|
@baseType |
When sub-classing, this defines the super-class |
string |
@referredType |
The actual type of the target instance when needed for disambiguation. |
string |
@schemaLocation |
A URI to a JSON-Schema file that defines additional attributes and relationships |
string |
@type |
When sub-classing, this defines the sub-class entity name |
string |
href |
Reference of the related entity. |
string |
id |
Unique identifier of a related entity. |
string |
name |
Name of the related entity. |
string |
role |
Role played by the related party |
string |
4.11. TimePeriod
A period of time, either as a deadline (endDateTime only) a startDateTime only, or both
Name | Description | Schema |
---|---|---|
endDateTime |
End of the time period, using IETC-RFC-3339 format |
string(date-time) |
startDateTime |
Start of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an end |
string(date-time) |