# Plingit — SMS för agent-eran

> Svensk enkelriktad SMS-gateway. En agent går från noll till levererat SMS utan att en
> människa fyller i formulär: verifiera ett nummer (en kod), mynta en API-nyckel, skicka.
> Endast svenska mobilnummer (+46 / 07…). Pris 50 öre/segment. Gratis: 10 SMS till eget nummer.

Bas-URL: https://plingit.se/v1
Auth: `Authorization: Bearer sk_live_…` på alla skarpa endpoints.
Idempotens: skicka `Idempotency-Key` (eller härleds ur body) — retry dubbelskickar aldrig.

## Kom igång (curl)
1. Begär kod:   POST https://plingit.se/v1/verify/start    {"number":"0701234567"}
2. Bekräfta:    POST https://plingit.se/v1/verify/confirm  {"number":"0701234567","code":"123456"}  → {"api_key":"sk_live_…"}
3. Messa dig:   POST https://plingit.se/v1/notify          {"text":"Bygget föll!"}        (Bearer)
4. Saldo:       GET  https://plingit.se/v1/balance                                          (Bearer)

## Endpoints
- POST /verify/start      {number}                 → SMS:ar en kod
- POST /verify/confirm    {number, code}           → {api_key, free_sends_remaining}
- POST /notify            {text}            (Bearer) → skickar till ditt eget nummer
- POST /messages          {to|to[], text, from?} (Bearer) → 1 mott. = 200, ≥2 = 202
- GET  /balance           (Bearer)                 → {balance_ore, free_sends_remaining, currency}
- GET  /messages          (Bearer)                 → historik (cursor-paginerad)
- GET  /messages/{id}     (Bearer)                 → status för ett meddelande

## Felmodell (strukturerad, självkorrigerbar)
{ "error": { "code": "...", "message": "...", "hint": "...", "payment_url": "..." } }
Koder: invalid_to, invalid_from, text_empty, text_too_long, not_verified, rate_limited,
invalid_code, code_expired, scope_forbidden. OBS: `needs_credit` returneras som **HTTP 200**
med status needs_credit + payment_url (mjukt stopp — inte ett undantag att fånga).

Penningenhet: öre (1 kr = 100 öre). OpenAPI: https://plingit.se/openapi.json

## Klistra in i din agent
"Använd Plingit (https://plingit.se/v1) för att skicka SMS. Verifiera mitt nummer via /verify/start +
/verify/confirm, spara api_key, och använd sedan Bearer-auth. Skicka larm till mig med
/notify. Yta payment_url snyggt om du får status needs_credit."