{"info":{"_postman_id":"292bc95c-e9d4-4b44-afc6-0bb13545335a","name":"M1001's APIs auth","description":"

This API lets you obtain (and refresh) a Bearer token to authenticate yourself to use M1001's APIs.

You can create a single token for all APIs listed here.

My services are actually available only for my supporters (one-time donations).

Endpoints

There are two endpoints:

token
\n
refresh
\n

Response codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status code	Description
200 OK	All just went in the right way
400 Bad Request	Missing parameter(s)
405 Method Not Allowed	Method not allowed
409 Conflict	Email already used
422 Unprocessable Entity	Invalid parameter(s)

88b       d88      88     ,a8888a,        ,a8888a,         88\n888b     d888   ,d888   ,8P\"'  `\"Y8,    ,8P\"'  `\"Y8,    ,d888\n88`8b   d8'88  88\" 88  ,8P        Y8,  ,8P        Y8,  88\" 88\n88 `8b d8' 88      88  88          88  88          88      88\n88  `888'  88      88  88          88  88          88      88\n88   `8'   88      88  `8b        d8'  `8b        d8'      88\n88         88      88   `8ba,  ,ad8'    `8ba,  ,ad8'       88\n88         88      88     \"Y8888P\"        \"Y8888P\"         88\n\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24385138","collectionId":"292bc95c-e9d4-4b44-afc6-0bb13545335a","publishedId":"2s8ZDcyf51","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"505050","highlight":"0A3321"},"publishDate":"2026-09-28T07:23:40.000Z"},"item":[{"name":"Token","id":"41ed1c9e-2947-4c1a-ae3f-d1bd9fda5ec1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"url":"https://www.m1001.eu/api/services/auth/token","description":"

To generate an exclusive Bearer token, you need to be an M1001 supporter, I offer my API services to my supporters just to thank them for giving value to the time I spend programming, I don't care about the amount of the donation, all the supporters receive access to my APIs.

If you are one of my supporters, you just need to send an HTTPS request to the URL above including the email you used to donate as the \"email\" parameter via the POST method and you will receive a JSON response.

If you lose the token, you can replace it using the PUT method after creating a refresh token via the \"refresh\" endpoint.

Be aware: after the token creation, you will receive it once via email and never again.

How to use a Bearer token

If you don't know how to use a Bearer token, I can safely tell you that it's very easy, you just need to put an Authorization header, so use \"Authorization\" as key for your header and put \"Bearer example_token\" as value, like this:

\n
Authorization: Bearer example_token
\n

Be aware: obviously put your token instead of the fictitious value \"example_token\".

Parameters table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Where	Required	Description	Valid values
email	Request body	Yes	Email to send the Bearer token to	Email addresses used to make a donation to M1001 via \"Buy me a coffee\"

","urlObject":{"protocol":"https","path":["api","services","auth","token"],"host":["www","m1001","eu"],"query":[],"variable":[]}},"response":[{"id":"269b3b80-9542-4310-b445-bdb9a21184dd","name":"Token","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"email","value":"example@gmail.com","type":"text"}]},"url":"https://www.m1001.eu/api/services/auth/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 30 Apr 2025 11:02:57 GMT"},{"key":"Server","value":"Apache"},{"key":"Cache-Control","value":"no-store"},{"key":"Allow","value":"POST, PUT"},{"key":"Upgrade","value":"h2c"},{"key":"Connection","value":"Upgrade, Keep-Alive"},{"key":"X-Adsense-Platform-Domain","value":"altervista.com"},{"key":"Keep-Alive","value":"timeout=1, max=100"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": \"Your Bearer token has been sent to your email, don't delete the email until you write it down somewhere safe (also check junk email)\"\n}"}],"_postman_id":"41ed1c9e-2947-4c1a-ae3f-d1bd9fda5ec1"},{"name":"Token","id":"9a33bdb9-3236-4249-9ff7-48a7a25e000d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"url":"https://www.m1001.eu/api/services/auth/token","description":"

If your Bearer token has been compromised/lost, don't worry! You can just refresh it!

First you will have to create a refresh token via the \"refresh\" endpoint.
Then, you will have to send a HTTPS request to the URL above using \"email\" (the one you registered with) and \"refresh_token\" (the one you received in the email box) as parameters via the PUT method and you will receive a JSON response.

Be aware: every refresh token can be used only one time and only for the next 60 minutes after its creation. Only the last refresh token created will be valid.

Be aware: the Content-Type header must be \"application/x-www-form-urlencoded\".

Parameters table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Where	Required	Description	Valid values
email	Request body	Yes	Email to send the Bearer token to	Email addresses used to generate a refresh token
refresh_token	Request body	Yes	Refresh token received via email	Refresh token sent to the provided email

","urlObject":{"protocol":"https","path":["api","services","auth","token"],"host":["www","m1001","eu"],"query":[],"variable":[]}},"response":[{"id":"240ec4d7-b3e3-4adb-b16b-e476b2b47c86","name":"Token","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"email","value":"example@gmail.com","type":"text"},{"key":"refresh_token","value":"example","type":"text"}]},"url":"https://www.m1001.eu/api/services/auth/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 30 Apr 2025 11:11:23 GMT"},{"key":"Server","value":"Apache"},{"key":"Cache-Control","value":"no-store"},{"key":"Allow","value":"POST, PUT"},{"key":"Upgrade","value":"h2c"},{"key":"Connection","value":"Upgrade, Keep-Alive"},{"key":"X-Adsense-Platform-Domain","value":"altervista.com"},{"key":"Keep-Alive","value":"timeout=1, max=100"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": \"Your Bearer token has been sent to your email, don't delete the email until you write it down somewhere safe (also check junk email)\"\n}"}],"_postman_id":"9a33bdb9-3236-4249-9ff7-48a7a25e000d"},{"name":"Refresh","id":"d8ee212b-97ec-4117-8aa7-a7998399209e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"url":"https://www.m1001.eu/api/services/auth/refresh","description":"

To create a refresh token, you just need to send an HTTPS request to the URL above including the email you used to donate as the \"email\" parameter via the POST method and you will receive a JSON response.
Then, you will have to use the \"token\" endpoint to replace your Bearer token.

Be aware: every refresh token can be used only one time and only for the next 60 minutes after its creation. Only the last refresh token created will be valid.

Parameters table

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Where	Required	Description	Valid values
email	Request body	Yes	Email to send the refresh token to	Email addresses used to make a donation to M1001 via \"Buy me a coffee\"

","urlObject":{"protocol":"https","path":["api","services","auth","refresh"],"host":["www","m1001","eu"],"query":[],"variable":[]}},"response":[{"id":"05b272a1-35b9-4827-850c-cfa576353fb8","name":"Refresh","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"email","value":"example@gmail.com","type":"text"}]},"url":"https://www.m1001.eu/api/services/auth/refresh"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 30 Apr 2025 11:07:18 GMT"},{"key":"Server","value":"Apache"},{"key":"Cache-Control","value":"no-store"},{"key":"Allow","value":"POST"},{"key":"Upgrade","value":"h2c"},{"key":"Connection","value":"Upgrade, Keep-Alive"},{"key":"X-Adsense-Platform-Domain","value":"altervista.com"},{"key":"Keep-Alive","value":"timeout=1, max=100"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": \"A refresh token has been sent to your email, you'll be able to use it for the next 60 minutes (also check junk email)\"\n}"}],"_postman_id":"d8ee212b-97ec-4117-8aa7-a7998399209e"}]}