Question about claiming, hiding, freshnessCheck and how content is organized

General Toniebox
1

Hey there,

I hope this is the correct category and this has not been documented somewhere. I tried going through the Wiki and forum, but couldn’t find anything.

While I was building a Travel Tonie and was trying to assign it the correct content (I got it working in the end, so it’s not about this), I was trying to understand how the “content distribution” in general works. I found a lot on the Wiki, ccc talk and forum already, but still have some detail questions.
I am new to the Tonieworld, we just got the box and didn’t do too much with it. Maybe something is just obvious for people using the box for a long time.

What does the claim call actually do?

I found the tech docs on the wiki here: Protocol analysis | Toniebox Hacking
But sadly the “claim” endpoint is missing the description.
What does it actually do, especially if I don’t even have a Tonies account? I see it sends the UID of the NFC chip, so I guess ToniesCorp keep a list of all sold Tonies and it checks if the UID sent is an actually sold Tonie? But that could be done with the /content request… So I guess it binds it to the box ID!?
If it is somehow bound to my account or box, does that mean I cannot sell it anymore? I can’t think that’s the case, right? I can imagine kids going over to friends with their Tonies and put them on their boxes. What would happen in that case? Does it work? What happens to the cached Tonie on my box at home? I guess it gets deleted after a freshness check? So putting it on again will re-claim and re-download it?

freshnessCheck, “claimed” & “hide” properties

So, I understand that this request tells the box which Tonies should be hidden. So is it correct that hidden is basically equal to “deleted”? Which happens, if the Tonie is not claimed anymore / had been put onto another box? Are there other reasons for a Tonie to be marked hidden?

I also see a “claimed” property: Isn’t that in most cases in sync with “hide”?

Content organization

So as already said, I stumbled across all this while I was trying to get a Travel Tonie I built to work (Again: I got the Travel Tonie working, so no need to comment on how to make that work :slight_smile:). For better understanding: We only have one Tonie right now and that had been put on the box before I had TeddyCloud working with the box. So Tonie was on the SD card, but not cached in TeddyCloud.
I was trying to assign content to the Travel Tonie, so I followed the Wiki ( Custom Tags | Toniebox Hacking ), but my Library was empty. So I just assigned the model of the real Tonie to the custom tag / Travel Tonie, but that was not working. I thought because I own the real Tonie (which had been claimed), that should work. It should obviously not work with Tonies I don’t own, that would be bad / piracy. But I expected it to work with Tonies I claimed.

Isn’t that how it could be made working in TeddyCloud? That if you own a Tonie, you can assign a Model to a custom tag? Or is that not at all how this works / should work? :slight_smile:

Thanks already so much for bearing with me and answering all this <3

Greetings,

Andy!

2

Claim means: Make it visible in the Tonies account of the box owner.
The owner can in that case mark it as its own. This way it cannot be bound to a different Tonies Account as long as this flag is set. This also means that nobody else can change the contents of that Tonie.

Content:
If the content is not in your TeddyCloud, it wasn’t downloaded. This is usually the case, when the content already was on the box. But you can download it within the webinterface, if you place the Tonie onto the box. This way teddyCloud gets the credentials of that Tonie, so you can start the download.

Hide (only TeddyCloud internal!):
You see all Tonies within TC that are on your box. With this function you can hide it, until you put this tonie again onto your box. Useful for Tonies, that friends brought by.

3

Hey badbee,

thanks for the replies already, much appreciated!!

Some follow-ups, if you may allow:

This also means that nobody else can change the contents of that Tonie.

If you say “change the contents”, I guess you’re referencing Creative Tonies? How can you change the content of a regular Tonie?

But is the assumption correct, that if my daughter puts one of her Tonies on a box of her friends, this Tonie is then claimed under their account for the time being, until she puts it back on her box? And if a freshness check would come in before she does that, it would be wiped from the box? Would Teddycloud also wipe it from the box, or would it just set claimed: false?

Thanks and greetings,

Andy!

4

You can assign content you buy from the Tonies digital content shop for specific Tonies.

Claiming only binds it to an account not more, not less.

5

Gotcha, thanks for the clarifications! <3