Also visit [[stoney core: Resellers Resource - REST API]].
= Overview =
The resellers resource mapping describes the business logic behind the LDAP to JSON transformation and visa versa for the request and response objects. The actual resellers resource REST API is located in the [[:Category:REST API|REST API]] category and is named [[stoney core: Resellers Resource - REST API]].
Principles:
* for For the resource objects there is most of the time a one-to-one mapping between LDAP attributes and JSON object.* for For collections only a subset of the resource object attributes will be returned which may be also be merged or otherwise mangled.
This specification puts together the [[stoney core: Resellers Resource - REST API|Reseller frontend API]] (stoney core: Resellers Resource - REST API) and the [[stoney core: OpenLDAP directory data organisation|LDAP Data Backend]] (stoney core: OpenLDAP directory data organisation).
If nothing else is defined, address related information is always taken out of the billing address (ou=address,uid=<UID>,ou=resellers,dn=stoney-cloud,dc=org).
= Resellers Resource Mapping =
|-
|| contactLocalityName || ou=address,uid=4000000,ou=reseller || localityName ||
|}
= Reseller retrieval (GET) =
== Reseller collection retrieval (GET) ==
=== Reseller collection retrieval (GET) Mapping ===
== Reseller element retrieval (GET) ==
The following sequence describes the reseller element retrieval:
# Look-up the reseller in the OpenLDAP directory in the '''ou=reseller,dc=stoney-cloud,dc=org''' sub tree (with a configurable LDAP service user): ...
# Billing address ''' ou=address,uid=<UID>,ou=reseller,dc=stoney-cloud,dc=org''' (mandatory)
# Shipping '''ou=shipping,uid=4000000,ou=reseller,dc=stoney-cloud,dc=org''' contains the shipping address and is optional (it is only needed, if the shipping address differs from the billing Address).
=== Reseller element retrieval (GET) Mapping ===
{| border="1" class="wikitable sortable"
! API Attribute
! LDAP Attribute
|-
| id
| uid
|-
= Reseller deletion (DELETE) =
TBD: Describe, what to check before a reseller can be deleted (no customers, no people and later no services).
Probably: <code>sstBelongsToResellerUID</code>
|}