Releaseopmerkingen
Minimale API-gebruikslimiet verhoogd
We hebben de minimale API-limiet in alle edities verhoogd ter verbetering van uw API-gebruikservaring.
Zoho CRM-editie | API-verzoeken - Gebruikslimiet |
Free Edition | 1000 verzoeken/dag/bedrijf |
Standard Edition |
|
Professional Edition |
|
Enterprise Edition |
|
Voor meer informatie over deze wijziging, zie API-limieten.
Uitgegeven op: 1 november 2014
Nieuwe methode: searchRecords
We hebben de searchRecords methode geïntroduceerd om u te helpen met het zoeken van records uit modules. Raadpleeg de API-handleiding voor meer informatie over deze nieuwe methode.
Uitgegeven op: 20 oktober 2014
Nieuwe methoden: getModules en getDeletedRecordIds
We hebben de volgende methoden geïntroduceerd om voor het ophalen van de lijst met CRM-modules en ID’s van verwijderde records uit de prullenbak:
Raadpleeg onze API-handleiding voor meer informatie over deze nieuwe methoden.
Uitgegeven op: 7 augustus 2014
Aantal API-verzoeken
De Zoho CRM API is beschikbaar in alle edities van Zoho CRM. Om de API te gebruiken, hebt u het Zoho CRM-verificatietoken uit uw CRM-account nodig. Zorg ervoor dat u gemachtigd bent om de API-service te gebruiken. Als u niet gemachtigd bent, neem dan contact op met uw CRM-beheerder.
API-limiet
Zoho CRM-editie | API-verzoeken - Gebruikslimiet |
Free Edition | 250 verzoeken/dag/bedrijf |
Standard Edition | Minimum - 1000 verzoeken/dag maximum - 5000 verzoeken/dag/bedrijf of 250 verzoeken/gebruikerslicentie, afhankelijk van de laagste waarde |
Professional Edition | Minimum - 2000 verzoeken/dag maximum - 10.000 verzoeken/dag/bedrijf of 250 verzoeken/gebruikerslicentie, afhankelijk van de laagste waarde |
Enterprise Edition | Minimum - 3000 verzoeken/dag maximum 25.000 verzoeken/dag/bedrijf of 500 verzoeken/gebruikerslicentie, afhankelijk van de laagste waarde |
Belangrijke opmerkingen:
- Ter illustratie: in de Free Edition kunt u met de getRecords methode een maximum van 200 records ophalen per verzoek. Dit komt neer op een totaal van 50.000 records per dag (250 x 200 = 50.000 records).
- Als u de getSearchRecords of getCVRecords methode gebruikt, kunt u maximaal 250 aanroepen per dag doen, ongeacht uw Zoho CRM-editie.
Uitgegeven op: 15 juni 2013
Nieuwe methoden: Bestanden of foto's toevoegen aan records met ontwikkelaars-API
We hebben de volgende methoden geïntroduceerd waarmee u bestanden of foto's aan records kunt toevoegen:
- uploadFile
- downloadFile
- deleteFile
- uploadPhoto
- downloadPhoto
- deletePhoto
U kunt de volledige aankondiging op ons Developer API Forum lezen.
Raadpleeg onze API-handleiding voor meer informatie over deze nieuwe methoden.
Uitgegeven op: 11 juli 2012
Verificatietoken geïntroduceerd
We ondersteunen nu het verificatietoken in onze ontwikkelaars-API-implementatie.
Dit token is een permanent token en zal enkel ongeldig worden wanneer u ervoor kiest om deze te verwijderen.
Vind meer informatie over het verificatietoken in onze API-handleiding.
Uitgegeven op: 5 maart 2012
Nieuwe methoden geïntroduceerd
We hebben de volgende methoden geïntroduceerd in onze ontwikkelaars-API:
- getFields
- getRelatedRecords
- updateRelatedRecords
API-methode | Doel |
getFields | Het ophalen van alle informatie van beschikbare velden in een bepaalde module. |
getRelatedRecords | Het ophalen van records die gerelateerd zijn aan een andere record (primaire record). . |
updateRelatedRecords | Het bijwerken van records gerelateerd aan een andere record. |
U kunt de volledige aankondiging op ons Developer API Forum lezen. Raadpleeg onze API-handleiding voor meer informatie over deze nieuwe methoden.
Uitgegeven op: 27 januari 2012
Enkel HTTPS-ondersteuning vanaf 28 april 2011:
Op dit moment ondersteunen we zowel HTTP als HTTPS tijdens het implementeren van onze ontwikkelaars-API. Over 4 weken zijn we van plan om alle API-transacties alleen nog via HTTPS te laten verlopen en wordt de ondersteuning van het HTTP-protocol permanent beëindigd. Dit aanvullende SSL, 256-bits beveiligingssysteem beschermt integratie met apps van derden tegen beveiligingsproblemen tijdens gegevensoverdracht.
Als u na 28 april 2011 nog steeds gebruik wilt blijven maken van de HTTP in uw programma, dan zullen API-verzoeken niet worden uitgevoerd. Daarom zou ik alle ontwikkelaars graag willen adviseren om zo snel mogelijk Zoho CRM API enkel aan te roepen met HTTPS-verzoeken.
Nieuwe 'version' parameter geïntroduceerd
We hebben een nieuwe parameter geïntroduceerd, de zogenoemde version voor ontwikkelaars-API-methoden. Met deze parameter kunt u waarden uit het veld ‘Campaign Source’ halen.
In een recente verbetering van de Campaigns module was het veld Campaign Source verwijderd om de campagneleden functionaliteit te ondersteunen. Na deze verbetering:
- Kunt u nu meerdere leads en contactpersonen aan een campagne koppelen.
- Kunt u tijd besparen door meerdere leads/contactpersonen te importeren in plaats van ze één voor één te koppelen.
- Het veld Campaign Source zal niet beschikbaar zijn in de Leads en Contacts module.
Meer informatie over deze verbetering vindt u in onze Overgangsgids.
Hoe gebruikt u de version-parameter in API-verzoeken?
U kunt de version-parameter gebruiken in methoden voor het ophalen van waarden uit het veld Campaign Source in uw API-implementatie.
De ‘version’-parameter met de waarde '1' zal ook responses ophalen uit het veld ‘Campaign Source’.
De ‘version’-parameter met de waarde '2' zal responses ophalen op basis van de huidige API-implementatie. De waarden uit het veld ‘Campaign Source’ zullen in dit geval niet worden opgehaald.
Dit is geen verplichte parameter. Tot 30 oktober 2011 worden alle responses opgehaald op basis van de eerdere implementatie, d.w.z. voorafgaand aan de verbetering. Als u tijdens deze periode responses wilt ophalen op basis van de nieuwe implementatie, kunt u gebruik maken van de version-parameter in uw verzoeken met als waarde '2', d.w.z. version=2.
Opmerking:
- Dit is geen verplichte parameter.
- Tot 30 oktober 2011 worden alle responses opgehaald op basis van de eerdere implementatie, d.w.z. voorafgaand aan de verbetering. Als u tijdens deze periode responses wilt ophalen op basis van de nieuwe implementatie, kunt u gebruik maken van de version-parameter in uw verzoeken met als waarde '2', d.w.z. version=2.
- Na 30 oktober 2011 zullen we stoppen met de ondersteuning voor version 1 en ondersteunen we alleen version 2.
Hier is een voorbeeld van het gebruik van de ‘version’-parameter.
We hebben ook een nieuwe API-methode genaamd getRelatedRecords geïntroduceerd. U kunt records (leads, contactpersonen, etc.) ophalen die gerelateerd zijn aan een record in een andere module.
Voorbeeld: u kunt leads of contactpersonen ophalen die gerelateerd zijn aan een bepaalde campagne.Meer informatie
Uitgegeven op: 17 april 2011
GA Release van Zoho CRM ontwikkelaars-API en overige wijzigingen
We zijn verheugd de GA release van API voor Zoho CRM service te kunnen aankondigen. Onze API is beschikbaar in XML- en JSON-indelingen, zodat de community van ontwikkelaars applicaties kunnen ontwikkelen met behulp van hun favoriete programmeertaal. De robuuste en sterk verbeterde API-methoden staan nu klaar om tegemoet te komen aan de behoeften aan realtime-implementaties. Uw waardevolle bijdrage met betrekking tot het identificeren van bugs, het bedenken van nieuwe bedrijfsscenario's en publicatievoorbeelden hebben ons erg geholpen bij het creëren van een verbeterde API voor ons CRM-systeem. In aanvulling op GA-release, zullen we ook een aantal belangrijke wijzigingen in onze bestaande API-implementatie doorvoeren waarmee we kunnen voldoen aan de toekomstige behoeften van onze community van ontwikkelaars. Sommige van deze wijzigingen omvatten: afschrijving van zoekmethoden, nieuwe response-indeling, de beperking van API-verzoeken en nieuwe API-methoden voor het implementeren van extra CRM-bedrijfslogica. Wij geloven er oprecht in dat deze wijzigingen ons zullen helpen om de community van ontwikkelaars een betere ervaring te bieden en om het Zoho CRM-ontwikkelaarplatform naar een hoger niveau te brengen.
Belangrijke wijzigingen
- Afschrijving van bestaande zoekmethoden - getAllSearchRecords en getMySearchRecords
- Implementatie van nieuwe response-indeling voor alle methoden
- Beperking van API-verzoeken op basis van de Zoho CRM-editie
- Introductie van nieuwe methoden voor Search, Lead Conversion en Delete functies
Afschrijving van API
Met het oog op de toekomstige groei van de community, betere service voor ontwikkelaars en optimalisatie van de high-performance intensieve bewerkingen, worden de volgende API-methoden geleidelijk afgebouwd:
- getAllSearchRecords
- getMySearchRecords
API-methode | Doel |
getAllSearchRecords | Gebruikt voor het ophalen van alle gegevens met betrekking tot het opgegeven zoekwoord ongeacht eigendom. |
getMySearchRecords | Gebruikt voor het ophalen van gegevens die eigendom zijn van de inlognaam met betrekking tot het in het verzoek opgegeven zoekwoord. |
getAllRecords | De naam is gewijzigd naar getRecords |
getEntityRecord | De naam is gewijzigd naar getRecordById |
De laatste tijd ondervinden we een grotere toename van het brongebruik tijdens de implementatie van de getAllSearchRecords en getMySearchRecords dan verwacht. Om deze situatie onder controle te houden, introduceren we nieuwe zoekmethoden, getSearchRecords en getSearchRecordsByPDC , die een vergelijkbare werking hebben. We hebben deze nieuwe methoden geoptimaliseerd voor betere prestaties.
End-of-Life: 21 januari 2010
Opmerking:
- Vanaf 21 januari 2010 (12:00 uur PST) zullen deze methoden niet meer functioneren en ontvangt u de volgende foutmelding in uw applicatie wanneer u deze nog steeds gebruikt:
<response> Unable to process your request. Please verify whether you have entered proper method name, parameter and parameter values
</response>
Belangrijke opmerking:
We raden u ten zeerste aan om, voorafgaand aan de End-of-Life-periode, uw applicatie bij te werken met de nieuwe zoekmethoden - getSearchRecords of getSearchRecordsByPDC . Voor ondersteuning of vragen kunt u ons een e-mail sturen: support@zohocrm.com
Voor meer informatie over de afgeschreven methoden, raadpleeg onze API-handleiding
Nieuwe response-indeling
Momenteel is de XML-indeling voor de API-response als volgt: < fieldlabel value = "LEADID" > Field Value </ fieldlabel>. Deze bevat ongeveer 26 tekens (inclusief spaties) in de openingstags en de afsluitende tags. In onze nieuwe implementatie hebben we de lengte van de tag ingekort door de XML-tags te wijzigen naar <FL val="LEADID”>Field Value</FL> - totaal 8 tekens, hetgeen ongeveer 18 bytes per veld bespaart. Dit zal een grote bijdrage leveren aan de optimale benutting van de bandbreedte.
Tot 21 januari 2010 krijgt u standaard de response in de oude indeling. Als u de response in de nieuwe indeling wilt ontvangen, moet u dit aangeven met behulp van newFormat=1 of 2 in het API-verzoek voor het ophalen van gegevens uit Zoho CRM.
Belangrijke opmerking:
Let op: u moet gebruik maken van de newFormat=1 parameter XML-gegevens om gegevens in te voegen of bij te werken.
Parameter | Doel |
newFormat=1 | Om velden met 'null'-waarden uit te sluiten wanneer u gegevens uit uw CRM-account ophaalt. |
newFormat=2 | Om velden met 'null'-waarden op te nemen wanneer u gegevens uit uw CRM-account ophaalt. |
Oude indeling:
<response uri="/crm/private/xml/Leads/getAllRecords">
<result>
<Leads>
<row no="1"> <fieldlabel value="LEADID">1111111111<fieldlabel>
<fieldlabel value="SMOWNERID">222222222</fieldlabel>
<fieldlabel value="Lead Owner">soori</fieldlabel>
<fieldlabel value="Company">NiveSoft</fieldlabel>
<fieldlabel value="First Name">Mutha</fieldlabel>
<fieldlabel value="Last Name">Raja</fieldlabel>
<fieldlabel value="Designation">null</fieldlabel>
<fieldlabel value="Email">null</fieldlabel>
<fieldlabel value="Phone">3434343</fieldlabel>
<fieldlabel value="Fax">null</fieldlabel>
<fieldlabel value="Mobile">null</fieldlabel>
<fieldlabel value="Website">null</fieldlabel>
<fieldlabel value="Lead Source">null</fieldlabel>
<fieldlabel value="Lead Status">null</fieldlabel>
<fieldlabel value="Industry">null</fieldlabel>
<fieldlabel value="No of Employees">0</fieldlabel>
<fieldlabel value="Annual Revenue">0.0</fieldlabel>
<fieldlabel value="Rating">null</fieldlabel>
<fieldlabel value="CAMPAIGNID">null</fieldlabel>
<fieldlabel value="Campaign Source">null</fieldlabel>
<fieldlabel value="SMCREATORID">22222222</fieldlabel>
<fieldlabel value="Created By">jkbmahesh</fieldlabel>
<fieldlabel value="MODIFIEDBY">22222222</fieldlabel>
<fieldlabel value="Modified By">jkbmahesh</fieldlabel>
<fieldlabel value="Created Time">2009-02-22 18:20:38</fieldlabel>
<fieldlabel value="Modified Time">2009-10-05 16:01:32</fieldlabel>
<fieldlabel value="Street">null</fieldlabel>
<fieldlabel value="City">null</fieldlabel>
<fieldlabel value="State">null</fieldlabel>
<fieldlabel value="Zip Code">null</fieldlabel>
<fieldlabel value="Country">null</fieldlabel>
<fieldlabel value="Description">null</fieldlabel>
<fieldlabel value="Skype ID">null</fieldlabel>
<fieldlabel value="Email Opt Out">false</fieldlabel>
<fieldlabel value="Salutation">null</fieldlabel>
<fieldlabel value="rrr">null</fieldlabel>
<fieldlabel value="int field">null</fieldlabel>
<fieldlabel value="Currency (Round Up)">null</fieldlabel>
<fieldlabel value="Auto Num">1</fieldlabel>
<row no="2">
...
</row>
</Leads>
</result>
</response>
In dit voorbeeld worden alle velden opgehaald, ondanks de 'null'- waarden in de record. Als u een module met 150 velden hebt, moeten we gegevens ophalen voor alle velden, wat voor onnodig gebruik van bandbreedte zorgt. Nieuwe indeling:
<response uri="/crm/private/xml/Leads/getAllRecords">
<result>
<Leads>
<row no="1">
< FL val ="LEADID">1111111111</ FL >
<FL val="SMOWNERID">1111122222</FL>
<FL val="Lead Owner">soori</FL>
<FL val="Company">NiveSoft</FL>
<FL val="First Name">Mutha</FL>
<FL val="Last Name">Raja</FL>
<FL val="Email"></FL>
<FL val="Phone">3434343</FL>
<FL val="No of Employees">0</FL>
<FL val="Annual Revenue">0.0</FL>
<FL val="SMCREATORID">22222222</FL>
<FL val="Created By">jkbmahesh</FL>
<FL val="MODIFIEDBY">22222222</FL>
<FL val="Modified By">jkbmahesh</FL>
<FL val="Created Time">2009-02-22 18:20:38</FL>
<FL val="Modified Time">2009-10-05 16:01:32</FL>
<FL val="Email Opt Out">false</FL>
<FL val="Auto Num">1</FL>
</row>
<row no="2">
....
</row>
</Leads>
</result>
</response>
In dit voorbeeld halen we de velden met 'Null ' waarden niet op door het gebruik van de newFormat=1 parameter. Belangrijkste punten:
- De XML- tag is gewijzigd van <fieldlable value=""> field value </fieldlable> naar <FL val=""> field value <FL>
- U kunt stoppen met het ophalen van records met 'null'- waarden door het gebruik van newFormat=1 in het API-verzoek. Als u gegevens wilt ophalen voor alle velden (inclusief null- waarden), gebruikt u de newFormat=2 parameter.
Nieuwe response-indeling - Beschikbaar vanaf 22 oktober 2009
EOL van oude response-indeling - 21 januari 2010
Aantal API-verzoeken
Voor betere prestaties en service voor ontwikkelaars zullen we het aantal API-verzoeken beperken zoals hieronder vermeld:
Zoho CRM-editie | API-verzoeken - Gebruikslimiet |
Free Edition - 3 gratis gebruikers | 250 aanroepen/dag/bedrijf |
Professional Edition - USD 12 per gebruiker per maand | 250 aanroepen/dag/gebruikerslicentie of |
Standard Edition - USD 20 per gebruiker per maand | 250 aanroepen/dag/gebruikerslicentie of |
Enterprise Edition - USD 35 per gebruiker per maand | 500 aanroepen/dag/gebruikerslicentie of Max: 25.000 aanroepen/dag/bedrijf, Min: 3000 aanroepen/dag/bedrijf |
Ter illustratie: in de Free Edition kunt u met de getSearchRecords methode een maximum van 200 records ophalen per verzoek. Dit komt neer op een totaal van 50.000 records per dag (250 x 200 = 50.000 records).
Opmerking:
- Als u de getSearchRecords of getCVRecords methoden gebruikt, kunt u maximaal 250 aanroepen per dag doen, ongeacht uw Zoho CRM-editie.
Belangrijke opmerking:
De bovengenoemde beperkingen zijn van toepassing op al onze bestaande en nieuwe gebruikers. In de toekomst zijn we van plan om de CRM-beheerder (hoofdbeheerder van het Zoho CRM-account) te waarschuwen wanneer uw bedrijf de hierboven vermelde limiet overschrijdt. Daarnaast verstrekken we ook API-statistieken voor een betere inschatting van uw integratie-eisen.
Implementatiedatum: 21 januari 2010
Vanaf 21 januari 2010 (12:00 uur PST) kunt u API-aanroepen doen volgens uw Zoho CRM-editie. Indien uw applicatie de vermelde limiet overschrijdt, zullen uw overige API-verzoeken niet worden verwerkt. Beoordeel uw API-vereisten ruim van tevoren om problemen met gegevensoverdracht te voorkomen. Als u hulp nodig hebt, neem dan contact op met ons supportteam via support@zohocrm.com of bel ons: +1 888 900 9646
Nieuwe API-methoden
Met groot enthousiasme introduceren we de volgende nieuwe methoden ten behoeve van de groeiende community van ontwikkelaars:
- getSearchRecords
- getSearchRecordsByPDC
- deleteRecords
- convertLead
API-methode | Doel |
getSearchRecords | Het ophalen van alle gebruikersgegevens zoals gespecificeerd in het API-verzoek. |
getSearchRecordsByPDC | Het zoeken naar waarden op basis van de standaard vooraf gedefinieerde kolommen van Zoho CRM-entiteiten. |
deleteRecords | Het verwijderen van een record via de ID. |
convertLead | Het omzetten van lead naar account, contactpersoon en potentiële klant. |
We zijn ervan overtuigd dat de bovenstaande methoden erg nuttig zullen zijn bij de implementatie van zoekfuncties en dat u hierdoor via onze API aanvullende bedrijfslogica kunt ontwikkelen. Deze methoden zullen onmiddellijk beschikbaar zijn voor alle edities.
Beschikbaar vanaf: 22 oktober 2009
Voor meer informatie over de nieuwe API-methoden, raadpleeg onze API-handleiding
Overige wijzigingen
We voeren tevens de volgende kleine wijzigingen door:
- Het ophalen van maximaal 200 records per API-verzoek
- De nieuwe response-indeling is van toepassing op alle API-methoden (bestaande en nieuwe methoden)
- Het ophalen van records met de opgegeven velden met behulp van de parameter selectColumns
- We hebben ook de API-handleiding bijgewerkt en het officiële forum voor ontwikkelaars gelanceerd