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 ressource 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 ressource 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).
This specification puts together If nothing else is defined, address related information is always taken out of the [[billing address (ou=address,uid=<UID>,ou=resellers,dn=stoney core: Resellers Resource - REST API|Reseller frontend API]] and the [[stoney core: OpenLDAP directory data organisation|LDAP Data Backend]]cloud,dc=org).
= Resellers Resource Mapping =
* specifying a read-only attribut in a <code>PUT</code> or <code>PATCH</code> request is allowed as long as the value is the same as currently set
* the mapping applies to create (<code>POST</code>), read (<code>GET</code>) and update (<code>PATCH</code> or <code>PUT</code>). For delete (<code>DELETE</code>) the REST principles apply
* strings are encoded and stored in in UTF-8
** if an attribute in the backend does not support UTF-8 strings (attributes which permit ASCII/7-bit character encoding only), the attribute should not be exported via the API must generated from other fields and the internal transliteration should be done via POSIX iconv
Base DN: dc=stoney-cloud,dc=org
! LDAP Attribute
! Details
|-
| colspan=4 | [[stoney_core:_OpenLDAP_directory_data_organisation#Reseller_uid_.28per_Reseller.29 | Reseller uid (per Reseller)]]
|-
|| '''id''' || uid=4000000,ou=reseller || uid || Always read-only.
|-
|| isCompany || uid=4000000,ou=reseller || sstIsCompany || if isCompany is set to true, organizationName is/must be set and givenName and surname must be empty, otherwise givenName and surname are/must be set and organizationName must be empty
|-
|| isActive || uid=4000000,ou=reseller || sstIsActive ||
|-
|| organizationName resellerName || uid=4000000,ou=reseller || organizationName || unavailable if isCompany is true|-|| givenName || uid=4000000,ou=reseller || givenName || unavailable if isCompany is false|-|| surname || uid=4000000,ou=reseller || surname || unavailable if isCompany is false
|-
|| (none) || uid=4000000,ou=reseller || sstExternalID ||
|-
|| (none) || uid=4000000,ou=reseller || sstBelongsToResellerUID || Always Internally set equal to the same value as uid.
|-
|| (none) organizationName || ou=address,uid=4000000,ou=reseller || organizationName || Internally set to the same value as sstReseller's organizationName|-| colspan=4 | [[stoney_core:_OpenLDAP_directory_data_organisation#Reseller_Billing_Address | Reseller Billing Address]]
|-
|| address.gender || ou=address,uid=4000000,ou=reseller || sstGender ||
* the table below lists one entry in the collection/array/list to be returned
* additional attributes like pagination-headers, location attribute, etc. are not part of this spec but must be part of the final object, as per [[stoney core: Resellers Resource - REST API]]
* the attributes listed below are either needed for displaying the list of resellers or for displaying a reseller in the global full-text search results
Base DN: dc=stoney-cloud,dc=org
|| '''id''' || uid=4000000,ou=reseller || uid ||
|-
|| reseller resellerName || uid=4000000,ou=reseller || organizationName ''or'' givenName surname || <code>$sstIsCompany == TRUE ? "$organizationName" : "$givenName $surname"</code>
|-
|| contact contactGivenName || ou=address,uid=4000000,ou=reseller || givenName surname || <code>"$givenName $surname"</code>
|-
|| mail contactSurname || ou=address,uid=4000000,ou=reseller || mail surname ||
|-
|| phone contactMail || ou=address,uid=4000000,ou=reseller || mail |||-|| contactPhone || ou=address,uid=4000000,ou=reseller || telephoneNumber ''or'' mobileTelephoneNumber ''or'' (none) || both attributes are optional, therefore this attribute may not be available|-|| contactCountryCode || ou=address,uid=4000000,ou=reseller || countryCode |||-|| contactPostalCode || ou=address,uid=4000000,ou=reseller || postalCode |||-|| 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>
|}