Content Comparison

POST

/sendInvoice

Sends UBL invoice via email to specified addresses. Returns a communication report informing user of success/errors: if unsuccessful, the report has errors (eg. email address invalid, connection not etablished etc.). It also includes address, client, time/date. It will be readable for humans to understand. Should also save a record of the transaction

Header:

deliveryAddresses (List<String>)

Body{

token : (String)

}

File:

invoice (UBL 2.1 XML)

communicationReport (JSON)

{

"sentMail": (boolean),

"readable_errors": (string),

"xmlFound": (boolean),

"xmlRightSize": (boolean),

"emailValid": (boolean),

"connectedToMail": (boolean),

"sentMailtimeSent": (booleandatetime),

"timeTaken": (integerint)

}

400 errors:

• Invalid/Missing email address

• No XML invoice

403 errors:

• Invalid token

413 errors:

• XML invoice >10MB

GET

/HealthCheck

Health check endpoint that indicates the aliveness of this service. Gives information about success, server up time, number of transactions and current version.

None

{

alive: (boolean)

serverUpTime: (Integer)

numTransactions: (Integer)

numSuccess: (Integer)

currentVersion: (String)

}

None

GET POST

/newsessionnewSession

Returns a new token for user to use for this session. Tokens will expire after a set amount of inactivity.

{

username : (String)

password : (String)

}

{

token : (String)

}None

400 errors:

• Invalid email

• Invalid password

POST

/CreateNewUsercreateNewUser

allows creates a new user to be created for

email

username

password

name

200 on success

500 on failaccount with a given email, name, username and password. The set username and password will be used when calling /newsession. Username and password name must be between (and including) 5-100 characters long. Username must also be unique.

{

email : (String)

username : (String)

password : (String)

}

{

success: (boolean)

}

400 errors:

• Invalid email

• Email already in use

• Invalid username

• Username already in use

• Invalid password

POST

/endSession

revokes the token given to the endpoint. This should be used by all users on their servers shutdown. Sessions are automatically deleted after an hour.

{

token : (String)

}

None

403 errors:

• Invalid token