Förstärk dina integrationer med den förbättrade API Designer!

Vi är glada över att tillkännage de betydande förbättringar vi har gjort av API Designer-modulen.

Dessa förbättringar ger dig möjlighet att bygga ännu mer effektiva och kraftfulla anpassade API:er. De fokuserar på att förbättra bulkoperationer, utöka utvalda API-funktioner och förbättra användningen av flera fältförhållanden.

Låt oss dyka in i detaljerna för dessa förbättringar:

Förbättring 1: Stöd för bulkdrift för UPDATE/UPSERT-poster

API Designer: Bulk Operation Support

Med den senaste uppdateringen kan du utföra massåtgärder för uppdatering eller uppgradering av poster. Denna förbättring låter dig skapa eller uppdatera flera poster i en enda begäran, vilket gör dina API-interaktioner effektiva och tidsbesparande.

Nyckelfunktioner:

  • Skapa API: Skapa flera poster i en enda begäran genom att skicka parametern bulk="true". Relaterat dokument
  • Uppdatera API: Tidigare kunde du bara uppdatera en post per begäran. Nu kan du uppdatera flera poster i en enda begäran genom att matcha Where-villkoret. Relaterat dokument

Massregistreringsgräns: 50

Exempel på användningsfall:

Kontaktmodul: Uppdatera flera poster i vilket fält som helst med en enda begäran. Du kan till exempel uppdatera flera kontaktposter genom att matcha specifika villkor eller skapa nya om de inte finns.

 

  
<?xml version="1.0"?>
   <api method="post" module="Contacts">
        <upsert bulk="true">
             <where>
                <field name="mobile" condition="eq" value="@mobile"></field>  
            </where>
            <update>
               <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </update>
            <create module="Contacts" bulk="true">
                <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </create>
            <return>
                <field name="mobile"></field>
                <field name="email"></field>
                <field name="lastname"></field>
            </return>
        </upsert>
    </api>




  
<?xml version="1.0"?>
   <api method="post" module="Contacts">
        <upsert bulk="true">
             <where>
                <field name="mobile" condition="eq" value="@mobile"></field>  
            </where>
            <update>
               <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </update>
            <create module="Contacts" bulk="true">
                <record>
                   <field name="mobile" value="@mobile"></field>
                   <field name="email" value="@email" presence="optional"></field>
                   <field name="lastname" value="@lastname" presence="optional"></field>
               </record>
            </create>
            <return>
                <field name="mobile"></field>
                <field name="email"></field>
                <field name="lastname"></field>
            </return>
        </upsert>
    </api>
 

Denna förbättring effektiviserar ditt arbetsflöde och minskar antalet API-anrop som krävs för bulkoperationer.

Förbättring 2: Välj API för att stödja returnerande överordnade modulfält

API Designer: Enhanced Select API

Vi har utökat funktionaliteten i Select API till att inkludera fält från referensfältsmoduler. Denna förbättring gör att du kan hämta omfattande data i en enda begäran.

Nyckelfunktioner:

  • Tidigare kunde Select API bara hämta fält från den aktuella modulen.
  • Nu kan du också välja fält från referensfältsmoduler.

Exempel på användningsfall – ärenden och kontaktrelationer (N:1):

  • Hämta ärendeposter tillsammans med den relaterade kontaktens telefonnummer.
  • Hämta ärendeposter tillsammans med kontaktens för- och efternamn.
  • Få ärendeposter med "Tilldelad till"-användarens mobilnummer och fullständiga namn.
 

Denna förbättring effektiviserar ditt arbetsflöde och minskar antalet API-anrop som krävs för bulkoperationer.

Förbättring 2: Välj API för att stödja returnerande överordnade modulfält

API Designer: Enhanced Select API

Vi har utökat funktionaliteten i Select API till att inkludera fält från referensfältsmoduler. Denna förbättring gör att du kan hämta omfattande data i en enda begäran.

Nyckelfunktioner:

  • Tidigare kunde Select API bara hämta fält från den aktuella modulen.
  • Nu kan du också välja fält från referensfältsmoduler.

Exempel på användningsfall – ärenden och kontaktrelationer (N:1):

  • Hämta ärendeposter tillsammans med den relaterade kontaktens telefonnummer.
  • Hämta ärendeposter tillsammans med kontaktens för- och efternamn.
  • Få ärendeposter med "Tilldelad till"-användarens mobilnummer och fullständiga namn.
 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Cases">
        <record>
            <field name="title"></field>
            <field name="casestatus"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
            <field name="case_no"></field>
            <field name="assigned_user_id" module="Users">
                <select>
                    <field name="first_name"></field>
                    <field name="last_name"></field>
                    <field name="userlabel"></field>
                </select>
            </field>
            <field name="contact_id" module="Contacts">
                <select>
                    <field name="firstname"></field>
                    <field name="lastname"></field>
                    <field name="mobile"></field>
                </select>
            </field>
            <field name="group_id" module="Groups">
                <select>
                    <field name="groupname"></field>
                </select>
            </field>
        </record>
        <where>
            <field name="contact_id" module="Contacts">
                <select>
                    <where>
                        <field name="lastname" value="@name"></field>
                    </where>
                </select>
            </field>
        </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Cases">
        <record>
            <field name="title"></field>
            <field name="casestatus"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
            <field name="case_no"></field>
            <field name="assigned_user_id" module="Users">
                <select>
                    <field name="first_name"></field>
                    <field name="last_name"></field>
                    <field name="userlabel"></field>
                </select>
            </field>
            <field name="contact_id" module="Contacts">
                <select>
                    <field name="firstname"></field>
                    <field name="lastname"></field>
                    <field name="mobile"></field>
                </select>
            </field>
            <field name="group_id" module="Groups">
                <select>
                    <field name="groupname"></field>
                </select>
            </field>
        </record>
        <where>
            <field name="contact_id" module="Contacts">
                <select>
                    <where>
                        <field name="lastname" value="@name"></field>
                    </where>
                </select>
            </field>
        </where>
    </select>
</api>
 

Denna förbättring låter dig komma åt detaljerad och sammankopplad data, vilket förenklar datahämtningsprocesserna.

Förbättring 3: Lade till stöd för flera fältvillkor i Where-klausulen

API-designer: Advanced Where-klausul

Med den här uppdateringen kan du använda flera fält i villkoret Where för dina Välj-frågor. Denna förbättring ger större flexibilitet och precision vid filtrering av dina data.

Nyckelfunktioner:

  • Flera fältvillkor: Lägg till mer än ett fält från den aktuella modulen eller referensfältsmoduler i where-villkoret.
  • Limparameter: Använd limparametern (glue="or" eller glue="and") för att kombinera flera villkor.

Exempel på användningsfall – enkel modul:

  • Lägg till villkor på 'Säljstadiet' och 'Lead Source' med glue="or".
  • Inkludera referensfält i Where-villkoret, till exempel contact_id och related_to.
 

Denna förbättring låter dig komma åt detaljerad och sammankopplad data, vilket förenklar datahämtningsprocesserna.

Förbättring 3: Lade till stöd för flera fältvillkor i Where-klausulen

API-designer: Advanced Where-klausul

Med den här uppdateringen kan du använda flera fält i villkoret Where för dina Välj-frågor. Denna förbättring ger större flexibilitet och precision vid filtrering av dina data.

Nyckelfunktioner:

  • Flera fältvillkor: Lägg till mer än ett fält från den aktuella modulen eller referensfältsmoduler i where-villkoret.
  • Limparameter: Använd limparametern (glue="or" eller glue="and") för att kombinera flera villkor.

Exempel på användningsfall – enkel modul:

  • Lägg till villkor på 'Säljstadiet' och 'Lead Source' med glue="or".
  • Inkludera referensfält i Where-villkoret, till exempel contact_id och related_to.
 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="or">
            <field name="sales_stage" value="@sales_stage" presence="optional"></field>
            <field name="leadsource" value="@leadsource" presence="optional"></field>
        </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="or">
            <field name="sales_stage" value="@sales_stage" presence="optional"></field>
            <field name="leadsource" value="@leadsource" presence="optional"></field>
        </where>
    </select>
</api>
 

Komplext exempel: Du kan också lägga till villkor som involverar referensfält från relaterade moduler. Till exempel:

  • relationer: Det finns ett samband (N:1) mellan erbjudanden och kontakter, såväl som mellan erbjudanden och konton.
  • Kombinerade villkor: Lägg till villkor på contact_id och related_to med hjälp av glue="or". Om endera eller båda parametervärdena matchar, kommer svaret att returneras.
 

Komplext exempel: Du kan också lägga till villkor som involverar referensfält från relaterade moduler. Till exempel:

  • relationer: Det finns ett samband (N:1) mellan erbjudanden och kontakter, såväl som mellan erbjudanden och konton.
  • Kombinerade villkor: Lägg till villkor på contact_id och related_to med hjälp av glue="or". Om endera eller båda parametervärdena matchar, kommer svaret att returneras.

 

  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="OR">
               <field name="contact_id" module="Contacts">
                   <select>
                       <where>
                           <field name="mobile" condition="eq" value="@mobile" presence="optional"></field>
                       </where>
                    </select>
               </field>
               <field name="related_to" module="Accounts">
                    <select>
                         <where>
                             <field name="phone" condition="eq" value="@phone" presence="optional"></field>
                         </where>
                    </select>
                </field>
            </where>
    </select>
</api>




  
<?xml version="1.0"?>
<api method="get">
    <select module="Potentials">
        <record>
            <field name="potentialname"></field>
            <field name="amount"></field>
            <field name="assigned_user_id"></field>
            <field name="createdtime"></field>
        </record>
        <where glue="OR">
               <field name="contact_id" module="Contacts">
                   <select>
                       <where>
                           <field name="mobile" condition="eq" value="@mobile" presence="optional"></field>
                       </where>
                    </select>
               </field>
               <field name="related_to" module="Accounts">
                    <select>
                         <where>
                             <field name="phone" condition="eq" value="@phone" presence="optional"></field>
                         </where>
                    </select>
                </field>
            </where>
    </select>
</api>
 

Denna förbättring ger dig möjligheten att skapa mer komplexa och förfinade frågor, vilket säkerställer att du hämtar exakt den data du behöver.

Vi tror att dessa förbättringar kommer att avsevärt förbättra din upplevelse med vår API Designer-modul, vilket gör den mer mångsidig och kraftfull. Vi uppmuntrar dig att utforska dessa nya funktioner och se hur de kan gynna dina utvecklingsprojekt.

Håll dig uppdaterad för fler uppdateringar.

Lycklig kodning!
 

Denna förbättring ger dig möjligheten att skapa mer komplexa och förfinade frågor, vilket säkerställer att du hämtar exakt den data du behöver.

Vi tror att dessa förbättringar kommer att avsevärt förbättra din upplevelse med vår API Designer-modul, vilket gör den mer mångsidig och kraftfull. Vi uppmuntrar dig att utforska dessa nya funktioner och se hur de kan gynna dina utvecklingsprojekt.

Håll dig uppdaterad för fler uppdateringar.

Lycklig kodning!
 
 

Registrera dig för att få de senaste uppdateringarna!

 
 

Copyright 2026 Vtiger. Alla rättigheter förbehållna. Olika varumärken som innehas av respektive ägare.