Dezvoltator

API HTTP

URL de bază https://osim.live/api/v1 — verificare SMS și eSIM de călătorie. Creează cheile în panou, apoi apelează cu Bearer.

Autentificare

Trimite cheia API la fiecare cerere privată. Cheile încep cu osim_ și se creează pe pagina contului.

Authorization: Bearer osim_…

Nu încorpora niciodată cheile în frontend-uri publice. Preferă partea de server sau proxy-uri backend.

Deschide cheile din panou

Formatul răspunsului

Fiecare endpoint întoarce JSON cu un flag success. Erorile folosesc aceeași formă, cu un șir error.

// Success
{ "success": true, "data": { … } }

// Error
{ "success": false, "error": "message" }

URL de bază: https://osim.live/api/v1
Content-Type: application/json
CORS activat pentru clienții din browser (OPTIONS acceptat)
Sumele sunt în USD cents , dacă nu se menționează altfel (balanceCents, sellCents)

GET/api/v1

Index API — versiune și căi ale resurselor. Nu este nevoie de cheie.

Public

curl https://osim.live/api/v1

GET/api/v1/me

Contul curent legat de cheia API: id, email, name și soldul portofelului.

Bearer obligatoriu

curl https://osim.live/api/v1/me \
  -H "Authorization: Bearer osim_…"

// data
{
  "id": "…",
  "email": "[email protected]",
  "name": "…",
  "balanceCents": 2500,
  "balance": "$25.00"
}

Verificare SMS

GET/api/v1/sms?catalog=1

Catalog public de servicii, țări, prețuri în USD și durate de închiriere permise.

Public

curl "https://osim.live/api/v1/sms?catalog=1"

// data
{
  "services": [
    {
      "slug": "whatsapp",
      "service": "WhatsApp",
      "category": "…",
      "countries": [
        { "code": "TR", "name": "Turkey", "countryId": 12, "priceUsd": 0.35, "successRate": 92 }
      ]
    }
  ],
  "rentHours": [4, 12, 24, 72, 168]
}

GET/api/v1/sms

Listează comenzile SMS recente.

Bearer obligatoriu

Implicit: ultimele 50 de comenzi SMS ale deținătorului cheii

curl https://osim.live/api/v1/sms \
  -H "Authorization: Bearer osim_…"

POST/api/v1/sms

Cumpără, închiriază, interoghează statusul, anulează, finalizează sau retrimite. Call-verify nu este oferit.

Bearer obligatoriu

Corp comun

Câmp	Tip	Obligatoriu	Descriere
`action`	string	da	purchase \| activation \| rent \| status \| refresh \| cancel \| complete \| resend
`service / serviceSlug`	string	da	Slug de catalog, ex. whatsapp
`countryId / country`	number	nu	Id-ul de țară al furnizorului din catalog (obligatoriu la cumpărare și închiriere)
`priceId`	string	nu	Blocare opțională pe un rând de preț anume
`maxPrice`	number	nu	Plafon opțional în USD
`operator`	string	nu	Preferință de rețea opțională
`hours / time`	number	nu	Doar închiriere: 4 \| 12 \| 24 \| 72 \| 168
`id / activationId`	string	nu	Id comandă pentru status, anulare, finalizare și retrimitere

purchase / activation

Număr de verificare SMS de unică folosință (~20 de minute). Verificarea prin apel nu este disponibilă.

curl -X POST https://osim.live/api/v1/sms \
  -H "Authorization: Bearer osim_…" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "purchase",
    "service": "whatsapp",
    "countryId": 12
  }'

rent

Închiriere mai lungă. Ore permise: 4, 12, 24, 72, 168.

{
  "action": "rent",
  "service": "telegram",
  "countryId": 16,
  "hours": 24
}

status / refresh

{ "action": "status", "id": "cm…" }

cancel · complete · resend

{ "action": "cancel", "id": "cm…" }
{ "action": "complete", "id": "cm…" }
{ "action": "resend", "id": "cm…" }  // linii de închiriere doar când sunt acceptate

eSIM de călătorie

GET/api/v1/esim?catalog=1

Catalog public de pachete (slug / packageCode, date, zile, preț de vânzare).

Public

curl "https://osim.live/api/v1/esim?catalog=1"

GET/api/v1/esim

Listează comenzile eSIM sau adu una după id (reîmprospătează consumul când se poate).

Bearer obligatoriu

Implicit: ultimele 50 de comenzi eSIM
O singură comandă + reîmprospătare utilizare: ?id=cm…

curl "https://osim.live/api/v1/esim?id=cm…" \
  -H "Authorization: Bearer osim_…"

POST/api/v1/esim

Cumpără un plan, reîmprospătează profilul, redenumește, listează opțiunile de reîncărcare sau aplică o reîncărcare.

Bearer obligatoriu

Câmp	Tip	Obligatoriu	Descriere
`action`	string	da	purchase \| refresh \| rename \| topup-options \| topup
`slug / packageCode`	string	nu	Pachet de catalog pentru cumpărare și reîncărcare
`id`	string	nu	Id comandă pentru reîmprospătare, redenumire și reîncărcare
`label`	string	nu	Nume afișat nou pentru redenumire

// Purchase
{
  "action": "purchase",
  "packageCode": "turkey-5gb-30d"
}

// Refresh profile / usage
{ "action": "refresh", "id": "cm…" }

// Rename
{ "action": "rename", "id": "cm…", "label": "Trip TR" }

// Top-up options + apply
{ "action": "topup-options", "id": "cm…" }
{ "action": "topup", "id": "cm…", "packageCode": "…" }

Răspunsurile de cumpărare includ șirul de activare LPA și un URL de imagine QR, când este disponibil.

Erori

HTTP	Când
`200`	`success: true`
`400`	Eroare de validare / business (sold insuficient, acțiune necunoscută, …)
`401`	Cheie API lipsă sau nevalidă
`404`	Comanda nu a fost găsită pentru acest cont

Note

Soldul se scade în cenți USD la momentul cumpărării. Cumpărăturile eșuate la furnizor sunt rambursate.
Numerele SMS unice durează de obicei ~20 de minute. Închirierea folosește orele din catalog.
Se pot aplica limite de rată și controale anti-abuz. Contactează asistența pentru volum mai mare.
Exportul OpenAPI/Swagger nu este încă publicat — această pagină este sursa de adevăr.