Hi again Blindsite,
Reading through the comments I have a few things to chime in again.
The token is a string. An example one I generated is
You also mention that you think beginners will struggle to understand the API. I believe this is actually OK as this is where API wrappers come into play. We have a number in the works (most of which are outdated and coded for API 0.4). These are designed to simplify the API and make it useable in a different language. Below is a sample from my wrapper:
s = Safe('Sample application', 'v0.0.1', 'Author', 'namespace') if s.authorize(): print('We are authorized!') else: print('Failed to authorize)
The only knowledge required to understand this is Python. Obviously this will require it’s own documentation, which I have begun work on, however it should be much easier for a Python programmer to understand the Python documentation, especially with the removal of REST code.
If we can generate an API wrapper for each language understanding and using the API becomes much easier. This might sound like a lot of work but it’s a very common approach to this problem, as the base API must remain language agnostic.