Actions

History

Provisioning Management » History » Revision 23

« Previous | Revision 23/26 (diff) | Next »
jerome bonnet, 09/17/2015 04:45 PM

Table of contents
Provisioning Management - prov Method

Provisioning Management - prov Method¶

Provisionning Management allows a thirdParty Application to create, update, delete an account of FamilyWall, Set the member profile right, set member premium type and select/update the services enable for such user.

Search User - provsearch¶

This method returns the accountId of a Valid user by Identifiers (email, login or MSISDN)

By sending an HTTP request http://devserver/api/prov/search?identifier=test@gmail.com

Parameters:

Name	Type	Description
identifier	String	value of identifier to search for
type	Enum	Email,Msisdn,Login

Response:

{
  "a01":{
    "r":{
      "r":"12345" 
    },
    "cn":"provsearch" 
  }
}

The Method response is a Long which represents the AccountId of the account searched.

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizApiAccIdentifierInvalidException	Ex	21	Identifier has an invalid format
FizApiEmailInvalidException	Ex	17	Email has an invalid format
FizApiMsisdnInvalidException	Ex	22	MSISDN has an invalid format
FizAccountNotFoundException	Ex	1	account not found
FizApiInvalidParameterException	un	502	invalid token
FizApiUnattendedExceptionDefaultImpl	un	500	unattended error

Create Family - provcreatefamily¶

This method create a family with a founder member. A family cannot exist without at least one member, therefore founderId parameter is mandatory.

By sending an HTTP request http://devserver/api/prov/createfamily

Parameters:

Name	Type	Description
FamilyName	String	Name of the Family
FamilyImage	file	Binary file of Family image (optional)
founderId	Long	account id of the founder of this family

Response:

{
    a00 : {
        r : {
            r : {
                coverDefault :  false,
                family_id :  61,
                pictureDefault :  false,
                metaId :  family/61,
                members : [
                    {
                        familyId :  family/61,
                        joinDate :  2014-01-03T13:43:09.000Z,
                        role :  Dad,
                        metaId :  familymember/42_61,
                        isFirstFamily :  true,
                        lastLoginDate :  2015-09-16T14:46:10.000Z,
                        right :  SuperAdmin,
                        account : {
                            accountId :  42,
                            deleted :  false,
                            identifiers : [
                                {
                                    validated :  false,
                                    id :  63,
                                    type :  Login,
                                    value :  homersimpsontest
                                }
                            ],
                            name :  founder,
                            lastLoginDate :  2015-09-16T16:05:15.000Z,
                            creationDate :  2014-01-03T13:43:06.000Z,
                            termsChecked :  true
                        }
                    }
                ],
                name :  Simpson12,
                pictureUri :  http://localhost:8080/media/61_20ck56bl_43?,
                coverUri :  http://localhost:8080/media/61_8cz2k3bk_3222?
            }
        },
        cn :  provcreatefamily
}

The Method response is the created family.

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizApiInvalidParameterException	un	502	invalid token
FizApiUnattendedExceptionDefaultImpl	un	500	unattended error
FizAccountNotFoundException	Ex	1	account not found

Create Family - provfoundfamily¶

This method create both a user and a family. Because a family cannot exist without a founder and an account must be in at least one family, in order to avoid the chicken-and-egg problem, this api allows to create both objects at the same time.

By sending an HTTP request http://devserver/api/prov/foundfamily

Parameters:

Name	Type	Description
familyName	String	Name of the Family
familyImage	file	Binary file of Family image (optional)
type	Enum	Email,Msisdn,Login
identifier	String	User Identifier Email or MSISDN depending on the type
firstname	String	User First Name
locale	String	Country Code International as 2 letters language code as ISO 639 and 2 letters country code as ISO 3166 separated by an underscore or a dash.
picture	file	Binary file of picture for the user (optional)

Response:

{
    a00 : {
        r : {
            r : {
                coverDefault :  false,
                family_id :  61,
                pictureDefault :  false,
                metaId :  family/61,
                members : [
                    {
                        familyId :  family/61,
                        joinDate :  2014-01-03T13:43:09.000Z,
                        role :  Dad,
                        metaId :  familymember/42_61,
                        isFirstFamily :  true,
                        lastLoginDate :  2015-09-16T14:46:10.000Z,
                        right :  SuperAdmin,
                        account : {
                            accountId :  42,
                            deleted :  false,
                            identifiers : [
                                {
                                    validated :  false,
                                    id :  63,
                                    type :  Login,
                                    value :  homersimpsontest
                                }
                            ],
                            name :  founder,
                            lastLoginDate :  2015-09-16T16:05:15.000Z,
                            creationDate :  2014-01-03T13:43:06.000Z,
                            termsChecked :  true
                        }
                    }
                ],
                name :  Simpson12,
                pictureUri :  http://localhost:8080/media/61_20ck56bl_43?,
                coverUri :  http://localhost:8080/media/61_8cz2k3bk_3222?
            }
        },
        cn :  provfoundfamily
}

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizApiInvalidParameterException	un	502	invalid token
FizApiUnattendedExceptionDefaultImpl	un	500	unattended error
FizAccountAlreadyExistsException	Ex	2	Account Identifier already exists
FizApiAccIdentifierInvalidException	Ex	21	Identifier has an invalid format
FizApiEmailInvalidException	Ex	17	Email has an invalid format
FizApiMsisdnInvalidException	Ex	22	MSISDN has an invalid format

Update Family - provupdatefamily¶

This method update a family to change the name or picture of a family.

By sending an HTTP request http://devserver/api/prov/updatefamily?familyId=12345

Parameters:

Name

Type

Description

FamilyName	String	Name of the Family
familyId	Long	Family Id
FamilyImage	file	Binary file of Family image

Response:

{
    a00 : {
        r : {
            r : {
                coverDefault :  false,
                family_id :  61,
                pictureDefault :  false,
                metaId :  family/61,
                members : [
                    {
                        familyId :  family/61,
                        joinDate :  2014-01-03T13:43:09.000Z,
                        role :  Dad,
                        metaId :  familymember/42_61,
                        isFirstFamily :  true,
                        lastLoginDate :  2015-09-16T14:46:10.000Z,
                        right :  SuperAdmin,
                        account : {
                            accountId :  42,
                            deleted :  false,
                            identifiers : [
                                {
                                    validated :  false,
                                    id :  63,
                                    type :  Login,
                                    value :  homersimpsontest
                                }
                            ],
                            name :  founder,
                            lastLoginDate :  2015-09-16T16:05:15.000Z,
                            creationDate :  2014-01-03T13:43:06.000Z,
                            termsChecked :  true
                        }
                    }
                ],
                name :  Simpson12,
                pictureUri :  http://localhost:8080/media/61_20ck56bl_43?,
                coverUri :  http://localhost:8080/media/61_8cz2k3bk_3222?
            }
        },
        cn :  provupdatefamily
}

The Method response is the updated family.

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists

Delete Family - provdeletefamily¶

This method remove a family and all his contents. If the family have members, they are removed from the family. If, as a result from this operation, some members are left without a family, they are deleted, too.

By sending an HTTP request http://devserver/api/prov/deletefamily?familyId=12345

Parameters:

Name

Type

Description

familyId

Long

Family Id

Response:

{
  "a01":{
    "r":{
      "r":"true" 
    },
    "cn":"provdeletefamily" 
  }
}

The Method response is true when the operation is successful.

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists

Create Account - provcreateaccount¶

This method create a member for a family and set the member type (member=(0),adminsitrator=(1),founder=(2)). Note that after this method, the user receive an invitation email or an SMS with link to complete the account creation.

By sending an HTTP request http://devserver/api/prov/createaccount?type=Email&identifier=test@gmail.com
&accountType=2&locale=FR&familyId=12345&UserName=myFirstName&Locale=fr

Parameters:

Name	Type	Description
familyId	Long	Family Id where the member shall be added
type	Enum	Email,Msisdn,Login
identifier	String	User Identifier Email or MSISDN depending on the type
firstname	String	User First Name
locale	String	Country Code International as 2 letters language code as ISO 639 and 2 letters country code as ISO 3166 separated by an underscore or a dash.
accountType	Enum	Account Type (None,Admin,SuperAdmin) None=normal member, Admin=administrator
picture	file	Binary file of picture for the user (optional)

Response:

{
  "a01":{
    "r":{
      "r": {
                accountId :  42,
                deleted :  false,
                identifiers : [
                    {
                        validated :  false,
                        id :  63,
                        type :  Login,
                        value :  homersimpsontest
                    }
                ],
                name :  founder,
                lastLoginDate :  2015-09-16T16:05:15.000Z,
                creationDate :  2014-01-03T13:43:06.000Z,
                termsChecked :  true
            }
    },
    "cn":"provcreateaccount" 
  }
}

The Method response is a Long which represents the AccountId of the account created.

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists
FizAccountAlreadyExistsException	Ex	2	Account Identifier already exists
AFizInvalidIdentifierException	Ex	21	Identifier has an invalid format
AFizInvalidEmailException	Ex	17	Email has an invalid format
AFizInvalidMSISDNException	Ex	22	MSISDN has an invalid format

Update Account - provupdateaccount¶

This method update a member for a family and set the member type (member=(0),administrator=(1),founder=(2)).

By sending an HTTP request http://devserver/api/prov/updateaccount?locale=FR&UserName=myNewFirstName&Locale=fr&accountId=123455

Parameters:

Name	Type	Description
accountId	Long	Account Id of the modified account
UserName	String	User First Name
Locale	String	Country Code International Two letters
Picture	file	Binary file of picture for the user (optional)

Response:

{
  "a01":{
    "r":{
      "r": {
                            accountId :  42,
                            deleted :  false,
                            identifiers : [
                                {
                                    validated :  false,
                                    id :  63,
                                    type :  Login,
                                    value :  homersimpsontest
                                }
                            ],
                            name :  founder,
                            lastLoginDate :  2015-09-16T16:05:15.000Z,
                            creationDate :  2014-01-03T13:43:06.000Z,
                            termsChecked :  true
                        }
    },
    "cn":"provupdateaccount" 
  }
}

The Method response is a Long which represents the AccountId of the account updated.

In case, the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizAccountNotFoundException	Ex	1	account not found

Add Account to family- provaddaccount2family¶

This method add an existing account to a family and set the member type (member=(0),administrator=(1),founder=(2)).

By sending an HTTP request http://devserver/api/prov/addaccount2family?accountId=123455&familyId=333445

Parameters:

Name	Type	Description
accountId	Long	Account Id where the member shall added
familyId	Long	Family Id where the member shall be added
AccountType	Long	Account Type (None,Admin,SuperAdmin) None=normal member, Admin=administrator

Response:

{
  "a01":{
    "r":{
      "r":"true" 
    },
    "cn":"provupdateaccount" 
  }
}

The Method response is true when the operation is successful.

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists
FizAccountNotFoundException	Ex	1	account not found
FizAccountAlreadyInThisFamilyException	Ex	12	ccount already in the family

Remove Account from family- provremoveaccount2family¶

This method remove an existing account from a family.

By sending an HTTP request http://devserver/api/prov/removeaccount2family?accountId=123455&familyId=333445

Parameters:

Name	Type	Description
accountId	Long	Account Id of the user to be removed from the family
familyId	Long	Family Id of the family from which the user shall be removed from

Response:

{
  "a01":{
    "r":{
      "r":"true" 
    },
    "cn":"provupdateaccount" 
  }
}

The Method response is true when the operation is successful.

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists
FizAccountNotFoundException	Ex	1	account not found

Delete Account provdeleteaccount¶

This method delete an existing account. It will be removed from all his families beforehand. Families without remaining members are definitively deleted.

By sending an HTTP request http://devserver/api/prov/deleteaccount?accountId=123455

Parameters:

Name	Type	Description
accountId	Long	Family Id where the member shall added

Response:

{
  "a01":{
    "r":{
      "r":"true" 
    },
    "cn":"provupdateaccount" 
  }
}

The Method response is true when the operation is successful.

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizAccountNotFoundException	Ex	1	account not found

get Account information provgetaccount¶

This method returns the information about an existing account.

By sending an HTTP request http://devserver/api/prov/getaccount?accountId=123455

Parameters:

Name	Type	Description
accountId	Long	Account Id of the account

Response:

{
  "a01":{
    "r":{
      "r": {
                accountId :  42,
                deleted :  false,
                identifiers : [
                    {
                        validated :  false,
                        id :  63,
                        type :  Login,
                        value :  homersimpsontest
                    }
                ],
                name :  founder,
                lastLoginDate :  2015-09-16T16:05:15.000Z,
                creationDate :  2014-01-03T13:43:06.000Z,
                termsChecked :  true
            }
    },
    "cn":"provgetaccount" 
  }
}

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizAccountNotFoundException	Ex	1	account not found

get family information provgetfamily¶

This method returns the information about an existing family, mainly all the members.

By sending an HTTP request http://devserver/api/prov/getfamily?familyId=123455

Parameters:

Name	Type	Description
familyId	Long	Family Id of the family

Response:

{
    a00 : {
        r : {
            r : {
                coverDefault :  false,
                family_id :  61,
                pictureDefault :  false,
                metaId :  family/61,
                members : [
                    {
                        familyId :  family/61,
                        joinDate :  2014-01-03T13:43:09.000Z,
                        role :  Dad,
                        metaId :  familymember/42_61,
                        isFirstFamily :  true,
                        lastLoginDate :  2015-09-16T14:46:10.000Z,
                        right :  SuperAdmin,
                        account : {
                            accountId :  42,
                            deleted :  false,
                            identifiers : [
                                {
                                    validated :  false,
                                    id :  63,
                                    type :  Login,
                                    value :  homersimpsontest
                                }
                            ],
                            name :  founder,
                            lastLoginDate :  2015-09-16T16:05:15.000Z,
                            creationDate :  2014-01-03T13:43:06.000Z,
                            termsChecked :  true
                        }
                    }
                ],
                name :  Simpson12,
                pictureUri :  http://localhost:8080/media/61_20ck56bl_43?,
                coverUri :  http://localhost:8080/media/61_8cz2k3bk_3222?
            }
        },
        cn :  provgetfamily
}

In case the method encounter any error, the response is an exception with specific parameters detailed below.

Error:

Error Code	Type	Value	Description
FizFamilyDoesNotExistException	Ex	510	Family Id Does not Exists
FizAccountNotFoundException	Ex	1	account not found

Files (0)

Updated by jerome bonnet about 10 years ago · 23 revisions

Project

General

Profile

FamilyWall API

Wiki

Provisioning Management » History » Revision 23

Provisioning Management - prov Method¶

Search User - provsearch¶

Create Family - provcreatefamily¶

Create Family - provfoundfamily¶

Update Family - provupdatefamily¶

Delete Family - provdeletefamily¶

Create Account - provcreateaccount¶

Update Account - provupdateaccount¶

Add Account to family- provaddaccount2family¶

Remove Account from family- provremoveaccount2family¶

Delete Account provdeleteaccount¶

get Account information provgetaccount¶

get family information provgetfamily¶