Informații generale despre căutare

Ultima versiune a documentației MiniCRM API (disponibilă în limba engleză) poate fi consultată dând click pe următorul link: MiniCRM Api English.

Răspunsurile se primesc în array-uri care conțin parametrul Count și reprezintă numărul de elemente identificate. Dedesubt, există parametrul Results și aici vei regăsi elementele în array-uri separate.

În listă sunt incluse doar datele principale. Celelalte detalii pot fi interogate prin API folosind adresa returnată în câmpul Url.

Prin API se vor afișa 100 de rezultate pe fiecare pagina iar paginile pot fi accesate folosind paramentrul Page ca de exemplu:

$ curl https://SystemId:APIKey@r3.minicrm.hu/Api/R3/Project?Query=Teszt&Page=1
Paginația în API începe de la 0 (zero) așa încât a doua pagina va putea fi accesată setând Page=1.

Pentru a căuta cardurile modifice după o anumită dată, poți folosi sintagma UpdatedSince și să specifici data de la care vrei să pornească respectiva căutare.

De exemplu:

$ curl https://SystemId:APIKey@r3.minicrm.hu/Api/R3/Project?StatusId=2500&UpdatedSince=2013-03-01+12:00:00

Căutarea de Proiecte folosind cuvinte cheie

Este necesar să te autentifici. Exemplu de interogare:

$ curl https://SystemId:APIKey@r3.minicrm.hu/Api/R3/Project?Query=Teszt

În acest caz sunt căutate proiectele relevante pentru cuvintele specificate. Este important de reținut faptul că acest tip de căutare funcționează doar într-un produs de tip Proiecte.

Exemplu de răspuns:

{
  "Count": 1,
  "Results": {
    "1234": {
      "Id": "1234",
      "Name": "Teszt projekt",
      "Url": "https://r3.minicrm.hu/Api/R3/Project/1234",
      "StatusId": "2500",
      "UserId": "3200",
      "Deleted": "0"
    }
  }
}

Căutarea de Contacte folosind cuvinte cheie

Este necesar să te autentifici. Exemplu de interogare:

$ curl https://SystemId:APIKey@r3.minicrm.hu/Api/R3/Contact?Query=Kovács

În acest caz sunt căutate contactele relevante pentru cuvintele cheie specificate. Este important de menționat faptul că doar contactele pot fi căutate în acest fel. Acest tip de căutare este recomandat pentru căutarea numerelor de telefon.

Atunci când se caută numere de telefon, sistemul va normaliza numărul introdus și va căuta informații în sistem pe baza lui. Căutarea începe de la sfârșitul numărului de telefon astfel încât este suficient să introduci ultimele cifre ale numărului pentru a obține rezultate relevante.

Este necesar să te autentifici. Exemplu de interogare:

$ curl https://SystemId:APIKey@r3.minicrm.hu/Api/R3/Contact?Query=2345678

Exemplu de răspuns:

{
  "Count": 1,
  "Results": {
    "12345": {
      "Id": "12345",
      "Name": "Kovács József",
      "Url": "https://r3.minicrm.hu/Api/R3/Contact/12345",
      "Type": "Person",
      "Email": "kjozsef@teszt.hu",
      "Phone": "0612345678"
    }
  }
}