Introducere
Abonarea pe baza numărul de urmărire pentru Advanced Integrated Visibility este concepută pentru a permite utilizatorilor serviciului să gestioneze proiecte de tip webhook bazate pe numere de urmărire și să efectueze operațiuni specifice, cum ar fi adăugarea de noi numere, editarea sau vizualizarea detaliilor sarcinilor, utilizând puncte de acces ale interfeței API.
Notă:
- Trebuie să aveți acces de administrator sau contribuitor pentru proiectul dvs. Advanced Integrated Visibility
- Pentru mai multe informații despre Advanced Integrated Visibility și caracteristicile acesteia, accesați pagina Documentație Advanced Integrated Visibility.
Avantajele Abonării pe baza numărului de monitorizare la Advanced Integrated Visibility
Avantajele Abonării pe baza numărului de monitorizare la Advanced Integrated Visibility sunt:
- Puteți actualiza și gestiona cu ușurință numerele de monitorizare ale proiectului dvs. Advanced Integrated Visibility utilizând puncte finale API.
- Acest API vă permite să asociați mai multe numere de monitorizare proiectului dvs. într-o singură tranzacție API, în loc să asociați fiecare număr de monitorizare unul câte unul.
- Puteți trimite solicitări API consecutiv și puteți vizualiza detaliile jurnalului de succes/eșec al acestor solicitări.
Cum funcționează Abonarea pe baza numărului de monitorizare la Advanced Integrated Visibility:
Utilizați punctele finale de mai jos pentru a vă gestiona proiectul Advanced Integrated Visibility:
Acest API poate fi accesat numai prin prezentarea generală a proiectului, așa cum se arată în captura de ecran de mai sus.
Asocierea numărului de monitorizare
Utilizați acest punct final pentru a declanșa o sarcină asincronă pentru a asocia unul sau mai multe numere de monitorizare unui anumit proiect Advanced Integrated Visibility.
Informațiile de intrare necesare pentru această solicitare sunt:
- Acțiune – Specificați acțiunea care urmează să fie efectuată atunci când trimiteți solicitarea. Exemplu: ADĂUGARE
- Detalii număr de monitorizare – Specificați numărul de monitorizare
Puteți asocia maximum 1000 de numere de monitorizare într-o singură solicitare. Răspunsul cu succes la această solicitare va returna ID-ul activității, starea curentă a activității și datele de creare și de finalizare a activității. Acest ID al activității poate fi utilizat ulterior pentru a verifica starea activității asincrone.
Stare activitate număr de monitorizare
Utilizați acest punct final pentru a obține starea unei activități asincrone (una sau mai multe solicitări consecutive plasate în coadă) sau starea tuturor activităților trimise.
Informațiile de intrare necesare pentru această solicitare sunt:
- ID activitate – Specificați ID-ul activității pentru care intenționați să preluați starea.
Notă: ID activitate este o intrare opțională pentru acest punct final. Dacă nu specificați ID-ul activității, atunci veți obține starea tuturor activităților trimise.
Răspunsul cu succes la această solicitare va returna ID-ul activității, starea curentă a activității și datele de creare și de finalizare a activității. Răspunsul va arăta starea curentă a activităților. În plus, răspunsul va conține, de asemenea, mesaje de succes, erori sau avertizări pentru ca utilizatorii să le poată vizualiza și depana, după caz.
- Dacă starea activității este afișată ca fiind FINALIZATĂ, înseamnă că toate numerele de monitorizare au fost validate și procesate cu succes.
- Starea FINALIZATĂ presupune că numerele de monitorizare sunt validate și procesate cu succes. Aceasta nu înseamnă că toate numerele de monitorizare au fost adăugate cu succes la proiectul Advanced Integrated Visibility.
- Dacă încercați să asociați mai multe numere de monitorizare și numai unele dintre ele sunt asociate, iar restul nu reușesc să se asocieze, chiar și în acest caz starea activității va fi actualizată ca fiind FINALIZATĂ. Pentru a confirma starea fiecărui număr de monitorizare din solicitarea asociată, raportul de lot trebuie descărcat.
- Dacă starea activității este afișată ca fiind EȘUATĂ, acest lucru înseamnă că, din diverse motive/defecțiuni hardware, solicitarea nu a putut fi procesată, iar utilizatorul trebuie să o încerce din nou.
Notă:
În continuare sunt prezentate stările și descrierile lor respective:
| STARE ACTIVITATE | DESCRIERE |
|---|---|
TRIMISĂ |
Activitatea este transmisă sistemului după toate validările de bază; aceasta va fi procesată asincron. |
ACCEPTATĂ |
Activitatea este acceptată și va fi plasată în coadă. |
NEACCEPTATĂ |
Activitatea nu este acceptată din cauza unei erori interne sau a indisponibilității sistemului; utilizatorul trebuie să o reia. |
PLASATĂ ÎN COADĂ |
Activitatea este plasată în coadă pentru a fi procesată, iar procesarea va începe oricând. |
ÎN DESFĂȘURARE |
Activitatea a fost începută și este în curs de desfășurare. |
FINALIZATĂ |
Activitatea a fost finalizată și raportul de import sau fișierul de export este disponibil pentru a fi descărcat de utilizator. |
EȘUATĂ |
Activitatea a eșuat din diverse motive și trebuie încercată din nou de către utilizator. |
Detalii activitate număr de monitorizare
Utilizați acest punct final pentru a descărca raportul JSON pentru o activitate asincronă care se află în starea FINALIZATĂ.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- ID activitate – Specificați ID-ul activității pentru care intenționați să preluați starea.
Notă:
- ID activitate este o intrare obligatorie pentru acest punct final.
- Puteți descărca raportul unei singure activități asincrone la un moment dat.
- Dacă activitatea nu este FINALIZATĂ și încercați să descărcați raportul, se afișează un mesaj de eroare.
Răspunsul de succes pentru această solicitare vă furnizează raportul activității în format JSON.
Reguli pentru afaceri
- Un număr maxim de 1.000 de numere de monitorizare a expedierilor poate fi asociat cu un proiect Advanced Integrated Visibility în fiecare solicitare.
- Nu există nicio limită privind numărul maxim de numere de monitorizare pe care-l puteți asocia cu un anumit proiect Advanced Integrated Visibility.
- Orice număr de monitorizare asociat va fi disociat după un număr de 40 de zile de la un anumit proiect Advanced Integrated Visibility.
- Starea și detaliile oricărui ID de activitate creat nu vor fi disponibile după un număr de 90 de zile pentru un anumit proiect Advanced Integrated Visibility.
- Informațiile de monitorizare securizate, cum ar fi adresa destinatarului, semnătura destinatarului, nu vor fi disponibile prin intermediul Abonării pe baza numărului de monitorizare la Advanced Integrated Visibility.
Response