what scopes should the API key have? (documentation)

[jordiup]

suggestion to update documentation with:

• what scopes the API key should have?
• ideally appearing on docs.socket.dev route too

[jdalton]

Thank you Jordi Hermoso (@jordiup)!

Closed by #13