Discussion

Get the accessToken.

Discussion

Get created date.

Discussion

Get disabled status of the thing.YES if the thing is disabled, NO otherwise.

Discussion

Set and get firmwareVersion.

Discussion

Set and get the lot.

Discussion

Set and get the numberField1.

Discussion

Set and get the numberField2.

Discussion

Set and get the numberField3.

Discussion

Set and get the numberField4.

Discussion

Set and get the numberField5.

Discussion

Get online status of the thing. NSNumber boolean represenetation. The value will be nil initially until the thing is connected for the first time. If not nil and converted to BOOL, YES if the thing is online, NO otherwise.

Discussion

Get online status modified date of the thing. The date will be nil initially until the thing is connected for the first time.

Discussion

Set and get productName.

Discussion

Set and get the stringField1.

Discussion

Set and get the stringField2.

Discussion

Set and get the stringField3.

Discussion

Set and get the stringField4.

Discussion

Set and get the stringField5.

Discussion

Get the thingID.

Discussion

Set and get thingType.

Discussion

Set and get vendor.

Discussion

Get the vendorThingID.

Discussion

Synchronously load registered thing in Kii Cloud by using thingID. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

Discussion

Synchronously load registered thing in Kii Cloud by using vendorThingID. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

Discussion

Asynchronously load registered thing in Kii Cloud by using thingID. This method is non-blocking version of [KiiThing loadSynchronousWithThingID:error:]

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

Successful operation will return an instance in a block parameter.

[KiiThing loadWithThingID:thingID
                    block:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing loaded: %@", thing);
        }
}];

Discussion

Asynchronously load registered thing in Kii Cloud by using vendorThingID. This method is non-blocking version of [KiiThing loadSynchronousWithVendorThingID:error:]

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

Successful operation will return an instance in a block parameter.

[KiiThing loadWithVendorThingID:vendorThingID
                          block:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing loaded: %@", thing);
        }
}];

Discussion

Asyncronously execute thing query. The query operation returns a list of KiiThing that matches the query expression. Thing in the list does not contain all the property of thing. To get all the property from cloud, a refresh: is necessary. This method is a non-blocking version of [KiiThing querySynchronous:error:]

 [aThing query:aThingQuery block:^(KiiThingQueryResult *queryResult, NSError *error){

     if(error == nil) {
         NSLog(@"Got Results: %@", results);
         NSLog(@"Total result %@", queryResult.results.count);
         NSLog(@"Has Next: %@ next", queryResult.hasNext?@"Yes":@"No");
     }
 }];

Discussion

Syncronously execute thing query. The query operation returns a list of KiiThing that matches the query expression. Thing in the list does not contain all the property of thing. To get all the property from cloud, a refresh: is necessary. This is non blocking operation.

Discussion

Asynchronous version of [KiiThing registerOwnerSynchronous:thingID:error:].

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Successful operation will return an instance in a block parameter.

[KiiThing registerOwner:owner
                thingID:@"YourThingID"
                  block:^(KiiThingOwner *owner, NSError *error) {
                      if(error == nil) {
                          NSLog(@"Thing owner registered: %@", owner);
                      }
}];

Discussion

Asynchronous version of [KiiThing registerOwnerSynchronous:thingID:thingPassword:error:].

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Successful operation will return an instance in a block parameter.

[KiiThing registerOwner:owner thingID:@“YourThingID” thingPassword: thingPassword block:^(KiiThingOwner owner, NSError error) { if(error == nil) { NSLog(@“Thing owner registered: %@”, owner); } }];

Discussion

Asynchronous version of [KiiThing registerOwnerSynchronous:vendorThingID:error:].

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Successful operation will return an instance in a block parameter.

[KiiThing registerOwner:owner
          vendorThingID:@"YourVendorhingID"
                  block:^(KiiThingOwner *owner, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing owner registered: %@", owner);
        }
}];

Discussion

Asynchronous version of [KiiThing registerOwnerSynchronous:vendorThingID:thingPassword:error:].

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Successful operation will return an instance in a block parameter.

[KiiThing registerOwner:owner vendorThingID:@“YourVendorhingID” thingPassword: thingPassword block:^(KiiThingOwner owner, NSError error) { if(error == nil) { NSLog(@“Thing owner registered: %@”, owner); } }];

Discussion

Register owner of specified thing. This is a blocking method.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

This api is authorized by owner of the Thing.

Need user login before execute this API.

NOTE: This api access to server. Should not be executed in UI/Main thread.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Discussion

Register owner of specified thing. This is a blocking method.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

This api is authorized by owner of the Thing.

Need user login before execute this API.

NOTE: This api access to server. Should not be executed in UI/Main thread.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Discussion

Register owner of specified thing. This is a blocking method.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

This api is authorized by owner of the Thing.

Need user login before execute this API.

NOTE: This api access to server. Should not be executed in UI/Main thread.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Discussion

Register owner of specified thing. This is a blocking method.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

This api is authorized by owner of the Thing.

Need user login before execute this API.

NOTE: This api access to server. Should not be executed in UI/Main thread.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.
• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

Discussion

Asynchronously register thing in Kii Cloud using block. This method is non-blocking version of [KiiThing registerThingSynchronous:password:type:fields:error:]

[KiiThing registerThing: vendorThingID
               password: password
                   type: thingType
                 fields: thingFields
                  block:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing registered: %@", thing);
        }
}];

Discussion

Synchronously register thing in Kii Cloud. This is blocking method.
It doesn’t require user login. Anonymous user can register thing.

Discussion

Create a KiiThing that refers to existing thing which has specified ID. You have to specify the ID of existing KiiThing. Unlike KiiObject, you can not assign ID in the client side. After instantiation, call [KiiThing refresh:] to fetch the properties.

Discussion

Get or create a bucket at the thing level

Discussion

Asynchronously check if user/group is owner of the thing. This method is non-blocking version of checkIsOwnerSynchronous:error:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

Checks ownership of the thing from specified user/ group.

[aThing checkIsOwner:thingOwner block:^(KiiThing *thing, id<KiiThingOwner> thingOwner, BOOL isOwner, NSError *error) {
    if(error == nil) {
        NSLog(@"%@ is %@ the owner" , thingOwner.thingOwnerID,isOwner?@"":@"not");
    }
}];

Discussion

Synchronously check if user/ group is owner of the thing. This is blocking method.
This API is authorized by owner of thing.
Need user login before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

Discussion

Asynchronously deletes the Thing from the server.

Discussion

Synchronously deletes the Thing from the server. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

It will delete bucket, topic which belongs to this thing, entity belongs to the bucket/topic and all ownership information of thing. This operation can not be reverted. Please carefully use this.

Discussion

Asynchronously deletes the Thing from the server. This method is non-blocking version of deleteSynchronous:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

It will delete bucket, topic which belongs to this thing, entity belongs to the bucket/topic and all ownership information of thing. This operation can not be reverted. Please carefully use this. This is a non-blocking method.

[aThing deleteWithBlock:^(KiiThing *thing, NSError *error) {
    if(error != nil) {
        // Handle error
        return;
    }
    // thing has been deleted.
}];

Discussion

Asynchronously disable the thing in Kii Cloud. This method is a non-blocking version of disableSynchronous:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

After succeeded, access token published for thing is disabled. In a result, only the app administrator and owners of thing can access the thing. Used when user lost the thing and avoid using by unknown users. It doesn’t throw error when the thing is already disabled.

[aThing disable:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing is disabled: %@", thing);
        }
}];

Discussion

Synchronously disable the thing in Kii Cloud. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

After succeeded, access token published for thing is disabled. In a result, only the app administrator and owners of thing can access the thing. Used when user lost the thing and avoid using by unknown users. It doesn’t throw error when the thing is already disabled.

Discussion

Asynchronously enable the thing in Kii Cloud. This method is non-blocking version of enableSynchronous:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

After succeeded, If thing is registered with “persistentToken” option, token should be recovered (Access token which is used before disabling can be available). Otherwise, it does not recovered.

It doesn’t throw error when the thing is already enabled.

[aThing enable:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing is enabled: %@", thing);
        }
}];

Discussion

Synchronously enable the thing in Kii Cloud. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

After succeeded, If thing is registered with “persistentToken” option, token should be recovered (Access token which is used before disabling can be available). Otherwise, it does not recovered.

It doesn’t throw error when the thing is already enabled.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

Discussion

Get or create an thing scope encrypted bucket.

Discussion

Returns the topics in this thing scope asynchronously.

Receives a KiiListResult object representing list of topics. This is a non-blocking request.

[aThing listTopics:^(KiiListResult *topics, id callerObject, NSError *error){
   //at this scope, callerObject should be KiiThing instance
   NSLog(@"%@",callerObject);
   if(error == nil) {
        NSLog(@"Got Results: %@", topics);
        NSLog(@"Total topics: %@", topics.results.count);
        NSLog(@"Has Next: %@ next paginationKey: %@", topics.hasNext?@"Yes":@"No", topics.paginationKey);
        KiiTopic *firstTopic = topics.result.firstObject;
        if (firstTopic){
            NSLog(@"topic name :%@", firstTopic.name);
        }
   }
}];

Discussion

Returns the topics in this thing scope asynchronously.

Receives a KiiListResult object representing list of topics. This is a non-blocking request.

[aThing listTopics:paginationKey block:^(KiiListResult *topics, id callerObject, NSError *error){
   //at this scope, callerObject should be KiiThing instance
   NSLog(@"%@",callerObject);
   if(error == nil) {
        NSLog(@"Got Results: %@", topics);
        NSLog(@"Total topics: %@", topics.results.count);
        NSLog(@"Has Next: %@ next paginationKey: %@", topics.hasNext?@"Yes":@"No", topics.paginationKey);
        KiiTopic *firstTopic = topics.result.firstObject;
        if (firstTopic){
            NSLog(@"topic name :%@", firstTopic.name);
        }
   }
}];

Discussion

Returns the topics in this Thing scope. This is blocking method.

Discussion

Returns the topics in this thing scope. This is blocking method.

Discussion

Get or create a push subscription for the thing.

Discussion

Asynchronously updates the local Thing’s data with the Thing data on the server. This method is non-blocking version of refreshSynchronous:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

The Thing must exist on the server. Local data will be overwritten.

[aThing refresh:^(KiiThing *thing, NSError *error) {
    if(error == nil) {
        NSLog(@"Thing refreshed: %@", thing);
    }
}];

Discussion

Synchronously updates the local Thing’s data with the Thing data on the server. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

The Thing must exist on the server. Local data will be overwritten. This is a blocking method.

Discussion

Asynchronously register owner of the thing in Kii Cloud. This method is non-blocking version of registerOwnerSynchronous:error:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

[aThing registerOwner: owner
                block:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing owner registered: %@", thing);
        }
}];

Discussion

Asynchronously register owner of the thing in Kii Cloud. This method is non-blocking version of registerOwnerSynchronous:thingPassword:error:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

[aThing registerOwner: owner thingPassword: thingPassword block:^(KiiThing thing, NSError error) { if(error == nil) { NSLog(@“Thing owner registered: %@”, thing); } }];

Discussion

Synchronously register owner of the thing in Kii Cloud. This is a blocking method.
This API is authorized by owner of thing.
Need user login before execute this API.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

  After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

Discussion

Synchronously register owner of the thing in Kii Cloud. This is a blocking method.
This API is authorized by owner of thing.
Need user login before execute this API.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipExist]) will be returned if the passed thing owner (user/group) is already the owner.

After the registration, owner can access the thing, buckets, objects in bucket, and topics belongs to the thing.

Discussion

Get or create a Push notification topic at the thing level

Discussion

Asynchronously unregister owner of the thing in Kii Cloud. This method is non-blocking version of unregisterOwnerSynchronous:error:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipNotFound]) will be returned if the passed thing owner (user/group) is not the owner.

Remove ownership of the thing from specified user/ group.

[aThing unregisterOwner: owner
                  block:^(KiiThing *thing, NSError *error) {
        if(error == nil) {
            NSLog(@"Thing owner unregistered: %@", thing);
        }
}];

Discussion

Synchronously unregister owner of the thing in Kii Cloud. This is a blocking method.

Remove ownership of the thing from specified user/ group.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

• An error (error code: [KiiError codeThingOwnerNotFound]) will be returned if the passed thing owner (user/group) is not found or already deleted.

• An error (error code: [KiiError codeThingOwnershipNotFound]) will be returned if the passed thing owner (user/group) is not the owner.

Discussion

Asynchronously saves the latest Thing values to the server This method is non-blocking version of updateSynchronous:

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

The Thing must exist in order to make this method call. If the Thing does exist, the application-specific fields that have changed will be updated accordingly. This is a non-blocking method.

[aThing update:^(KiiThing *thing, NSError *error) {
    if(error == nil) {
        NSLog(@"Thing saved: %@", thing);
    }
}];

Discussion

Synchronously saves the latest Thing values to the server. This is a blocking method.
This API is authorized by owner of thing.
Need user login who owns this thing before execute this API.
To let users to own Thing, please call <registerOwnerSynchronous:error:>

• An error (error code: [KiiError codeThingNotFound]) will be returned if the thing is not found or already deleted.

The Thing must exist in order to make this method call. If the Thing does exist, the application-specific fields that have changed will be updated accordingly. This is a blocking method.