@acteo/api 0.4.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -0
- package/README.md +43 -14
- package/dist/index.cjs +49 -21
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +82 -33
- package/dist/index.d.ts +82 -33
- package/dist/index.js +49 -22
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,29 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## @acteo/api 0.5.0 (2026-11-03)
|
|
4
|
+
|
|
5
|
+
API-ul trimite acum codurile de eroare din contract. Dacă ai cod care compară `err.cod` cu valorile vechi, schimbă-l după tabelul de mai jos. Clasele de eroare și statusurile HTTP rămân aceleași.
|
|
6
|
+
|
|
7
|
+
| Situație | Cod vechi | Cod nou |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Limita zilnică a planului atinsă (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `DAILY_LIMIT_REACHED` |
|
|
10
|
+
| Limita lunară sau plafonul consumului peste plan atins (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `PLAN_LIMIT_REACHED` |
|
|
11
|
+
| DGPCI refuză numărul (422) | `NUMAR_RESPINS` | `INVALID_IDENTIFIER` |
|
|
12
|
+
| DGPCI nu răspunde la timp (504) | `TIMEOUT` | `UPSTREAM_TIMEOUT` |
|
|
13
|
+
| Verificarea la DGPCI eșuează (502) | `EROARE_DGPCI` | `UPSTREAM_UNAVAILABLE` |
|
|
14
|
+
| Verificare încheiată cu `status: "error"` | `VERIFICARE_ESUATA` | `INVALID_IDENTIFIER`, `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` |
|
|
15
|
+
|
|
16
|
+
- `CODURI_EROARE` și tipul `CodEroare`: toate codurile pe care le trimite API-ul. `CodEsecVerificare` are motivele unei verificări eșuate.
|
|
17
|
+
- `EroareVerificare.cod` spune de ce a eșuat verificarea. `codSursa` rămâne și arată câmpul refuzat la `INVALID_IDENTIFIER`.
|
|
18
|
+
- Rezultatul `not_found` are `code: "NOT_FOUND"`, iar webhook-ul de rezultat are `code` la eroare și la `not_found`.
|
|
19
|
+
- Pornirea unei verificări sau a unei verificări de număr poate primi `EroareServer` 503 cu `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` când sursa oficială e oprită temporar. Cererea nu se taxează și nu se repetă singură; `retryAfterMs` spune când să revii.
|
|
20
|
+
- `DAILY_LIMIT_REACHED` vine cu `retryAfterMs` până la miezul nopții, ora României. `PLAN_LIMIT_REACHED` nu are `retryAfterMs`, pentru că nu se deblochează la miezul nopții.
|
|
21
|
+
- Un server mai vechi, fără coduri, dă în continuare `COTA_ATINSA` și `VERIFICARE_ESUATA`.
|
|
22
|
+
|
|
23
|
+
## @acteo/api 0.4.1 (2026-10-31)
|
|
24
|
+
|
|
25
|
+
- Documentație: fiecare verificare interoghează sursa oficială. `porneste()` întoarce o verificare în curs, iar rezultatul vine prin `asteapta()`, `rezultat()` sau webhook. `checkedAt` e descris ca momentul verificării. Codul nu se schimbă.
|
|
26
|
+
|
|
3
27
|
## @acteo/api 0.4.0 (2026-10-31)
|
|
4
28
|
|
|
5
29
|
- Corectură: `verificaNotificare()` (și `verificaWebhookNotificare()`) citește cheia din headerul `X-Acteo-Key`, cel trimis acum de API. Până acum căuta doar `X-Verificrca-Key`, așa că notificările reale erau respinse cu `CHEIE_INVALIDA`. Headerul vechi e citit în continuare când lipsește cel nou. `HEADER_CHEIE_WEBHOOK` e acum `"x-acteo-key"`, iar `HEADER_EVENIMENT_WEBHOOK` e `"x-acteo-event"`.
|
package/README.md
CHANGED
|
@@ -116,7 +116,7 @@ const rovinieta = await acteo.auto.rovinieta.verifica({
|
|
|
116
116
|
console.log(rovinieta.status, rovinieta.expiresAt)
|
|
117
117
|
```
|
|
118
118
|
|
|
119
|
-
Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
|
|
119
|
+
Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `cod: "INVALID_IDENTIFIER"` și `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
|
|
120
120
|
|
|
121
121
|
```ts
|
|
122
122
|
import { EroareVerificare } from "@acteo/api"
|
|
@@ -185,7 +185,7 @@ Formatele de număr acceptate: București (`B123ABC`, `B12ABC`), județe (`CJ45X
|
|
|
185
185
|
|
|
186
186
|
## Cum decurge o verificare
|
|
187
187
|
|
|
188
|
-
1. **Cerere** (`porneste`).
|
|
188
|
+
1. **Cerere** (`porneste`). Fiecare cerere interoghează sursa oficială: verificarea intră în coadă și primești `status: "processing"`.
|
|
189
189
|
2. **Interogarea sursei.** Sursa oficială e consultată în fundal. Dacă nu răspunde în 4 minute, verificarea se încheie cu eroare.
|
|
190
190
|
3. **Rezultatul** ajunge la tine pe una din trei căi:
|
|
191
191
|
- `verifica()` face tot drumul și întoarce direct rezultatul final;
|
|
@@ -201,10 +201,20 @@ O verificare consumă din cota planului doar când sursa oficială a răspuns, i
|
|
|
201
201
|
| `valid` | Document valabil | data expirării |
|
|
202
202
|
| `warning` | Expiră curând: RCA în 14 zile, ITP în 30, rovinietă în 7, ARR în 14 | data expirării |
|
|
203
203
|
| `expired` | Expirat sau inexistent, confirmat de sursă | data expirării sau `null` |
|
|
204
|
-
| `not_found` | Sursa nu a găsit vehiculul | `null` |
|
|
204
|
+
| `not_found` | Sursa nu a găsit vehiculul (`code: "NOT_FOUND"`) | `null` |
|
|
205
205
|
| `processing` | Verificarea e încă în curs | nu există |
|
|
206
206
|
|
|
207
|
-
Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare
|
|
207
|
+
Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare`, iar `cod` spune de ce:
|
|
208
|
+
|
|
209
|
+
| `cod` | Ce s-a întâmplat | Ce faci |
|
|
210
|
+
|---|---|---|
|
|
211
|
+
| `INVALID_IDENTIFIER` | Sursa a refuzat datele trimise; câmpul e în `codSursa` | corectezi câmpul, reîncercarea nu ajută |
|
|
212
|
+
| `UPSTREAM_UNAVAILABLE` | Sursa oficială nu răspunde sau a răspuns cu eroare | reiei mai târziu |
|
|
213
|
+
| `UPSTREAM_TIMEOUT` | Sursa oficială nu a răspuns în timpul maxim | reiei mai târziu |
|
|
214
|
+
| `UPSTREAM_BLOCKED` | Accesul la sursa oficială e restricționat temporar | reiei mai târziu |
|
|
215
|
+
| `UPSTREAM_CHANGED` | Sursa și-a schimbat structura, adaptăm serviciul | reiei mai târziu |
|
|
216
|
+
|
|
217
|
+
Doar `INVALID_IDENTIFIER` se taxează, pentru că sursa a răspuns. Valorile lui `codSursa`:
|
|
208
218
|
|
|
209
219
|
| `codSursa` | Câmpul de corectat |
|
|
210
220
|
|---|---|
|
|
@@ -235,7 +245,7 @@ Disponibil pe `auto.rca`, `auto.itp`, `auto.rovinieta` și `auto.arr`. Pornește
|
|
|
235
245
|
|
|
236
246
|
### `auto.<document>.porneste(identificator, { callbackUrl? })`
|
|
237
247
|
|
|
238
|
-
Pornește verificarea fără să aștepte. Întoarce
|
|
248
|
+
Pornește verificarea fără să aștepte. Întoarce un obiect `VerificareInCurs` pe care îl dai mai departe la `rezultat()` sau `asteapta()`.
|
|
239
249
|
|
|
240
250
|
```ts
|
|
241
251
|
const r = await acteo.auto.itp.porneste("WVWZZZ1JZXW000001", {
|
|
@@ -286,7 +296,7 @@ Decodează o serie de șasiu. Întoarce `marca`, `model`, `anFabricatie`, `sursa
|
|
|
286
296
|
|
|
287
297
|
### `auto.numere.verifica(numar)`
|
|
288
298
|
|
|
289
|
-
Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "
|
|
299
|
+
Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "INVALID_IDENTIFIER"`. Când verificarea nu poate rula primești `EroareServer` cu `cod` `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`. Niciuna nu se taxează, iar `OCUPAT` se reîncearcă singur după `Retry-After`. Cere un abonament de numere disponibile.
|
|
290
300
|
|
|
291
301
|
### `auto.imagini.obtine({ marca, model, an, unghi?, umbra? })`
|
|
292
302
|
|
|
@@ -392,20 +402,39 @@ Datele cu oră (`trimisLa`, `sedinta.data`, `verificatLa`) devin `Date`. Datele
|
|
|
392
402
|
|
|
393
403
|
Toate erorile moștenesc `ActeoError`, care la rândul ei moștenește `Error`. Fiecare are `_tag`, `message` (în română), plus `status`, `cod`, `hint` și `raspuns` când vin de la API.
|
|
394
404
|
|
|
405
|
+
### Coduri de eroare
|
|
406
|
+
|
|
407
|
+
`cod` are o valoare stabilă, bună de tratat în program. Lista completă e exportată ca `CODURI_EROARE`, iar tipul e `CodEroare`. Primele opt sunt cele din contract:
|
|
408
|
+
|
|
409
|
+
| `cod` | Unde apare | Înseamnă |
|
|
410
|
+
|---|---|---|
|
|
411
|
+
| `UPSTREAM_UNAVAILABLE` | `EroareVerificare`, `EroareServer` 502 | Sursa oficială nu răspunde sau răspunde cu eroare |
|
|
412
|
+
| `UPSTREAM_TIMEOUT` | `EroareVerificare`, `EroareServer` 504 | Sursa oficială nu a răspuns în intervalul maxim |
|
|
413
|
+
| `UPSTREAM_BLOCKED` | `EroareVerificare`, `EroareServer` 503 | Accesul la sursa oficială e restricționat temporar |
|
|
414
|
+
| `UPSTREAM_CHANGED` | `EroareVerificare`, `EroareServer` 503 | Structura sursei s-a modificat, serviciul e în adaptare |
|
|
415
|
+
| `DAILY_LIMIT_REACHED` | `EroareLimita` 429 | Limita zilnică a planului, se resetează la miezul nopții (ora României) |
|
|
416
|
+
| `PLAN_LIMIT_REACHED` | `EroareLimita` 429 | Limita lunară, sau plafonul consumului peste plan |
|
|
417
|
+
| `NOT_FOUND` | `code` pe rezultatul `not_found` | Identificatorul nu există la sursa oficială |
|
|
418
|
+
| `INVALID_IDENTIFIER` | `EroareVerificare`, `EroareValidare` 422 | Sursa oficială a respins identificatorul |
|
|
419
|
+
|
|
420
|
+
Restul țin de un produs: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`, `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS` (numărul de mașini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
|
|
421
|
+
|
|
422
|
+
### Clasele de eroare
|
|
423
|
+
|
|
395
424
|
| Clasă | Când apare | Câmpuri utile |
|
|
396
425
|
|---|---|---|
|
|
397
426
|
| `EroareConfigurare` | Cheie lipsă sau opțiuni invalide | |
|
|
398
|
-
| `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`
|
|
427
|
+
| `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`INVALID_IDENTIFIER`) | `camp`, `acceptate`, `cod` |
|
|
399
428
|
| `EroareAutentificare` | 401: cheie invalidă sau dezactivată | `hint` |
|
|
400
429
|
| `EroarePlanInactiv` | 402: fără abonament activ | `hint` |
|
|
401
430
|
| `EroareInterzis` | 403: `LIMIT_ATINS`, `ARR_NECESITA_PLAN` | `cod`, `limita` |
|
|
402
431
|
| `EroareNegasit` | 404: vehicul inexistent în cont | |
|
|
403
432
|
| `EroareConflict` | 409: `VEHICUL_EXISTENT` | |
|
|
404
|
-
| `EroareLimita` | 429:
|
|
405
|
-
| `EroareServer` | 5xx;
|
|
433
|
+
| `EroareLimita` | 429: cotă (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`), plafon de flotă sau polling prea des | `cod`, `retryAfterMs`, `utilizareZi`, `utilizareLuna` |
|
|
434
|
+
| `EroareServer` | 5xx; sursa oficială (`UPSTREAM_*`), sau `OCUPAT`, `INDISPONIBIL` la numere disponibile | `status`, `cod`, `retryAfterMs` |
|
|
406
435
|
| `EroareRetea` | Fără răspuns sau timeout | `timeout`, `neajunsa` |
|
|
407
436
|
| `EroareRaspunsInvalid` | Răspuns cu formă neașteptată | `raspuns` |
|
|
408
|
-
| `EroareVerificare` | Sursa oficială nu a
|
|
437
|
+
| `EroareVerificare` | Sursa oficială nu a dat un răspuns sau a refuzat datele | `cod`, `codSursa` |
|
|
409
438
|
| `EroareTimeoutVerificare` | `asteapta()` sau `imagini.asteapta()` a depășit `timeoutMs` | |
|
|
410
439
|
| `EroareWebhook` | Cheie greșită sau payload invalid | `cod` |
|
|
411
440
|
|
|
@@ -416,7 +445,7 @@ try {
|
|
|
416
445
|
await acteo.auto.rca.porneste(numar)
|
|
417
446
|
} catch (err) {
|
|
418
447
|
if (err instanceof EroareValidare) return arataUtilizatorului(err.message)
|
|
419
|
-
if (err instanceof EroareLimita && err.cod === "
|
|
448
|
+
if (err instanceof EroareLimita && err.cod === "DAILY_LIMIT_REACHED") return amanaPanaMaine()
|
|
420
449
|
if (err instanceof ActeoError) logger.error(err._tag, err.message, err.hint)
|
|
421
450
|
throw err
|
|
422
451
|
}
|
|
@@ -432,9 +461,9 @@ SDK-ul nu trimite niciodată de două ori o verificare taxată.
|
|
|
432
461
|
|---|---|---|
|
|
433
462
|
| Rețea căzută, timeout | se reîncearcă | nu (cererea poate să fi ajuns) |
|
|
434
463
|
| DNS, conexiune refuzată | se reîncearcă | se reîncearcă (sigur nu a ajuns) |
|
|
435
|
-
| 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (
|
|
464
|
+
| 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (cererea nu a ajuns la API) |
|
|
436
465
|
| 503 `OCUPAT` la numere disponibile | | se reîncearcă după `Retry-After` (netaxat) |
|
|
437
|
-
| 502, 503, 504 cu alt `cod` | | nu (netaxat, dar repetarea nu ajută imediat) |
|
|
466
|
+
| 502, 503, 504 cu alt `cod` (`UPSTREAM_*`, `INDISPONIBIL`) | | nu (netaxat, dar repetarea nu ajută imediat) |
|
|
438
467
|
| 500 | se reîncearcă | nu |
|
|
439
468
|
| 429 la polling | se reîncearcă după `Retry-After` | |
|
|
440
469
|
| 429 cotă sau plafon flotă | nu | nu |
|
|
@@ -449,7 +478,7 @@ const acteo = new Acteo({
|
|
|
449
478
|
|
|
450
479
|
## Cotă și limite
|
|
451
480
|
|
|
452
|
-
Fiecare verificare consumă o unitate din cota zilnică și lunară a planului, dar numai când sursa oficială a răspuns. Decodarea VIN, numerele disponibile și pozele au fiecare abonamentul și cota lor: decodarea se taxează doar cu marcă și model găsite, numărul doar când DGPCI dă un verdict, iar poza doar când e gata. Decodările fără rezultat și pozele generice au un plafon zilnic separat. Dacă
|
|
481
|
+
Fiecare verificare consumă o unitate din cota zilnică și lunară a planului, dar numai când sursa oficială a răspuns. Decodarea VIN, numerele disponibile și pozele au fiecare abonamentul și cota lor: decodarea se taxează doar cu marcă și model găsite, numărul doar când DGPCI dă un verdict, iar poza doar când e gata. Decodările fără rezultat și pozele generice au un plafon zilnic separat. Dacă sursa nu răspunde, nu consumi nimic. Verificările încă în curs ocupă cota până la răspuns, ca să nu treci de limită cu cereri trimise în paralel.
|
|
453
482
|
|
|
454
483
|
Rezultatele (inclusiv decodările, numerele și pozele) au câmpul `limite`, completat din headerele `X-RateLimit-*`:
|
|
455
484
|
|
package/dist/index.cjs
CHANGED
|
@@ -150,6 +150,27 @@ var EroareWebhook = class extends VerificRcaError {
|
|
|
150
150
|
var TipVerificare = effect.Schema.Literal("rca", "itp", "rovinieta", "arr");
|
|
151
151
|
var StatusDocument = effect.Schema.Literal("valid", "warning", "expired", "not_found");
|
|
152
152
|
var DataNullabila = effect.Schema.NullOr(effect.Schema.Date);
|
|
153
|
+
var CODURI_EROARE = [
|
|
154
|
+
"UPSTREAM_UNAVAILABLE",
|
|
155
|
+
"UPSTREAM_TIMEOUT",
|
|
156
|
+
"UPSTREAM_BLOCKED",
|
|
157
|
+
"UPSTREAM_CHANGED",
|
|
158
|
+
"DAILY_LIMIT_REACHED",
|
|
159
|
+
"PLAN_LIMIT_REACHED",
|
|
160
|
+
"NOT_FOUND",
|
|
161
|
+
"INVALID_IDENTIFIER",
|
|
162
|
+
"SOLD_INSUFICIENT",
|
|
163
|
+
"PLAFON_NETAXAT",
|
|
164
|
+
"OCUPAT",
|
|
165
|
+
"INDISPONIBIL",
|
|
166
|
+
"VIN_NEDECODAT",
|
|
167
|
+
"VIN_INVALID",
|
|
168
|
+
"ARR_NECESITA_PLAN",
|
|
169
|
+
"LIMIT_ATINS",
|
|
170
|
+
"VEHICUL_EXISTENT",
|
|
171
|
+
"NEGASIT",
|
|
172
|
+
"LIMITA_FLOTA_ATINSA"
|
|
173
|
+
];
|
|
153
174
|
var RezultatVerificareSchema = effect.Schema.Struct({
|
|
154
175
|
/** Tipul verificarii. */
|
|
155
176
|
tip: TipVerificare,
|
|
@@ -159,12 +180,14 @@ var RezultatVerificareSchema = effect.Schema.Struct({
|
|
|
159
180
|
numarInmatriculare: effect.Schema.NullOr(effect.Schema.String),
|
|
160
181
|
/** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
|
|
161
182
|
serieSasiu: effect.Schema.NullOr(effect.Schema.String),
|
|
162
|
-
/**
|
|
183
|
+
/** Momentul verificarii. */
|
|
163
184
|
checkedAt: effect.Schema.Date,
|
|
164
185
|
/** Starea documentului. Vezi {@link StatusDocument}. */
|
|
165
186
|
status: StatusDocument,
|
|
166
187
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
167
188
|
expiresAt: DataNullabila,
|
|
189
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
190
|
+
code: effect.Schema.optional(effect.Schema.String),
|
|
168
191
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
169
192
|
requestId: effect.Schema.optional(effect.Schema.String),
|
|
170
193
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
@@ -183,8 +206,10 @@ var EsuataSchema = effect.Schema.Struct({
|
|
|
183
206
|
tip: TipVerificare,
|
|
184
207
|
query: effect.Schema.String,
|
|
185
208
|
status: effect.Schema.Literal("error"),
|
|
209
|
+
/** Motivul. Vezi {@link CodEsecVerificare}. Lipseste doar la serverele mai vechi. */
|
|
210
|
+
code: effect.Schema.optional(effect.Schema.String),
|
|
186
211
|
error: effect.Schema.String,
|
|
187
|
-
/** Doar
|
|
212
|
+
/** Doar la `INVALID_IDENTIFIER`: campul refuzat. Vezi {@link CodRefuzSursa}. */
|
|
188
213
|
cod: effect.Schema.optional(effect.Schema.String),
|
|
189
214
|
hint: effect.Schema.optional(effect.Schema.String)
|
|
190
215
|
});
|
|
@@ -240,10 +265,12 @@ var WebhookRezultatSchema = effect.Schema.Struct({
|
|
|
240
265
|
status: effect.Schema.Union(StatusDocument, effect.Schema.Literal("error")),
|
|
241
266
|
/** Rezultatul complet, `null` la `status: "error"`. */
|
|
242
267
|
result: effect.Schema.NullOr(RezultatVerificareSchema),
|
|
243
|
-
/**
|
|
268
|
+
/** Momentul verificarii, `null` la eroare. */
|
|
244
269
|
checkedAt: DataNullabila,
|
|
245
270
|
/** Mesajul de eroare, doar la `status: "error"`. */
|
|
246
|
-
error: effect.Schema.optional(effect.Schema.String)
|
|
271
|
+
error: effect.Schema.optional(effect.Schema.String),
|
|
272
|
+
/** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
|
|
273
|
+
code: effect.Schema.optional(effect.Schema.String)
|
|
247
274
|
});
|
|
248
275
|
var WebhookDocumentExpiraSchema = effect.Schema.Struct({
|
|
249
276
|
/** Numele evenimentului. */
|
|
@@ -634,7 +661,7 @@ function eroareDinRaspuns(status, headers, body) {
|
|
|
634
661
|
switch (status) {
|
|
635
662
|
case 400:
|
|
636
663
|
return new EroareValidare({ ...comun, ...c?.accepted && { acceptate: c.accepted } });
|
|
637
|
-
// 422: sursa oficiala refuza valoarea trimisa (
|
|
664
|
+
// 422: sursa oficiala refuza valoarea trimisa (INVALID_IDENTIFIER).
|
|
638
665
|
case 422:
|
|
639
666
|
return new EroareValidare(comun);
|
|
640
667
|
case 401:
|
|
@@ -1012,7 +1039,7 @@ var interpreteaza = (raspuns, serieSasiu, sinceImplicit) => decodeaza(RaspunsVer
|
|
|
1012
1039
|
return effect.Effect.fail(
|
|
1013
1040
|
new EroareVerificare({
|
|
1014
1041
|
message: corp.error,
|
|
1015
|
-
cod: "VERIFICARE_ESUATA",
|
|
1042
|
+
cod: corp.code ?? "VERIFICARE_ESUATA",
|
|
1016
1043
|
raspuns: corp,
|
|
1017
1044
|
...corp.cod && { codSursa: corp.cod },
|
|
1018
1045
|
...corp.hint && { hint: corp.hint }
|
|
@@ -1109,7 +1136,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
|
|
|
1109
1136
|
) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
|
|
1110
1137
|
|
|
1111
1138
|
// src/client.ts
|
|
1112
|
-
var VERSIUNE_SDK = "0.
|
|
1139
|
+
var VERSIUNE_SDK = "0.5.0";
|
|
1113
1140
|
var URL_IMPLICIT = "https://api.acteo.ro";
|
|
1114
1141
|
var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
|
|
1115
1142
|
var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
|
|
@@ -1184,9 +1211,8 @@ var ClientVerificari = class {
|
|
|
1184
1211
|
/**
|
|
1185
1212
|
* Porneste o verificare si consuma o unitate din cota planului.
|
|
1186
1213
|
*
|
|
1187
|
-
*
|
|
1188
|
-
*
|
|
1189
|
-
* coada si primesti `status: "processing"`; rezultatul il afli cu
|
|
1214
|
+
* Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
|
|
1215
|
+
* primesti `status: "processing"`; rezultatul il afli cu
|
|
1190
1216
|
* {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
|
|
1191
1217
|
* prin webhook, daca ai trimis `callbackUrl`.
|
|
1192
1218
|
*
|
|
@@ -1200,7 +1226,7 @@ var ClientVerificari = class {
|
|
|
1200
1226
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1201
1227
|
* @throws {@link EroareAutentificare} cheie API invalida (401).
|
|
1202
1228
|
* @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
|
|
1203
|
-
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "
|
|
1229
|
+
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1204
1230
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1205
1231
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
1206
1232
|
* @throws {@link EroareRetea} fara raspuns sau timeout.
|
|
@@ -1259,7 +1285,7 @@ var ClientVerificari = class {
|
|
|
1259
1285
|
* @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
|
|
1260
1286
|
* @returns rezultatul final al verificarii.
|
|
1261
1287
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1262
|
-
* @throws {@link EroareLimita} cota atinsa (`cod: "
|
|
1288
|
+
* @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1263
1289
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1264
1290
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1265
1291
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
@@ -1497,14 +1523,14 @@ var ClientDocument = class {
|
|
|
1497
1523
|
}
|
|
1498
1524
|
/**
|
|
1499
1525
|
* Verifica documentul si asteapta rezultatul final de la sursa oficiala.
|
|
1500
|
-
* Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
|
|
1501
1526
|
*
|
|
1502
1527
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1503
1528
|
* @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
|
|
1504
1529
|
* @returns rezultatul final.
|
|
1505
1530
|
* @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
|
|
1506
|
-
* @throws {@link EroareLimita} cota
|
|
1507
|
-
* @throws {@link
|
|
1531
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1532
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1533
|
+
* @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
|
|
1508
1534
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1509
1535
|
*/
|
|
1510
1536
|
verifica(identificator, optiuni) {
|
|
@@ -1514,14 +1540,15 @@ var ClientDocument = class {
|
|
|
1514
1540
|
);
|
|
1515
1541
|
}
|
|
1516
1542
|
/**
|
|
1517
|
-
* Porneste verificarea fara sa astepte. Primesti
|
|
1518
|
-
* vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
|
|
1543
|
+
* Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
|
|
1519
1544
|
* afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
|
|
1520
1545
|
* sau prin webhook la `callbackUrl`.
|
|
1521
1546
|
*
|
|
1522
1547
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1523
1548
|
* @param optiuni `callbackUrl` si `signal`.
|
|
1524
1549
|
* @returns rezultatul final sau verificarea in curs.
|
|
1550
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1551
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1525
1552
|
*/
|
|
1526
1553
|
porneste(identificator, optiuni) {
|
|
1527
1554
|
const cerere = {
|
|
@@ -1601,7 +1628,7 @@ var ClientVin = class {
|
|
|
1601
1628
|
* @returns decodarea, completa, partiala sau doar structura.
|
|
1602
1629
|
* @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
|
|
1603
1630
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
|
|
1604
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1631
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
|
|
1605
1632
|
* @example
|
|
1606
1633
|
* const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
|
|
1607
1634
|
* console.log(d.marca, d.model, d.anFabricatie)
|
|
@@ -1625,10 +1652,10 @@ var ClientNumere = class {
|
|
|
1625
1652
|
* @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
|
|
1626
1653
|
* @param optiuni `signal` pentru anulare.
|
|
1627
1654
|
* @returns verdictul DGPCI.
|
|
1628
|
-
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`
|
|
1655
|
+
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
|
|
1629
1656
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
|
|
1630
1657
|
* @throws {@link EroareLimita} cota atinsa.
|
|
1631
|
-
* @throws {@link EroareServer} `
|
|
1658
|
+
* @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
|
|
1632
1659
|
* @example
|
|
1633
1660
|
* const r = await acteo.auto.numere.verifica("BV07ABC")
|
|
1634
1661
|
* if (r.disponibil) console.log("Numarul e liber")
|
|
@@ -1654,7 +1681,7 @@ var ClientImagini = class {
|
|
|
1654
1681
|
* @returns poza masinii sau poza generica.
|
|
1655
1682
|
* @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
|
|
1656
1683
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
1657
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1684
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
|
|
1658
1685
|
* @example
|
|
1659
1686
|
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
|
|
1660
1687
|
* if (p.status === "gata") afiseaza(p.url)
|
|
@@ -1751,6 +1778,7 @@ var Acteo = class {
|
|
|
1751
1778
|
|
|
1752
1779
|
exports.Acteo = Acteo;
|
|
1753
1780
|
exports.ActeoError = VerificRcaError;
|
|
1781
|
+
exports.CODURI_EROARE = CODURI_EROARE;
|
|
1754
1782
|
exports.ClientAuto = ClientAuto;
|
|
1755
1783
|
exports.ClientDocument = ClientDocument;
|
|
1756
1784
|
exports.ClientImagini = ClientImagini;
|