Utilizarea unui identificator de sistem extern (ReferenceId)

API-ul MiniCRM poate folosi id-uri externe pentru proiecte.

Endpoint: https://$SystemId:$ApiKey@r3.minicrm.hu/Api/SyncFeed/$SystemId/SetReferenceId

Link-ul de mai sus trebuie autentificat folosind POST cu cheia API într-un array JSON care să conțină ProjectId ca și cheie și ReferenceId ca și valoare.

Exemplu:

$ curl https://$SystemId:$ApiKey@r3.minicrm.hu/Api/SyncFeed/$SystemId/SetReferenceId --data 'References={"12":123456788,"13":123456789}'

Comanda de mai sus setează id-uri externe pentru proiectele cu id-urile 12 și 13 din MiniCRM.

Într-un array JSON, cheia ar trebui să fie un șir de caractere (string) în timp ce valoarea poate fi de tip numeric. Funcția PHP json_encode returnează un output acceptat de către API.

Căutarea unui proiect după ReferenceId

Detaliile propiectelor pot fi preluate din sistem pe baza ProjectId (identificatorul cardului) însă este posibilă și preluarea datelor pe baza configurării unui ReferenceId – identificator extern.

Exemplu de interogare:

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

Răspunsul este reprezentat de detaliile proiectului căutat. Acesta este primit sub forma unui array care conține informațiile conținute în câmpurile proiectului.

Exemplu de răspuns:

{
  "Id": 1234,
  "CategoryId": 3,
  "ContactId": 12345,
  "StatusId": "Igényfelmérés",
  "UserId": "Keszei Csaba",
  "Name": "Kovács József első vásárlás",
  "Deleted": "0",
  "Enum1016": "Ismerős ajánlotta",
  "Set1035": "Alap tétel",
  "Text1105": "Egy szöveges mező ami ki van töltve",
  "Int1107": 12500,
  "File1103": "http://cdn.minicrm.hu/doc/2013/04-25/A/Q/AQFwQq7Os0kE5ykH_GSJfg-1"
}