updateRecords-methode - vergelijking
Doel
Specifieke of meerdere records bijwerken.
Aanvraag-URL
Versie 1.0:
https://crm.zoho.com/crm/private/xml/Leads/updateRecords?authtoken=AuthToken&scope=crmapi&id=Record ID&xmlData=XML Data
Versie 2.0:
URL: https://www.zohoapis.com/crm/v2/Leads/{record_id}
Methode: PUT
Hoofdtekst van aanvraag: de inhoud van een record in JSON-indeling.
Header: Authorization=Zoho-oauthtoken {oauth_token}
Aanvraagparameters
| Versie 1.0 | Versie 2.0 |
|---|---|
| authtoken=**** | Authorization=Zoho-oauthtoken ***** - als een Header. |
| scope=crmapi | n.v.t. |
| xmlData | N.v.t. - invoergegevens moeten in de hoofdtekst van de aanvraag worden opgegeven |
| ID | De ID moet in elk JSON-object worden opgegeven. |
| wfTrigger=true | "trigger":["workflow","approval","blueprint"] de bovenstaande sleutel moet in de hoofdtekst van de aanvraag worden opgegeven |
| newFormat | n.v.t. |
| version | n.v.t. |
Voorbeeld-API-aanvraag:
| Aanvraag in versie 1.0 | Aanvraag in versie 2.0 |
|---|---|
| https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=****&id=1386586000002577004&xmlData=<Leads><row no="1"><FL val="Last Name">test2</FL><FL val="Company">com2</FL></row></Leads> | URL - https://www.zohoapis.com/crm/v2/Leads/1386586000002577004 Body: { "data": [ { "Last_Name":"Jason", "Company":"Zylker Corp" } ], "triggger":["workflow","approval","blueprint"] } |
Voorbeeldantwoorden:
| Antwoord in versie 1.0 | Antwoord in versie 2.0 |
|---|---|
| <?xml version="1.0" encoding="UTF-8" ?> <response uri="/crm/private/xml/Leads/updateRecords"> <result> <message>Record(s) bijgewerkt</message> <recorddetail> <FL val="Id">1386586000002577004</FL> <FL val="Created Time">2018-03-2719:20:28</FL> <FL val="Modified Time">2018-03-2810:56:54</FL> <FL val="Created By"><![CDATA[Bruce Wills]]></FL> <FL val="Modified By"><![CDATA[Bruce Wills]]></FL> </recorddetail> </result> </response> | { "data": [ { "code": "SUCCESS", "details": { "Modified_Time": "2018-03-27T19:20:28+05:30", "Modified_By": { "name": "Bruce Wills", "id": "1386586000000078001" }, "Created_Time": "2018-03-27T19:20:28+05:30", "id": "1386586000002577004", "Created_By": { "name": "Bruce Wills", "id": "1386586000000078001" } }, "message": "record updated", "status": "success", } ] } |
Let op:
Het veld 'id' in v1.0-API's is gelijk aan 'id' in het eerste JSON-object van de JSON-matrix 'data'.
Meerdere records bijwerken:
URL:
https://www.zohoapis.com/crm/v2/Leads
Methode: PUT
Hoofdtekst van aanvraag: de inhoud van een record in JSON-indeling.
Header: Authorization=Zoho-oauthtoken {oauth_token}
Voorbeeldinvoer:
{
"data": [
{
"Last_Name":"test2",
"Company":"com2",
"id":"1386586000002577004"
},
{
"Last_Name":"test3",
"Company":"com3",
"id":"1386586000002577006"
},
...
]
}