Table of Contents

API : Integration : Uniconta Validate Reseller

Introduction

This request checks that a set of Uniconta credentials is accepted by Uniconta.

When username, password and companyId are all given in the body, those credentials are tested. When any of them is left out, the credentials stored on the reseller's Uniconta integration are tested instead.

Request

URL https://api.telecomx.dk/integration/uniconta/validate/reseller
Method POST
Access level RESELLER for their own customer.
RESELLER_ADMIN or ADMIN for any reseller.
Body reseller Id [optional] Id of the reseller whose stored credentials are tested. Only used for RESELLER_ADMIN and ADMIN, defaults to the user's own customer
username String [optional] Username in Uniconta, max. 512 characters
password String [optional] Password in Uniconta, max. 512 characters
companyId String [optional] Company id in Uniconta, max. 64 characters

Query example

POST https://api.telecomx.dk/integration/uniconta/validate/reseller

Body example

{
  "username": "<USERNAME>",
  "password": "<PASSWORD>",
  "companyId": "12345"
}

Response

Json object
success Boolean True when Uniconta accepted the credentials

Example

{
  "success": true
}

Errors

Error code Message Description
422 <property> Invalid input for the named property - the request body, query or URL parameter failed validation
403 access_denied Insufficient access level
403 uniconta The integration is not valid.
404 reseller Reseller not found
500 internal_error <Unspecified>