Versie 1.0 van de Zoho CRM API's is in de End-of-Life-fase. Deze zal op 31 december 2018 worden afgeschreven. Maak kennis met de nieuwe en verbeterde API 2.0.
Verificatietoken gebruiken
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.
Verificatietoken genereren
Om een verificatietoken te genereren dient u een verificatieverzoek te sturen naar Zoho Accounts met gebruik van de onderstaande URL-indeling. Zorg ervoor dat u een bevestigd gebruiker bent, anders ontvangt u mogelijk een foutmelding tijdens het genereren van het verificatietoken - 'ACCOUNT_REGISTRATION_NIET_CONFIRMED".
URL-indeling
API-modus:
Om het verificatietoken te genereren in API-modus, doet u het volgende:
- Aanmelden bij Zoho CRM.
- Open https://accounts.zoho.com.
- Op de pagina Startpagina Zoho Accounts klik op Twee Factor Authenticatie.
- Op de pagina Twee Factor Authenticatie, klik op Applicatiespecifieke wachtwoorden beheren.
- In de pop-up Applicatiespecifieke wachtwoorden doet u het volgende:
- Voer de naam van het apparaat of app in
- Voer het huidige wachtwoord in
- Klik op Genereren. U ontvangt het nieuwe applicatiespecifieke wachtwoord met spaties.
- Verwijder de spaties in het wachtwoord en voeg toe aan de volgende API-modus URL om het verificatietoken te genereren.
https://accounts.zoho.com/apiauthtoken/nb/create?SCOPE=ZohoCRM/crmapi&EMAIL_ID=[Username/EmailID]&PASSWORD=[Password]&DISPLAY_NAME=[ApplicationName]
Opmerking:
- Gebruik de HTTP POST-methode om het verzoek in te dienen.
Parameters die via deze URL doorgegeven moeten worden zijn:
| Parameter | Beschrijving |
| EMAIL_ID | Voer uw Zoho CRM-gebruikersnaam of e-mail-ID in |
| scope | Voer als waarde ZohoCRM/crmapi in |
| PASSWORD | Voer uw Zoho CRM-wachtwoord in |
| DISPLAY_NAME | Voer de naam van de applicatie in die het doel van het gebruik van dit verificatietoken beschrijft. Bijvoorbeeld 'MailChimp' of 'Google Apps” |
Raadpleeg de pagina Two factor Authentication help voor meer informatie.
Voorbeeld response
#
#Wed Feb 29 03:07:33 PST 2012
AUTHTOKEN=bad18eba1ff45jk7858b8ae88a77fa30
RESULT=TRUE
Opmerking:
- Het verificatietoken kan worden gebruikt in al uw API-aanroepen. U kunt de URL-indeling ook hier bekijken: Configuratie > Voor ontwikkelaars >APIs.
- U moet aangemeld zijn bij uw CRM-account om de browser-modus te gebruiken.
Voorbeeld
Dit is een voorbeeld voor het ophalen van records:
https://crm.zoho.com/crm/private/xml/Leads/getRecords?authtoken=7d987658943g4j09h43dd0b167dda34b&scope=crmapi
Verificatietokens intrekken
U kunt de voor uw account gegenereerde verificatietokens verwijderen op de 'Mijn Zoho-acccount'-pagina.
- Meld u aan bij Zoho CRM
- Open [Gebruikersnaam] > Mijn account
- In uw accounts-pagina, klik op Actieve verificatietokens.
- Op de pagina Actieve verificatietokens kunt u verificatietokens verwijderen(intrekken).
Opmerking:
- Om veiligheidsredenen kunt u de bestaande verificatietokens niet bekijken. Sla het verificatietoken op zoals en zodra deze is gegenereerd.
- Het verwijderen van een verificatietoken is permanent.
- Als u een verificatietoken opnieuw genereert, update uw programma dan met het nieuwe token.
Punten om te onthouden
- Het verificatietoken is gebruikersspecifiek en is een permanente token.
- Wanneer het bestaande token verwijderd wordt, is deze verwijdering permanent. Het nieuwe token moet worden vervangen in alle API-aanroepen.
- Het verificatietoken van het account van een gebruiker wordt ongeldig als de gebruiker is gedeactiveerd.
- Wij informeren CRM-gebruikers (gebruikers die het verificatietoken hebben gegenereerd) wanneer uw bedrijf de API-limiet overschrijdt.
- Indien uw toepassing 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