Connexion POST
Authentifiez-vous avec votre adresse e-mail et votre mot de passe pour obtenir un jeton JWT.
Point de terminaison
POST https://api.pocketalert.app/v1/auth/signinRequête
En-têtes
| En-tête | Obligatoire | Description |
|---|---|---|
Content-Type | ✅ | application/json |
Paramètres du corps
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
email | string | ✅ | Votre adresse e-mail enregistrée |
password | string | ✅ | Le mot de passe de votre compte |
Exemple de requête
bash
curl -X POST "https://api.pocketalert.app/v1/auth/signin" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "your-password"
}'javascript
const response = await fetch('https://api.pocketalert.app/v1/auth/signin', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: '[email protected]',
password: 'your-password'
})
});
const { token } = await response.json();
// Use token in Authorization header for subsequent requestspython
import requests
response = requests.post(
'https://api.pocketalert.app/v1/auth/signin',
json={
'email': '[email protected]',
'password': 'your-password'
}
)
data = response.json()
# Use token in Authorization header for subsequent requestsphp
$response = Http::post('https://api.pocketalert.app/v1/auth/signin', [
'email' => '[email protected]',
'password' => 'your-password',
]);
$token = $response->json()['token'];
// Use token in Authorization header for subsequent requestsRéponse
Réponse de succès
200 OK
Authentification réussie
| Champ | Type | Description |
|---|---|---|
token | string | Jeton JWT pour l'authentification à l'API |
email | string | Adresse e-mail de l'utilisateur |
name | string | Nom d'affichage de l'utilisateur |
avatar | string | URL de l'image d'avatar de l'utilisateur |
json
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"email": "[email protected]",
"name": "John Doe",
"avatar": ""
}Utilisation du jeton
Après avoir obtenu le jeton, incluez-le dans les requêtes suivantes :
bash
curl -X GET "https://api.pocketalert.app/v1/messages" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."Réponses d'erreur
| Statut | Description |
|---|---|
400 | Requête incorrecte : e-mail ou mot de passe manquant, ou captcha échoué |
401 | Identifiants invalides : mot de passe incorrect ou adresse e-mail inconnue |
Recommandation
Pour les intégrations côté serveur, nous vous recommandons d'utiliser des clés API plutôt que des jetons JWT. Les clés API n'expirent pas et sont plus faciles à gérer.