API-overzicht
Maak een benoemd API-token
Kies een handeling voor het request, responsestructuur, toegangsregels en implementatiebron.
SchrijvenE-mail + wachtwoord
POST/api/v1/auth/tokens
Maak een benoemd API-token
Deze route vereist geen auth:sanctum of bearer-bevoegdheid.
Verzoek
| Veld | In | Regel |
|---|---|---|
email | JSON-body | Verplicht geldig e-mailadres. |
password | JSON-body | Verplichte string. Verstuur nooit inloggegevens naar deze documentatiesite. |
name | JSON-body | Verplichte string; maximaal 80. |
abilities | JSON-body | Optionele array, maximaal 50 toegestane bevoegdheden. Weglaten geeft volledige toegang; kies expliciete minimale rechten. |
curl --request POST "https://shop.example.test/api/v1/auth/tokens" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"email":"[email protected]","password":"<password>","name":"Documentation example","abilities":["account.read"]}'Antwoord201
Succes: 201
Responsestructuur (notatie, geen opgenomen antwoord)
{ token: string, token_type: "Bearer", name: string }Gebruikelijke fouten
| HTTP-status | Betekenis |
|---|---|
403 | unauthorized, insufficient_scope of ip_not_allowed: controleer klantcontext, bevoegdheid en token-IP-beleid. |
422 | validation_error: ongeldige invoer of niet-vervulde domeinvereisten. Betaalinitiatie kan ook payment_failed geven. |
429 | rate_limited: wacht voor een nieuwe poging, vooral bij schrijfverzoeken. |