Document special requirement if a token is intended to contain the path separator

The attached patch adds a sentence to API.txt to inform developers: if they are creating a token that contains the path separator /, then their placeholder must end in 'path', 'path-raw' or 'alias' in order for it to work.