@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/dist/index.d.cts
CHANGED
|
@@ -14,6 +14,35 @@ type TipVerificare = typeof TipVerificare.Type;
|
|
|
14
14
|
declare const StatusDocument: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
15
15
|
/** Starea documentului: `"valid"`, `"warning"`, `"expired"` sau `"not_found"`. Vezi {@link StatusDocument}. */
|
|
16
16
|
type StatusDocument = typeof StatusDocument.Type;
|
|
17
|
+
/**
|
|
18
|
+
* Codurile stabile pe care API-ul le pune in `code`, in ordinea din documentatie.
|
|
19
|
+
* Primele opt sunt cele din contract:
|
|
20
|
+
* - `UPSTREAM_UNAVAILABLE`: sursa oficiala nu raspunde sau raspunde cu eroare;
|
|
21
|
+
* - `UPSTREAM_TIMEOUT`: sursa oficiala nu a raspuns in intervalul maxim;
|
|
22
|
+
* - `UPSTREAM_BLOCKED`: accesul la sursa oficiala e restrictionat temporar;
|
|
23
|
+
* - `UPSTREAM_CHANGED`: structura sursei s-a modificat, serviciul e in adaptare;
|
|
24
|
+
* - `DAILY_LIMIT_REACHED`: limita zilnica a planului, se reseteaza la miezul noptii (ora Romaniei);
|
|
25
|
+
* - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
|
|
26
|
+
* - `NOT_FOUND`: identificatorul nu exista la sursa oficiala;
|
|
27
|
+
* - `INVALID_IDENTIFIER`: sursa oficiala a respins identificatorul ca invalid.
|
|
28
|
+
*
|
|
29
|
+
* Restul tin de un produs anume: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`,
|
|
30
|
+
* `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS`
|
|
31
|
+
* (numarul de masini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
|
|
32
|
+
*/
|
|
33
|
+
declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA"];
|
|
34
|
+
/**
|
|
35
|
+
* Un cod din {@link CODURI_EROARE}. Tipul accepta si alte valori, ca un cod adaugat
|
|
36
|
+
* ulterior de API sa nu strice compilarea.
|
|
37
|
+
*/
|
|
38
|
+
type CodEroare = (typeof CODURI_EROARE)[number] | (string & {});
|
|
39
|
+
/**
|
|
40
|
+
* De ce s-a incheiat o verificare cu `status: "error"`:
|
|
41
|
+
* - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise; campul e in `cod` ({@link CodRefuzSursa});
|
|
42
|
+
* - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`: sursa
|
|
43
|
+
* oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
|
|
44
|
+
*/
|
|
45
|
+
type CodEsecVerificare = "INVALID_IDENTIFIER" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_TIMEOUT" | "UPSTREAM_BLOCKED" | "UPSTREAM_CHANGED" | (string & {});
|
|
17
46
|
declare const RezultatVerificareSchema: Schema.Struct<{
|
|
18
47
|
/** Tipul verificarii. */
|
|
19
48
|
tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
|
|
@@ -23,12 +52,14 @@ declare const RezultatVerificareSchema: Schema.Struct<{
|
|
|
23
52
|
numarInmatriculare: Schema.NullOr<typeof Schema.String>;
|
|
24
53
|
/** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
|
|
25
54
|
serieSasiu: Schema.NullOr<typeof Schema.String>;
|
|
26
|
-
/**
|
|
55
|
+
/** Momentul verificarii. */
|
|
27
56
|
checkedAt: typeof Schema.Date;
|
|
28
57
|
/** Starea documentului. Vezi {@link StatusDocument}. */
|
|
29
58
|
status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
30
59
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
31
60
|
expiresAt: Schema.NullOr<typeof Schema.Date>;
|
|
61
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
62
|
+
code: Schema.optional<typeof Schema.String>;
|
|
32
63
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
33
64
|
requestId: Schema.optional<typeof Schema.String>;
|
|
34
65
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
@@ -98,21 +129,25 @@ declare const WebhookRezultatSchema: Schema.Struct<{
|
|
|
98
129
|
numarInmatriculare: Schema.NullOr<typeof Schema.String>;
|
|
99
130
|
/** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
|
|
100
131
|
serieSasiu: Schema.NullOr<typeof Schema.String>;
|
|
101
|
-
/**
|
|
132
|
+
/** Momentul verificarii. */
|
|
102
133
|
checkedAt: typeof Schema.Date;
|
|
103
134
|
/** Starea documentului. Vezi {@link StatusDocument}. */
|
|
104
135
|
status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
105
136
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
106
137
|
expiresAt: Schema.NullOr<typeof Schema.Date>;
|
|
138
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
139
|
+
code: Schema.optional<typeof Schema.String>;
|
|
107
140
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
108
141
|
requestId: Schema.optional<typeof Schema.String>;
|
|
109
142
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
110
143
|
hint: Schema.optional<typeof Schema.String>;
|
|
111
144
|
}>>;
|
|
112
|
-
/**
|
|
145
|
+
/** Momentul verificarii, `null` la eroare. */
|
|
113
146
|
checkedAt: Schema.NullOr<typeof Schema.Date>;
|
|
114
147
|
/** Mesajul de eroare, doar la `status: "error"`. */
|
|
115
148
|
error: Schema.optional<typeof Schema.String>;
|
|
149
|
+
/** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
|
|
150
|
+
code: Schema.optional<typeof Schema.String>;
|
|
116
151
|
}>;
|
|
117
152
|
/** Payloadul POST trimis la `callbackUrl` cand o verificare se termina. */
|
|
118
153
|
type WebhookRezultat = typeof WebhookRezultatSchema.Type;
|
|
@@ -752,8 +787,12 @@ interface DateEroare {
|
|
|
752
787
|
readonly message: string;
|
|
753
788
|
/** Statusul HTTP, cand eroarea vine dintr-un raspuns. */
|
|
754
789
|
readonly status?: number;
|
|
755
|
-
/**
|
|
756
|
-
|
|
790
|
+
/**
|
|
791
|
+
* Codul masinii. De la API vine unul din {@link CodEroare} (`DAILY_LIMIT_REACHED`,
|
|
792
|
+
* `UPSTREAM_TIMEOUT`, `VEHICUL_EXISTENT` etc.); SDK-ul pune singur cateva coduri
|
|
793
|
+
* locale (`VALIDARE_LOCALA`, `TIMEOUT_VERIFICARE`, `PREA_MULTE_CERERI`).
|
|
794
|
+
*/
|
|
795
|
+
readonly cod?: CodEroare;
|
|
757
796
|
/** Indicatia API-ului despre cum se rezolva problema. */
|
|
758
797
|
readonly hint?: string;
|
|
759
798
|
/** Corpul brut al raspunsului, pentru depanare. */
|
|
@@ -781,7 +820,7 @@ declare class EroareConfigurare extends VerificRcaError {
|
|
|
781
820
|
/**
|
|
782
821
|
* Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
|
|
783
822
|
* consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand sursa
|
|
784
|
-
* oficiala refuza valoarea (
|
|
823
|
+
* oficiala refuza valoarea (`INVALID_IDENTIFIER` la numerele disponibile).
|
|
785
824
|
*/
|
|
786
825
|
declare class EroareValidare extends VerificRcaError {
|
|
787
826
|
/** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
|
|
@@ -849,9 +888,14 @@ declare class EroareConflict extends VerificRcaError {
|
|
|
849
888
|
}
|
|
850
889
|
/**
|
|
851
890
|
* 429: limita a fost atinsa. `cod` spune care:
|
|
852
|
-
* - `
|
|
891
|
+
* - `DAILY_LIMIT_REACHED`: limita zilnica a planului; se reseteaza la miezul noptii,
|
|
892
|
+
* ora Romaniei, iar `retryAfterMs` spune cat mai e;
|
|
893
|
+
* - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
|
|
894
|
+
* - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
|
|
895
|
+
* - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
|
|
853
896
|
* - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
|
|
854
|
-
* - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur)
|
|
897
|
+
* - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur);
|
|
898
|
+
* - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
|
|
855
899
|
*/
|
|
856
900
|
declare class EroareLimita extends VerificRcaError {
|
|
857
901
|
/** Discriminantul erorii: `"EroareLimita"`. Util in `switch (err._tag)`. */
|
|
@@ -876,9 +920,11 @@ declare class EroareLimita extends VerificRcaError {
|
|
|
876
920
|
});
|
|
877
921
|
}
|
|
878
922
|
/**
|
|
879
|
-
* 5xx: eroare pe serverul API-ului. Cererile sigure se
|
|
880
|
-
*
|
|
881
|
-
* `
|
|
923
|
+
* 5xx: eroare pe serverul API-ului sau la sursa oficiala. Cererile sigure se
|
|
924
|
+
* reincearca automat. Cand `cod` exista, cererea nu s-a taxat:
|
|
925
|
+
* - `UPSTREAM_UNAVAILABLE` (502), `UPSTREAM_TIMEOUT` (504): sursa oficiala nu a raspuns;
|
|
926
|
+
* - `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED` (503): sursa e oprita temporar, reia dupa `retryAfterMs`;
|
|
927
|
+
* - `OCUPAT`, `INDISPONIBIL` (503): verificarea nu poate porni acum.
|
|
882
928
|
*/
|
|
883
929
|
declare class EroareServer extends VerificRcaError {
|
|
884
930
|
/** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
|
|
@@ -934,12 +980,15 @@ declare class EroareRaspunsInvalid extends VerificRcaError {
|
|
|
934
980
|
readonly name = "EroareRaspunsInvalid";
|
|
935
981
|
}
|
|
936
982
|
/**
|
|
937
|
-
* Verificarea s-a incheiat cu statusul `error`.
|
|
938
|
-
*
|
|
939
|
-
*
|
|
940
|
-
*
|
|
941
|
-
*
|
|
942
|
-
*
|
|
983
|
+
* Verificarea s-a incheiat cu statusul `error`. `cod` spune de ce (vezi
|
|
984
|
+
* {@link CodEsecVerificare}):
|
|
985
|
+
* - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise, iar `codSursa` spune ce
|
|
986
|
+
* camp e gresit (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O
|
|
987
|
+
* reincercare cu aceleasi date nu ajuta; corecteaza campul intai;
|
|
988
|
+
* - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`:
|
|
989
|
+
* sursa oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
|
|
990
|
+
*
|
|
991
|
+
* Un server mai vechi, fara cod, da `cod: "VERIFICARE_ESUATA"`.
|
|
943
992
|
*/
|
|
944
993
|
declare class EroareVerificare extends VerificRcaError {
|
|
945
994
|
/** Discriminantul erorii: `"EroareVerificare"`. Util in `switch (err._tag)`. */
|
|
@@ -1185,7 +1234,7 @@ interface OptiuniAsteptare {
|
|
|
1185
1234
|
}
|
|
1186
1235
|
|
|
1187
1236
|
/** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
|
|
1188
|
-
declare const VERSIUNE_SDK = "0.
|
|
1237
|
+
declare const VERSIUNE_SDK = "0.5.0";
|
|
1189
1238
|
/** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
|
|
1190
1239
|
declare const URL_IMPLICIT = "https://api.acteo.ro";
|
|
1191
1240
|
/** Adresa implicita a clientului legacy {@link VerificRca}. */
|
|
@@ -1233,9 +1282,8 @@ declare class ClientVerificari {
|
|
|
1233
1282
|
/**
|
|
1234
1283
|
* Porneste o verificare si consuma o unitate din cota planului.
|
|
1235
1284
|
*
|
|
1236
|
-
*
|
|
1237
|
-
*
|
|
1238
|
-
* coada si primesti `status: "processing"`; rezultatul il afli cu
|
|
1285
|
+
* Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
|
|
1286
|
+
* primesti `status: "processing"`; rezultatul il afli cu
|
|
1239
1287
|
* {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
|
|
1240
1288
|
* prin webhook, daca ai trimis `callbackUrl`.
|
|
1241
1289
|
*
|
|
@@ -1249,7 +1297,7 @@ declare class ClientVerificari {
|
|
|
1249
1297
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1250
1298
|
* @throws {@link EroareAutentificare} cheie API invalida (401).
|
|
1251
1299
|
* @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
|
|
1252
|
-
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "
|
|
1300
|
+
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1253
1301
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1254
1302
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
1255
1303
|
* @throws {@link EroareRetea} fara raspuns sau timeout.
|
|
@@ -1302,7 +1350,7 @@ declare class ClientVerificari {
|
|
|
1302
1350
|
* @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
|
|
1303
1351
|
* @returns rezultatul final al verificarii.
|
|
1304
1352
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1305
|
-
* @throws {@link EroareLimita} cota atinsa (`cod: "
|
|
1353
|
+
* @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1306
1354
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1307
1355
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1308
1356
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
@@ -1547,26 +1595,27 @@ declare class ClientDocument<T extends TipVerificare, I> {
|
|
|
1547
1595
|
constructor(ruleaza: Rulare, mapare: Mapare<I>);
|
|
1548
1596
|
/**
|
|
1549
1597
|
* Verifica documentul si asteapta rezultatul final de la sursa oficiala.
|
|
1550
|
-
* Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
|
|
1551
1598
|
*
|
|
1552
1599
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1553
1600
|
* @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
|
|
1554
1601
|
* @returns rezultatul final.
|
|
1555
1602
|
* @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
|
|
1556
|
-
* @throws {@link EroareLimita} cota
|
|
1557
|
-
* @throws {@link
|
|
1603
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1604
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1605
|
+
* @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
|
|
1558
1606
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1559
1607
|
*/
|
|
1560
1608
|
verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
|
|
1561
1609
|
/**
|
|
1562
|
-
* Porneste verificarea fara sa astepte. Primesti
|
|
1563
|
-
* vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
|
|
1610
|
+
* Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
|
|
1564
1611
|
* afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
|
|
1565
1612
|
* sau prin webhook la `callbackUrl`.
|
|
1566
1613
|
*
|
|
1567
1614
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1568
1615
|
* @param optiuni `callbackUrl` si `signal`.
|
|
1569
1616
|
* @returns rezultatul final sau verificarea in curs.
|
|
1617
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1618
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1570
1619
|
*/
|
|
1571
1620
|
porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
|
|
1572
1621
|
/**
|
|
@@ -1609,7 +1658,7 @@ declare class ClientVin {
|
|
|
1609
1658
|
* @returns decodarea, completa, partiala sau doar structura.
|
|
1610
1659
|
* @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
|
|
1611
1660
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
|
|
1612
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1661
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
|
|
1613
1662
|
* @example
|
|
1614
1663
|
* const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
|
|
1615
1664
|
* console.log(d.marca, d.model, d.anFabricatie)
|
|
@@ -1630,10 +1679,10 @@ declare class ClientNumere {
|
|
|
1630
1679
|
* @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
|
|
1631
1680
|
* @param optiuni `signal` pentru anulare.
|
|
1632
1681
|
* @returns verdictul DGPCI.
|
|
1633
|
-
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`
|
|
1682
|
+
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
|
|
1634
1683
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
|
|
1635
1684
|
* @throws {@link EroareLimita} cota atinsa.
|
|
1636
|
-
* @throws {@link EroareServer} `
|
|
1685
|
+
* @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
|
|
1637
1686
|
* @example
|
|
1638
1687
|
* const r = await acteo.auto.numere.verifica("BV07ABC")
|
|
1639
1688
|
* if (r.disponibil) console.log("Numarul e liber")
|
|
@@ -1656,7 +1705,7 @@ declare class ClientImagini {
|
|
|
1656
1705
|
* @returns poza masinii sau poza generica.
|
|
1657
1706
|
* @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
|
|
1658
1707
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
1659
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1708
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
|
|
1660
1709
|
* @example
|
|
1661
1710
|
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
|
|
1662
1711
|
* if (p.status === "gata") afiseaza(p.url)
|
|
@@ -1748,4 +1797,4 @@ declare class Acteo {
|
|
|
1748
1797
|
constructor(optiuni?: OptiuniClient);
|
|
1749
1798
|
}
|
|
1750
1799
|
|
|
1751
|
-
export { Acteo, VerificRcaError as ActeoError, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
|
|
1800
|
+
export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
|
package/dist/index.d.ts
CHANGED
|
@@ -14,6 +14,35 @@ type TipVerificare = typeof TipVerificare.Type;
|
|
|
14
14
|
declare const StatusDocument: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
15
15
|
/** Starea documentului: `"valid"`, `"warning"`, `"expired"` sau `"not_found"`. Vezi {@link StatusDocument}. */
|
|
16
16
|
type StatusDocument = typeof StatusDocument.Type;
|
|
17
|
+
/**
|
|
18
|
+
* Codurile stabile pe care API-ul le pune in `code`, in ordinea din documentatie.
|
|
19
|
+
* Primele opt sunt cele din contract:
|
|
20
|
+
* - `UPSTREAM_UNAVAILABLE`: sursa oficiala nu raspunde sau raspunde cu eroare;
|
|
21
|
+
* - `UPSTREAM_TIMEOUT`: sursa oficiala nu a raspuns in intervalul maxim;
|
|
22
|
+
* - `UPSTREAM_BLOCKED`: accesul la sursa oficiala e restrictionat temporar;
|
|
23
|
+
* - `UPSTREAM_CHANGED`: structura sursei s-a modificat, serviciul e in adaptare;
|
|
24
|
+
* - `DAILY_LIMIT_REACHED`: limita zilnica a planului, se reseteaza la miezul noptii (ora Romaniei);
|
|
25
|
+
* - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
|
|
26
|
+
* - `NOT_FOUND`: identificatorul nu exista la sursa oficiala;
|
|
27
|
+
* - `INVALID_IDENTIFIER`: sursa oficiala a respins identificatorul ca invalid.
|
|
28
|
+
*
|
|
29
|
+
* Restul tin de un produs anume: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`,
|
|
30
|
+
* `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS`
|
|
31
|
+
* (numarul de masini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
|
|
32
|
+
*/
|
|
33
|
+
declare const CODURI_EROARE: readonly ["UPSTREAM_UNAVAILABLE", "UPSTREAM_TIMEOUT", "UPSTREAM_BLOCKED", "UPSTREAM_CHANGED", "DAILY_LIMIT_REACHED", "PLAN_LIMIT_REACHED", "NOT_FOUND", "INVALID_IDENTIFIER", "SOLD_INSUFICIENT", "PLAFON_NETAXAT", "OCUPAT", "INDISPONIBIL", "VIN_NEDECODAT", "VIN_INVALID", "ARR_NECESITA_PLAN", "LIMIT_ATINS", "VEHICUL_EXISTENT", "NEGASIT", "LIMITA_FLOTA_ATINSA"];
|
|
34
|
+
/**
|
|
35
|
+
* Un cod din {@link CODURI_EROARE}. Tipul accepta si alte valori, ca un cod adaugat
|
|
36
|
+
* ulterior de API sa nu strice compilarea.
|
|
37
|
+
*/
|
|
38
|
+
type CodEroare = (typeof CODURI_EROARE)[number] | (string & {});
|
|
39
|
+
/**
|
|
40
|
+
* De ce s-a incheiat o verificare cu `status: "error"`:
|
|
41
|
+
* - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise; campul e in `cod` ({@link CodRefuzSursa});
|
|
42
|
+
* - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`: sursa
|
|
43
|
+
* oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
|
|
44
|
+
*/
|
|
45
|
+
type CodEsecVerificare = "INVALID_IDENTIFIER" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_TIMEOUT" | "UPSTREAM_BLOCKED" | "UPSTREAM_CHANGED" | (string & {});
|
|
17
46
|
declare const RezultatVerificareSchema: Schema.Struct<{
|
|
18
47
|
/** Tipul verificarii. */
|
|
19
48
|
tip: Schema.Literal<["rca", "itp", "rovinieta", "arr"]>;
|
|
@@ -23,12 +52,14 @@ declare const RezultatVerificareSchema: Schema.Struct<{
|
|
|
23
52
|
numarInmatriculare: Schema.NullOr<typeof Schema.String>;
|
|
24
53
|
/** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
|
|
25
54
|
serieSasiu: Schema.NullOr<typeof Schema.String>;
|
|
26
|
-
/**
|
|
55
|
+
/** Momentul verificarii. */
|
|
27
56
|
checkedAt: typeof Schema.Date;
|
|
28
57
|
/** Starea documentului. Vezi {@link StatusDocument}. */
|
|
29
58
|
status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
30
59
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
31
60
|
expiresAt: Schema.NullOr<typeof Schema.Date>;
|
|
61
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
62
|
+
code: Schema.optional<typeof Schema.String>;
|
|
32
63
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
33
64
|
requestId: Schema.optional<typeof Schema.String>;
|
|
34
65
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
@@ -98,21 +129,25 @@ declare const WebhookRezultatSchema: Schema.Struct<{
|
|
|
98
129
|
numarInmatriculare: Schema.NullOr<typeof Schema.String>;
|
|
99
130
|
/** Seria de sasiu (VIN) verificata, `null` cand cautarea s-a facut doar dupa numar. */
|
|
100
131
|
serieSasiu: Schema.NullOr<typeof Schema.String>;
|
|
101
|
-
/**
|
|
132
|
+
/** Momentul verificarii. */
|
|
102
133
|
checkedAt: typeof Schema.Date;
|
|
103
134
|
/** Starea documentului. Vezi {@link StatusDocument}. */
|
|
104
135
|
status: Schema.Literal<["valid", "warning", "expired", "not_found"]>;
|
|
105
136
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
106
137
|
expiresAt: Schema.NullOr<typeof Schema.Date>;
|
|
138
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
139
|
+
code: Schema.optional<typeof Schema.String>;
|
|
107
140
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
108
141
|
requestId: Schema.optional<typeof Schema.String>;
|
|
109
142
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
110
143
|
hint: Schema.optional<typeof Schema.String>;
|
|
111
144
|
}>>;
|
|
112
|
-
/**
|
|
145
|
+
/** Momentul verificarii, `null` la eroare. */
|
|
113
146
|
checkedAt: Schema.NullOr<typeof Schema.Date>;
|
|
114
147
|
/** Mesajul de eroare, doar la `status: "error"`. */
|
|
115
148
|
error: Schema.optional<typeof Schema.String>;
|
|
149
|
+
/** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
|
|
150
|
+
code: Schema.optional<typeof Schema.String>;
|
|
116
151
|
}>;
|
|
117
152
|
/** Payloadul POST trimis la `callbackUrl` cand o verificare se termina. */
|
|
118
153
|
type WebhookRezultat = typeof WebhookRezultatSchema.Type;
|
|
@@ -752,8 +787,12 @@ interface DateEroare {
|
|
|
752
787
|
readonly message: string;
|
|
753
788
|
/** Statusul HTTP, cand eroarea vine dintr-un raspuns. */
|
|
754
789
|
readonly status?: number;
|
|
755
|
-
/**
|
|
756
|
-
|
|
790
|
+
/**
|
|
791
|
+
* Codul masinii. De la API vine unul din {@link CodEroare} (`DAILY_LIMIT_REACHED`,
|
|
792
|
+
* `UPSTREAM_TIMEOUT`, `VEHICUL_EXISTENT` etc.); SDK-ul pune singur cateva coduri
|
|
793
|
+
* locale (`VALIDARE_LOCALA`, `TIMEOUT_VERIFICARE`, `PREA_MULTE_CERERI`).
|
|
794
|
+
*/
|
|
795
|
+
readonly cod?: CodEroare;
|
|
757
796
|
/** Indicatia API-ului despre cum se rezolva problema. */
|
|
758
797
|
readonly hint?: string;
|
|
759
798
|
/** Corpul brut al raspunsului, pentru depanare. */
|
|
@@ -781,7 +820,7 @@ declare class EroareConfigurare extends VerificRcaError {
|
|
|
781
820
|
/**
|
|
782
821
|
* Datele trimise sunt invalide. Apare fie local, inainte de orice cerere (nu se
|
|
783
822
|
* consuma nimic din cota), fie ca raspuns 400 de la API, fie ca 422 cand sursa
|
|
784
|
-
* oficiala refuza valoarea (
|
|
823
|
+
* oficiala refuza valoarea (`INVALID_IDENTIFIER` la numerele disponibile).
|
|
785
824
|
*/
|
|
786
825
|
declare class EroareValidare extends VerificRcaError {
|
|
787
826
|
/** Discriminantul erorii: `"EroareValidare"`. Util in `switch (err._tag)`. */
|
|
@@ -849,9 +888,14 @@ declare class EroareConflict extends VerificRcaError {
|
|
|
849
888
|
}
|
|
850
889
|
/**
|
|
851
890
|
* 429: limita a fost atinsa. `cod` spune care:
|
|
852
|
-
* - `
|
|
891
|
+
* - `DAILY_LIMIT_REACHED`: limita zilnica a planului; se reseteaza la miezul noptii,
|
|
892
|
+
* ora Romaniei, iar `retryAfterMs` spune cat mai e;
|
|
893
|
+
* - `PLAN_LIMIT_REACHED`: limita lunara, sau plafonul consumului peste plan;
|
|
894
|
+
* - `SOLD_INSUFICIENT`: soldul preplatit nu acopera cererile peste plan;
|
|
895
|
+
* - `PLAFON_NETAXAT`: prea multe raspunsuri netaxate azi (decodari, poze generice);
|
|
853
896
|
* - `LIMITA_FLOTA_ATINSA`: plafonul zilnic de adaugari/stergeri de vehicule;
|
|
854
|
-
* - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur)
|
|
897
|
+
* - `PREA_MULTE_CERERI`: polling prea des (SDK-ul reincearca singur);
|
|
898
|
+
* - `COTA_ATINSA`: cota atinsa, de la un server mai vechi care nu trimite cod.
|
|
855
899
|
*/
|
|
856
900
|
declare class EroareLimita extends VerificRcaError {
|
|
857
901
|
/** Discriminantul erorii: `"EroareLimita"`. Util in `switch (err._tag)`. */
|
|
@@ -876,9 +920,11 @@ declare class EroareLimita extends VerificRcaError {
|
|
|
876
920
|
});
|
|
877
921
|
}
|
|
878
922
|
/**
|
|
879
|
-
* 5xx: eroare pe serverul API-ului. Cererile sigure se
|
|
880
|
-
*
|
|
881
|
-
* `
|
|
923
|
+
* 5xx: eroare pe serverul API-ului sau la sursa oficiala. Cererile sigure se
|
|
924
|
+
* reincearca automat. Cand `cod` exista, cererea nu s-a taxat:
|
|
925
|
+
* - `UPSTREAM_UNAVAILABLE` (502), `UPSTREAM_TIMEOUT` (504): sursa oficiala nu a raspuns;
|
|
926
|
+
* - `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED` (503): sursa e oprita temporar, reia dupa `retryAfterMs`;
|
|
927
|
+
* - `OCUPAT`, `INDISPONIBIL` (503): verificarea nu poate porni acum.
|
|
882
928
|
*/
|
|
883
929
|
declare class EroareServer extends VerificRcaError {
|
|
884
930
|
/** Discriminantul erorii: `"EroareServer"`. Util in `switch (err._tag)`. */
|
|
@@ -934,12 +980,15 @@ declare class EroareRaspunsInvalid extends VerificRcaError {
|
|
|
934
980
|
readonly name = "EroareRaspunsInvalid";
|
|
935
981
|
}
|
|
936
982
|
/**
|
|
937
|
-
* Verificarea s-a incheiat cu statusul `error`.
|
|
938
|
-
*
|
|
939
|
-
*
|
|
940
|
-
*
|
|
941
|
-
*
|
|
942
|
-
*
|
|
983
|
+
* Verificarea s-a incheiat cu statusul `error`. `cod` spune de ce (vezi
|
|
984
|
+
* {@link CodEsecVerificare}):
|
|
985
|
+
* - `INVALID_IDENTIFIER`: sursa a refuzat datele trimise, iar `codSursa` spune ce
|
|
986
|
+
* camp e gresit (`serie_talon_invalida`, `vin_invalid`, `numar_invalid`). O
|
|
987
|
+
* reincercare cu aceleasi date nu ajuta; corecteaza campul intai;
|
|
988
|
+
* - `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`:
|
|
989
|
+
* sursa oficiala nu a dat un raspuns; reia mai tarziu cu o cerere noua.
|
|
990
|
+
*
|
|
991
|
+
* Un server mai vechi, fara cod, da `cod: "VERIFICARE_ESUATA"`.
|
|
943
992
|
*/
|
|
944
993
|
declare class EroareVerificare extends VerificRcaError {
|
|
945
994
|
/** Discriminantul erorii: `"EroareVerificare"`. Util in `switch (err._tag)`. */
|
|
@@ -1185,7 +1234,7 @@ interface OptiuniAsteptare {
|
|
|
1185
1234
|
}
|
|
1186
1235
|
|
|
1187
1236
|
/** Versiunea acestui SDK, trimisa si in headerul `User-Agent`. */
|
|
1188
|
-
declare const VERSIUNE_SDK = "0.
|
|
1237
|
+
declare const VERSIUNE_SDK = "0.5.0";
|
|
1189
1238
|
/** Adresa implicita a API-ului pentru clientul {@link Acteo}. */
|
|
1190
1239
|
declare const URL_IMPLICIT = "https://api.acteo.ro";
|
|
1191
1240
|
/** Adresa implicita a clientului legacy {@link VerificRca}. */
|
|
@@ -1233,9 +1282,8 @@ declare class ClientVerificari {
|
|
|
1233
1282
|
/**
|
|
1234
1283
|
* Porneste o verificare si consuma o unitate din cota planului.
|
|
1235
1284
|
*
|
|
1236
|
-
*
|
|
1237
|
-
*
|
|
1238
|
-
* coada si primesti `status: "processing"`; rezultatul il afli cu
|
|
1285
|
+
* Fiecare cerere interogheaza sursa oficiala: verificarea intra in coada si
|
|
1286
|
+
* primesti `status: "processing"`; rezultatul il afli cu
|
|
1239
1287
|
* {@link ClientVerificari.rezultat}, {@link ClientVerificari.asteapta} sau
|
|
1240
1288
|
* prin webhook, daca ai trimis `callbackUrl`.
|
|
1241
1289
|
*
|
|
@@ -1249,7 +1297,7 @@ declare class ClientVerificari {
|
|
|
1249
1297
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1250
1298
|
* @throws {@link EroareAutentificare} cheie API invalida (401).
|
|
1251
1299
|
* @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
|
|
1252
|
-
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "
|
|
1300
|
+
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1253
1301
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1254
1302
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
1255
1303
|
* @throws {@link EroareRetea} fara raspuns sau timeout.
|
|
@@ -1302,7 +1350,7 @@ declare class ClientVerificari {
|
|
|
1302
1350
|
* @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
|
|
1303
1351
|
* @returns rezultatul final al verificarii.
|
|
1304
1352
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1305
|
-
* @throws {@link EroareLimita} cota atinsa (`cod: "
|
|
1353
|
+
* @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1306
1354
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1307
1355
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1308
1356
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
@@ -1547,26 +1595,27 @@ declare class ClientDocument<T extends TipVerificare, I> {
|
|
|
1547
1595
|
constructor(ruleaza: Rulare, mapare: Mapare<I>);
|
|
1548
1596
|
/**
|
|
1549
1597
|
* Verifica documentul si asteapta rezultatul final de la sursa oficiala.
|
|
1550
|
-
* Daca vehiculul a fost verificat de curand, rezultatul vine imediat.
|
|
1551
1598
|
*
|
|
1552
1599
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1553
1600
|
* @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
|
|
1554
1601
|
* @returns rezultatul final.
|
|
1555
1602
|
* @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
|
|
1556
|
-
* @throws {@link EroareLimita} cota
|
|
1557
|
-
* @throws {@link
|
|
1603
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1604
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1605
|
+
* @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
|
|
1558
1606
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1559
1607
|
*/
|
|
1560
1608
|
verifica(identificator: I, optiuni?: OptiuniVerifica): Promise<RezultatDocument<T>>;
|
|
1561
1609
|
/**
|
|
1562
|
-
* Porneste verificarea fara sa astepte. Primesti
|
|
1563
|
-
* vehiculul a fost verificat de curand, sau `status: "processing"`; atunci
|
|
1610
|
+
* Porneste verificarea fara sa astepte. Primesti `status: "processing"`;
|
|
1564
1611
|
* afli raspunsul cu {@link ClientDocument.asteapta}, {@link ClientDocument.rezultat}
|
|
1565
1612
|
* sau prin webhook la `callbackUrl`.
|
|
1566
1613
|
*
|
|
1567
1614
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1568
1615
|
* @param optiuni `callbackUrl` si `signal`.
|
|
1569
1616
|
* @returns rezultatul final sau verificarea in curs.
|
|
1617
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1618
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1570
1619
|
*/
|
|
1571
1620
|
porneste(identificator: I, optiuni?: OptiuniPornire): Promise<RaspunsDocument<T>>;
|
|
1572
1621
|
/**
|
|
@@ -1609,7 +1658,7 @@ declare class ClientVin {
|
|
|
1609
1658
|
* @returns decodarea, completa, partiala sau doar structura.
|
|
1610
1659
|
* @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
|
|
1611
1660
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
|
|
1612
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1661
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
|
|
1613
1662
|
* @example
|
|
1614
1663
|
* const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
|
|
1615
1664
|
* console.log(d.marca, d.model, d.anFabricatie)
|
|
@@ -1630,10 +1679,10 @@ declare class ClientNumere {
|
|
|
1630
1679
|
* @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
|
|
1631
1680
|
* @param optiuni `signal` pentru anulare.
|
|
1632
1681
|
* @returns verdictul DGPCI.
|
|
1633
|
-
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`
|
|
1682
|
+
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
|
|
1634
1683
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
|
|
1635
1684
|
* @throws {@link EroareLimita} cota atinsa.
|
|
1636
|
-
* @throws {@link EroareServer} `
|
|
1685
|
+
* @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
|
|
1637
1686
|
* @example
|
|
1638
1687
|
* const r = await acteo.auto.numere.verifica("BV07ABC")
|
|
1639
1688
|
* if (r.disponibil) console.log("Numarul e liber")
|
|
@@ -1656,7 +1705,7 @@ declare class ClientImagini {
|
|
|
1656
1705
|
* @returns poza masinii sau poza generica.
|
|
1657
1706
|
* @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
|
|
1658
1707
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
1659
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1708
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
|
|
1660
1709
|
* @example
|
|
1661
1710
|
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
|
|
1662
1711
|
* if (p.status === "gata") afiseaza(p.url)
|
|
@@ -1748,4 +1797,4 @@ declare class Acteo {
|
|
|
1748
1797
|
constructor(optiuni?: OptiuniClient);
|
|
1749
1798
|
}
|
|
1750
1799
|
|
|
1751
|
-
export { Acteo, VerificRcaError as ActeoError, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
|
|
1800
|
+
export { Acteo, VerificRcaError as ActeoError, CODURI_EROARE, type CerereImagine, type CerereVerificare, type ClientArr, ClientAuto, ClientDocument, ClientImagini, type ClientItp, ClientNumere, type ClientRca, type ClientRovinieta, ClientVehicule, ClientVerificari, ClientVin, ClientWebhooks, type CodEroare, type CodEsecVerificare, type CodRefuzSursa, type DateEroare, type DecodareVin, EroareAutentificare, type EroareCerere, EroareConfigurare, EroareConflict, EroareHttp, EroareInterzis, EroareLimita, EroareNegasit, EroarePlanInactiv, EroareRaspunsInvalid, EroareRetea, EroareServer, EroareTimeoutVerificare, EroareValidare, EroareVerificare, EroareWebhook, HEADER_CHEIE_WEBHOOK, HEADER_EVENIMENT_WEBHOOK, type HeadereCerere, type IdentificatorRca, type IdentificatorRovinieta, type ImagineMasina, type Limite, type NumarDisponibil, type OptiuniAsteptare, type OptiuniAsteptareImagine, type OptiuniCerere, type OptiuniClient, type OptiuniPornire, type OptiuniVerifica, type OptiuniWebhookNotificare, type RaspunsDocument, type RaspunsVerificare, type ReferintaVerificare, type RezultatDocument, type SetariRetry, StatusDocument, StatusImagine, TIPURI_VERIFICARE, TipVerificare, UNGHIURI_IMAGINE, URL_IMPLICIT, URL_IMPLICIT_LEGACY, UnghiImagine, VERSIUNE_SDK, type Vehicul, type VehiculNou, VerificRca, VerificRcaError, type VerificareFinala, type VerificareInCurs, type VerificareInCursDocument, type WebhookAsigurareSchimbare, type WebhookDocumentExpira, type WebhookDosarEveniment, type WebhookDosarTermen, type WebhookFirmaDosar, type WebhookFirmaSchimbare, type WebhookMarcaExpira, type WebhookMarcaSchimbare, type WebhookNotificare, type WebhookRezultat, type WebhookTermenExpira, type WebhookTest, esteNumarInmatriculareValid, esteSerieTalonValida, esteVinValid, normalizeaza, normalizeazaSerieTalon, parseazaWebhookRezultat, verificaWebhookNotificare };
|