QuintaDB REST -sovellusliittymä

QuintaDB REST -sovellusliittymä on suunniteltu avaamaan QuintaDB-tietokantaan tallennettujen tietojen potentiaali. Tämän sovellusliittymän avulla voit saavuttaa enemmän kuin QuintaDB-oletuskäyttöliittymä tällä hetkellä tarjoaa. Näin annamme voit tehdä tietojesi kanssa kaiken tarvitsemasi ja haluamallasi tavalla. Voit luoda omia komentosarjoja, työpöydän ja mobiilisovelluksia eri alustoille, kuten iPhone/Android ja paljon othera. Ja QuintaDB on paikka, johon tallennat, jaat ja hallitset tietojasi.

Yleistä tietoa API-kutsuista

Kaikkien puheluiden tulee sisältää REST API-avain , joka löytyy sivun oikeasta yläkulmasta valikosta "API" .
Tulos palautetaan JSON tai XML muodossa pyynnöstäsi.
Näytämme taulukon, jossa on tulos jokaisesta puhelusta. URL-osoite näytetään tällä tavalla /apps.json , se tarkoittaa, että sinun tulee soittaa sovelluksellesi osoitteeseen https://QuintaDB.com /apps.json . Huomaa, että kaikkien puhelujen tulee käyttää https ja sinun on vahvistettava palvelinten SSL-varmenne.

Tietokanta

Tällaisiin tietokannan määritteisiin pääsee REST-sovellusliittymän kautta.

onelöllinen tietokannan tunniste. Tarvitset tätä päästäksesi tähän tietokantalomakkeisiin ja tietueisiin

name

nimi

created_at

Aika, jolloin tietokanta luotiin

updated_at

Aika, jolloin tietokanta viimeksi päivitettiin (otheretut tietueet tai lomakkeet)

Hae kaikki tietokannat

Parametrit

rest_api_key

API-avain

page

Tietokannat sivutettu 20 tietueella sivua kohden. Joten jos sinulla on 100 tietokantaa, sivu voi olla 1..5.

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps.json

Pyynnön elin

{"page":1,"rest_api_key":"API_KEY"}

Vastaus: palauttaa nykyiset tietokannat.

    
{"databases":[
{"id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "Database Name 1",
 "created_at"      : "2021-08-16T05:42:40-05:00",
 "updated_at"      : "2021-08-16T05:42:40-05:00",
 "dtypes_count"    : 0,
 "entities_count"  : 1,
 "properties_count": 0
 },
{"id"              : "aOWO3eVXHdHie1WeGFE8k2"
 "name"            : "Database Name 2",
 "created_at"      : "2021-04-29T01:26:22-05:00",
 "updated_at"      : "2021-08-16T00:47:56-05:00",
 "dtypes_count"    : 768,
 "entities_count"  : 6,
 "properties_count": 240
} ]}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<page>1</page>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus: palauttaa nykyiset tietokannat.

    
<?xml version="1.0" encoding="UTF-8"?>
<databases type="array">
  <database>
    <id>aOWO_dVXHdHie1WeGFE8k2</id>
    <name>Database name 1</name>
    <created-at type="datetime">2021-08-16T05:42:40-05:00</created-at>
    <updated-at type="datetime">2021-08-16T05:42:40-05:00</updated-at>
    <dtypes-count type="integer">0</dtypes-count>
    <entities-count type="integer">1</entities-count>
    <properties-count type="integer">0</properties-count>
  </database>
  <database>
    <id>aOWO3eVXHdHie1WeGFE8k2</id>
    <name>Database Name 2</name>
    <created-at type="datetime">2021-04-29T01:26:22-05:00</created-at>
    <updated-at type="datetime">2021-08-16T00:47:56-05:00</updated-at>
    <dtypes-count type="integer">768</dtypes-count>
    <entities-count type="integer">6</entities-count>
    <properties-count type="integer">240</properties-count>
  </database>
</databases>

Hae tietokanta tunnuksen mukaan

Parametrit

rest_api_key

API-avain

APP_ID

Sinun on tiedettävä tietokannan tunniste, jotta voit hakea tietokantatietoja. Löydät tunnuksen Hae kaikki tietokannat -puhelulla. Kun tiedät sen, sinun on lisää tämä tunnus URL-osoitteeseen alla olevassa linkissä, ts. othera /apps/ID.json muotoon /apps/aOWO_dVXHdHie1WeGFE8k2.json

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus: palauttaa tietokantatiedot

    
{"database":{
 "id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "Database Name 1",
 "created_at"      : "2011-08-16T05:42:40-05:00",
 "updated_at"      : "2011-08-16T05:42:40-05:00",
 "dtypes_count"    : 0,
 "entities_count"  : 1,
 "properties_count": 0,
 "complex_app?"    : true,
 "complex_app_with_fresh_data?" : false
 }
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus: palauttaa tietokantatiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<database>
 <id>aOWO_dVXHdHie1WeGFE8k2</id>
 <name>Database name 1</name>
 <created-at type="datetime">2011-08-16T05:42:40-05:00</created-at>
 <updated-at type="datetime">2011-08-16T05:42:40-05:00</updated-at>
 <dtypes-count type="integer">0</dtypes-count>
 <entities-count type="integer">1</entities-count>
 <properties-count type="integer">0</properties-count>
</database>

Hae tietokanta nimen mukaan

Parametrit

rest_api_key

API-avain

nimi

Sinun on tiedettävä tietokannan nimi voidaksesi hakea tietokantatietoja. Löydät Nimen Hae kaikki tietokannat -puhelulla.

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/search.json

Pyynnön elin

{"rest_api_key":"API_KEY", "name":"Database Name 1"}

Vastaus: palauttaa tietokantatiedot

    
{"database":{
 "id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "Database Name 1",
 "created_at"      : "2021-08-16T05:42:40-05:00",
 "updated_at"      : "2021-08-16T05:42:40-05:00",
 "dtypes_count"    : 0,
 "entities_count"  : 1,
 "properties_count": 0,
 "complex_app?"    : true,
 "complex_app_with_fresh_data?" : false
 }
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/search.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?> <api_call_params>
<rest_api_key>API_KEY</rest_api_key> <name>Database Name 1</name> </api_call_params>

Vastaus: palauttaa tietokantatiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<database>
 <id>aOWO_dVXHdHie1WeGFE8k2</id>
 <name>Database name 1</name>
 <created-at type="datetime">2021-08-16T05:42:40-05:00</created-at>
 <updated-at type="datetime">2021-08-16T05:42:40-05:00</updated-at>
 <dtypes-count type="integer">0</dtypes-count>
 <entities-count type="integer">1</entities-count>
 <properties-count type="integer">0</properties-count>
</database>

Päivitä tietokanta

Parametrit

rest_api_key

API-avain

APP_ID

name

Uusi tietokannan nimi

Making request (JSON)

Muoto

JSON

menetelmä

PUT

URL

/apps/APP_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY",
"name":"New database name"}

Vastaus: palauttaa tietokantatiedot

    
{"database":{
 "id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "New database name",
 "created_at"      : "2021-08-16T05:42:40-05:00",
 "updated_at"      : "2021-08-16T05:42:40-05:00",
 "dtypes_count"    : 0,
 "entities_count"  : 1,
 "properties_count": 0,
 "complex_app?"    : true,
 "complex_app_with_fresh_data?" : false
 }
}

Making request (XML)

Muoto

XML

menetelmä

PUT

URL

/apps/APP_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<name>New database name</rest_api_key>
</api_call_params>

Vastaus: palauttaa tietokantatiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<database>
 <id>aOWO_dVXHdHie1WeGFE8k2</id>
 <name>New database name</name>
 <created-at type="datetime">2021-08-16T05:42:40-05:00</created-at>
 <updated-at type="datetime">2021-08-16T05:42:40-05:00</updated-at>
 <dtypes-count type="integer">0</dtypes-count>
 <entities-count type="integer">1</entities-count>
 <properties-count type="integer">0</properties-count>
</database>

Poista tietokanta

Parametrit

rest_api_key

API-avain

APP_ID

Making request (JSON)

Muoto

JSON

menetelmä

DELETE

URL

/apps/APP_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus

    
{"databases":[{
 "id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "Database Name 1",
 "created_at"      : "2011-08-16T05:42:40-05:00",
 "updated_at"      : "2011-08-16T05:42:40-05:00",
 "dtypes_count"    : 0,
 "entities_count"  : 1,
 "properties_count": 0
 },
{"id"              : "aOWO3eVXHdHie1WeGFE8k2"
 "name"            : "Database Name 2",
 "created_at"      : "2011-04-29T01:26:22-05:00",
 "updated_at"      : "2011-08-16T00:47:56-05:00",
 "dtypes_count"    : 768,
 "entities_count"  : 6,
 "properties_count": 240
} ]}

Making request (XML)

Muoto

XML

menetelmä

DELETE

URL

/apps/APP_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<databases type="array">
 <database>
   <id>aOWO_dVXHdHie1WeGFE8k2</id>
   <name>Database name 1</name>
   <created-at type="datetime">2011-08-16T05:42:40-05:00</created-at>
   <updated-at type="datetime">2011-08-16T05:42:40-05:00</updated-at>
   <dtypes-count type="integer">0</dtypes-count>
   <entities-count type="integer">1</entities-count>
   <properties-count type="integer">0</properties-count>
 </database>
 <database>
   <id>aOWO3eVXHdHie1WeGFE8k2</id>
   <name>Database Name 2</name>
   <created-at type="datetime">2011-04-29T01:26:22-05:00</created-at>
   <updated-at type="datetime">2011-08-16T00:47:56-05:00</updated-at>
   <dtypes-count type="integer">768</dtypes-count>
   <entities-count type="integer">6</entities-count>
   <properties-count type="integer">240</properties-count>
 </database>
</databases>

After removing database this call returns all databases which were left.

Luo tietokanta

Parametrit

rest_api_key

API-avain

database_name

Tietokannan nimi

form_name

Lomakkeen nimi. Et voi luoda tietokantaa ilman lomaketta. Koska ei ole järkevää pitää tietokantaa ilman lomakkeita.

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/apps.json

Pyynnön elin

{"rest_api_key":"API_KEY", database_name: "Database 1", form_name: "Form 1"}

Vastaus: palauttaa tietokantatiedot

    
{"database":
   {"id"              : "aOWO_dVXHdHie1WeGFE8k2"
    "name"            : "Database Name 1",
    "created_at"      : "2011-08-16T05:42:40-05:00",
    "updated_at"      : "2011-08-16T05:42:40-05:00",
    "dtypes_count"    : 0,
    "entities_count"  : 1,
    "properties_count": 0
    }
}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/apps.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?> <api_call_params>
<rest_api_key>API_KEY</rest_api_key> <database_name>Database 1</database_name> <form_name>Form 1</form_name> </api_call_params>

Vastaus: palauttaa tietokantatiedot

    
  <?xml version="1.0" encoding="UTF-8"?>
    <database>
      <id>aOWO_dVXHdHie1WeGFE8k2</id>
      <name>Database name 1</name>
      <created-at type="datetime">2011-08-16T05:42:40-05:00</created-at>
      <updated-at type="datetime">2011-08-16T05:42:40-05:00</updated-at>
      <dtypes-count type="integer">0</dtypes-count>
      <entities-count type="integer">1</entities-count>
      <properties-count type="integer">0</properties-count>
    </database>

Jos kyseessä on virhe. Saat virheilmoituksen, ts. 'Tällainen sovelluksen nimi on jo olemassa'.

lomake

Tällaiset lomakemääritteet ovat käytettävissä REST-sovellusliittymän kautta.

Ainutlaatuinen lomaketunniste. Tarvitset tätä käyttääksesi tätä lomaketta ja lomaketietueita

name

nimi

desc

Kuvaus

post_action

Luettelo sähköposti-ilmoitusten vastaanottajista

Hae kaikki tietokantalomakkeet

Parametrit

rest_api_key

API-avain

APP_ID

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/entities.json

Pyynnön elin

{rest_api_key":"API_KEY"}

Vastaus: hae kaikki tietokantalomakkeet

    
{"forms":[
 {
 "id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
 },
 {
 "id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
      } ]}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/entities.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus: hae kaikki tietokantalomakkeet

    
<?xml version="1.0" encoding="UTF-8"?>
<forms type="array">
<form>
<id>c7zH3cKWrnqQvbrG8Nd3C7</id>
<app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
<name>Form1</name>
<desc nil="true"></desc>
<post-action>igor.petrushenko@gmail.com</post-action>
<position type="integer">0</position>
<sort-by nil="true"></sort-by>
<asc type="boolean">false</asc>
<per-page type="integer">10</per-page>
<allow-delete type="boolean">false</allow-delete>
<new-widget nil="true"></new-widget>
<records-widget nil="true"></records-widget>
<target-page nil="true"></target-page>
<allow-database type="boolean">true</allow-database>
<send-emails type="boolean">true</send-emails>
<settings nil="true"></settings>
</form>
<form>
<id>aszH3cKWrnqQvbrG8Nd3C7</id>
<app-id>ddFSkDDdncMyoKjGnWFmoE</app-id>
<name>Form2</name>
<desc nil="true"></desc>
<post-action>igor.petrushenko@gmail.com</post-action>
<position type="integer">0</position>
<sort-by nil="true"></sort-by>
<asc type="boolean">false</asc>
<per-page type="integer">10</per-page>
<allow-delete type="boolean">false</allow-delete>
<new-widget nil="true"></new-widget>
<records-widget nil="true"></records-widget>
<target-page nil="true"></target-page>
<allow-database type="boolean">true</allow-database>
<send-emails type="boolean">true</send-emails>
<settings nil="true"></settings>
</form>
</forms>

Hae lomake henkilötodistuksen perusteella

Parametrit

rest_api_key

API-avain

APP_ID

Lomaketietojen noutamiseksi sinun on tiedettävä lomaketunnuksesi. Löydät henkilötodistuksen Hae kaikki lomakkeet -puhelulla. Kun tiedät sen, sinun on lisää tämä tunnus URL-osoitteeseen alla olevassa linkissä, ts. othera /apps/APP_ID/entities.json muotoon /apps/aOWO_dVXHdHie1WeGFE8k2/entities.jso

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/entities/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus: palauttaa lomaketiedot

    
{"form":   
{"id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
      }
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/entities/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<form>
 <id>c7zH3cKWrnqQvbrG8Nd3C7</id>
 <app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
 <name>Form1</name>
 <desc nil="true"></desc>
 <post-action>igor.petrushenko@gmail.com</post-action>
 <position type="integer">0</position>
 <sort-by nil="true"></sort-by>
 <asc type="boolean">false</asc>
 <per-page type="integer">10</per-page>
 <allow-delete type="boolean">false</allow-delete>
 <new-widget nil="true"></new-widget>
 <records-widget nil="true"></records-widget>
 <target-page nil="true"></target-page>
 <allow-database type="boolean">true</allow-database>
 <send-emails type="boolean">true</send-emails>
 <settings nil="true"></settings>
</form>

Hae lomake nimen mukaan

Parametrit

rest_api_key

API-avain

database_name

Sinun on tiedettävä tietokannan nimi voidaksesi hakea tietokantatietoja. Löydät Nimen Hae kaikki tietokannat -puhelulla.

form_name

Lomaketietojen noutamiseksi sinun on tiedettävä lomakkeen nimi. Löydät lomakkeen nimen Hae kaikki lomakkeet -kutsusta.

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/search/entities/search.json

Pyynnön elin

{"rest_api_key":"API_KEY", "database_name": "Database 21", "form_name": "Form Name 1"}

Vastaus: palauttaa lomaketiedot

    
{"form":   
{"id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
      }
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/search/entities/search.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<database_name>Database 21</database_name>
<form_name>Form1</form_name>
</api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<form>
 <id>c7zH3cKWrnqQvbrG8Nd3C7</id>
 <app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
 <name>Form1</name>
 <desc nil="true"></desc>
 <post-action>igor.petrushenko@gmail.com</post-action>
 <position type="integer">0</position>
 <sort-by nil="true"></sort-by>
 <asc type="boolean">false</asc>
 <per-page type="integer">10</per-page>
 <allow-delete type="boolean">false</allow-delete>
 <new-widget nil="true"></new-widget>
 <records-widget nil="true"></records-widget>
 <target-page nil="true"></target-page>
 <allow-database type="boolean">true</allow-database>
 <send-emails type="boolean">true</send-emails>
 <settings nil="true"></settings>
</form>

Päivitä lomake

Parametrit

rest_api_key

API-avain

APP_ID

name

Uusi lomakkeen nimi. Katso kaikki käytettävissä olevat määritteet täällä

Making request (JSON)

Muoto

JSON

menetelmä

PUT

URL

/apps/APP_ID/entities/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY",
"name":"New form name"}

Vastaus: palauttaa lomaketiedot

    
{"form":   
{   
"id"              : "aOWO_dVXHdHie1WeGFE8k2",
"app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
"name"            : "New form name",
"desc"            : "Form description",
"post_action"     : "email@email.com",
"position"        : 0,
"sort_by"         : null,
"asc"             : false,
"per_page"        : 10,
"allow_delete"    : false,
"new_widget"      : null,
"records_widget"  : null,
"target_page"     : null,
"allow_database"  : true,
"send_emails"     : true,
"settings"        : null
     }
}

Making request (XML)

Muoto

XML

menetelmä

PUT

URL

/apps/APP_ID/entities/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<name>New form name</name>
</api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<form>
 <id>c7zH3cKWrnqQvbrG8Nd3C7</id>
 <app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
 <name>New form name</name>
 <desc nil="true"></desc>
 <post-action>igor.petrushenko@gmail.com</post-action>
 <position type="integer">0</position>
 <sort-by nil="true"></sort-by>
 <asc type="boolean">false</asc>
 <per-page type="integer">10</per-page>
 <allow-delete type="boolean">false</allow-delete>
 <new-widget nil="true"></new-widget>
 <records-widget nil="true"></records-widget>
 <target-page nil="true"></target-page>
 <allow-database type="boolean">true</allow-database>
 <send-emails type="boolean">true</send-emails>
 <settings nil="true"></settings>
</form>

Poista lomake

Parametrit

rest_api_key

API-avain

APP_ID

Sinun on tiedettävä tietokannan tunniste. Löydät APP_ID: n Hae kaikki lomakkeet -puhelulla. Kun tiedät sen, sinun on lisättävä tämä APP_ID URL-osoitteeseen alla oleva linkki, ts. othera /apps/APP_ID/entities.json muotoon /apps/aOWO_dVXHdHie1WeGFE8k2/entities.json

Making request (JSON)

Muoto

JSON

menetelmä

DELETE

URL

/apps/APP_ID/entities/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus

    
{"forms":[{"id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
       },
      {  "id"      : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "Form Name 1",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
      } ]}

Making request (XML)

Muoto

XML

menetelmä

DELETE

URL

/apps/APP_ID/entities/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<forms type="array">
<form>
<id>c7zH3cKWrnqQvbrG8Nd3C7</id>
<app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
<name>Form1</name>
<desc nil="true"></desc>
<post-action>igor.petrushenko@gmail.com</post-action>
<position type="integer">0</position>
<sort-by nil="true"></sort-by>
<asc type="boolean">false</asc>
<per-page type="integer">10</per-page>
<allow-delete type="boolean">false</allow-delete>
<new-widget nil="true"></new-widget>
<records-widget nil="true"></records-widget>
<target-page nil="true"></target-page>
<allow-database type="boolean">true</allow-database>
<send-emails type="boolean">true</send-emails>
<settings nil="true"></settings>
</form>
<form>
<id>aszH3cKWrnqQvbrG8Nd3C7</id>
<app-id>ddFSkDDdncMyoKjGnWFmoE</app-id>
<name>Form2</name>
<desc nil="true"></desc>
<post-action>igor.petrushenko@gmail.com</post-action>
<position type="integer">0</position>
<sort-by nil="true"></sort-by>
<asc type="boolean">false</asc>
<per-page type="integer">10</per-page>
<allow-delete type="boolean">false</allow-delete>
<new-widget nil="true"></new-widget>
<records-widget nil="true"></records-widget>
<target-page nil="true"></target-page>
<allow-database type="boolean">true</allow-database>
<send-emails type="boolean">true</send-emails>
<settings nil="true"></settings>
</form>
</forms>

Luo lomake

Parametrit

rest_api_key

API-avain

APP_ID

name

Lomakkeen nimi

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/apps/APP_ID/entities.json

Pyynnön elin

{"rest_api_key":"API_KEY", name: "New form"}

Vastaus: palauttaa lomaketiedot

    
{"form":   
{   
 "id"              : "aOWO_dVXHdHie1WeGFE8k2",
 "app_id"          : "aOWO3eVXHdHie1WeGFE8k2",
 "name"            : "New form",
 "desc"            : "Form description",
 "post_action"     : "email@email.com",
 "position"        : 0,
 "sort_by"         : null,
 "asc"             : false,
 "per_page"        : 10,
 "allow_delete"    : false,
 "new_widget"      : null,
 "records_widget"  : null,
 "target_page"     : null,
 "allow_database"  : true,
 "send_emails"     : true,
 "settings"        : null
      }
}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/apps/APP_ID/entities.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<name>New form</rest_api_key>
</api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<form>
 <id>c7zH3cKWrnqQvbrG8Nd3C7</id>
 <app-id>akFSkDDdncMyoKjGnWFmoE</app-id>
 <name>New form</name>
 <desc nil="true"></desc>
 <post-action>igor.petrushenko@gmail.com</post-action>
 <position type="integer">0</position>
 <sort-by nil="true"></sort-by>
 <asc type="boolean">false</asc>
 <per-page type="integer">10</per-page>
 <allow-delete type="boolean">false</allow-delete>
 <new-widget nil="true"></new-widget>
 <records-widget nil="true"></records-widget>
 <target-page nil="true"></target-page>
 <allow-database type="boolean">true</allow-database>
 <send-emails type="boolean">true</send-emails>
 <settings nil="true"></settings>
</form>

Kenttä

Tällaiset kentän ominaisuudet voidaan hakea REST-sovellusliittymän kautta.

onelöllinen kenttätunniste. Tarvitset tätä päästäksesi tähän kenttään

entity_id

Kentän lomaketunnus.

name

nimi

type_name

Kenttätyypin nimi. one: string, text, integer, float, select, radio button, check box, date, dob, datetime, file, image, boolean, language, states, table, country, time_zone, note, divider, formula, autoincrement, login, password, signature, linked_column, rel, subform

Hae kaikki lomakekentät

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/properties.json

Pyynnön elin

{rest_api_key":"API_KEY"}

Vastaus: hae kaikki lomakekentät

    
{"fields":[
{"id"               : "aOWO_dVXHdHie1WeGFE8k2",
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 },
{"id"               : "1i2i4VXHdHie1WeGFE8k2" ,
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 }
  ]}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/properties.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus: hae kaikki lomakekentät

    
<?xml version="1.0" encoding="UTF-8"?>
<fields type="array">
<field>
  <id>clrSoltHDdQyozW5NcLrGd</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test</name>
  <desc nil="true"></desc>
  <type-name>string</type-name>
  <default></default>
  <validate-options></validate-options>
  <position type="integer">0</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>
<field>
  <id>ddUHDhCgzeW6HkW4NdG3vE</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test2</name>
  <desc nil="true"></desc>
  <type-name>select</type-name>
  <default>1slct2slct3slct4slct5</default>
  <validate-options></validate-options>
  <position type="integer">1</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>
</fields>

Hae kenttä tunnuksella

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

Sinun on tiedettävä kenttätunnuksesi kenttäasetusten päivittämiseksi. Löydät tunnuksen Hae kaikki lomakekentät -puhelulla. Kun tiedät sen, tarvitset lisätä tämä tunnus URL-osoitteeseen alla olevassa linkissä, ts. othertaa /apps/APP_ID/entities/ENTITY_ID/properties/ID.json tiedostoksi /apps/qweWO_dVXHdHie1WeGFE8k2/entities/aOWO_dVXHdHie1WeGFE8k2/properties/asdasdie

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus

    
{"field":  
{
"id"               : "aOWO_dVXHdHie1WeGFE8k2",
"entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
"name"             : "Field Name 1",
"desc"             : "Field description",
"type_name"        : "string",
"default"          : "default value",
"validate_options" : "",
"position"         : 0,
"visible"          : true,
"size": 50,
"cols": 43,
"rows": 10
}
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<field>
 <id>clrSoltHDdQyozW5NcLrGd</id>
 <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
 <name>test</name>
 <desc nil="true"></desc>
 <type-name>string</type-name>
 <default></default>
 <validate-options></validate-options>
 <position type="integer">0</position>
 <visible type="boolean">true</visible>
 <size type="integer">50</size>
 <cols type="integer">43</cols>
 <rows type="integer">10</rows>
</field>

Hae kenttä nimen mukaan

Parametrit

rest_api_key

API-avain

database_name

Sinun on tiedettävä tietokannan nimi voidaksesi hakea tietokantatietoja. Löydät Nimen Hae kaikki tietokannat -puhelulla.

form_name

Lomaketietojen noutamiseksi sinun on tiedettävä lomakkeen nimi. Löydät lomakkeen nimen Hae kaikki lomakkeet -kutsusta.

field_name

Sinun on tiedettävä kentän nimi voidaksesi päivittää kenttäasetuksia. Löydät kentän nimen Hae kaikki lomakekentät -puhelulla.

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/search/entities/search/properties/search.json

Pyynnön elin

{"rest_api_key":"API_KEY", "database_name": "Database 21", "form_name": "Form Name 1", "field_name": "Field Name 1"}

Vastaus

    
{"field":  
{"id"               : "aOWO_dVXHdHie1WeGFE8k2",
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 }
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/search/entities/search/properties/search.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<database_name>Database 21</database_name>
<form_name>Form1</form_name>
<field_name>test</field_name>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<field>
  <id>clrSoltHDdQyozW5NcLrGd</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test</name>
  <desc nil="true"></desc>
  <type-name>string</type-name>
  <default></default>
  <validate-options></validate-options>
  <position type="integer">0</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>

Suorita toiminta

Parametrit

rest_api_key

API-avain

DTYPE_ID

Sinun on tiedettävä tietueen tunniste. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

ACTION_PROPERTY_ID

Sinun on tiedettävä kentän tunniste. Löydät tunnuksen Hae kaikki lomakekentät -kutsulla.

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/actions/ACTION_PROPERTY_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "dtype_id": "DTYPE_ID"}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/actions/ACTION_PROPERTY_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<dtype_id>DTYPE_ID</dtype_id>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Suorita toiminnot

Parametrit

rest_api_key

API-avain

ACTION_PROPERTY_ID

Sinun on tiedettävä kentän tunniste. Löydät tunnuksen Hae kaikki lomakekentät -kutsulla.

dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

json_dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

run_by_all_table_or_report

Seuraava parametri on käytettävissä kaikkien taulukon tai raportin toimintojen suorittamiseen: run_by_all_table_or_report=true.

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/actions/ACTION_PROPERTY_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "dtype_ids": ["ID1","ID2"...]}

{"rest_api_key":"API_KEY", "json_dtype_ids": "[\"ID1\",\"ID2\"...]"}

{"rest_api_key":"API_KEY", "run_by_all_table_or_report": true}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/actions/ACTION_PROPERTY_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<dtype_ids>"ID1","ID2"...</dtype_ids>
</api_call_params>

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<json_dtype_ids>"[\"ID1\",\"ID2\"...]"</json_dtype_ids>
</api_call_params>

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<run_by_all_table_or_report>true</run_by_all_table_or_report>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Päivitä kenttä

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

name

Uusi kentän nimi. Katso kaikki käytettävissä olevat määritteet täällä

Making request (JSON)

Muoto

JSON

menetelmä

PUT

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY",
"name":"New field name"}

Vastaus

    
{"field":  
{"id"              : "aOWO_dVXHdHie1WeGFE8k2",
"entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
"name"             : "Field Name 1",
"desc"             : "Field description",
"type_name"        : "string",
"default"          : "default value",
"validate_options" : "",
"position"         : 0,
"visible"          : true,
"size": 50,
"cols": 43,
"rows": 10
}
}

Making request (XML)

Muoto

XML

menetelmä

PUT

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<name>New field name</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<field>
  <id>clrSoltHDdQyozW5NcLrGd</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test</name>
  <desc nil="true"></desc>
  <type-name>string</type-name>
  <default></default>
  <validate-options></validate-options>
  <position type="integer">0</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>

Poista kenttä

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

Making request (JSON)

Muoto

JSON

menetelmä

DELETE

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus

    
{"fields":[
{"id"               : "aOWO_dVXHdHie1WeGFE8k2",
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 },
{"id"               : "1i2i4VXHdHie1WeGFE8k2" ,
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 }
  ]}

Making request (XML)

Muoto

XML

menetelmä

DELETE

URL

/apps/APP_ID/entities/ENTITY_ID/properties/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<fields type="array">
<field>
  <id>clrSoltHDdQyozW5NcLrGd</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test</name>
  <desc nil="true"></desc>
  <type-name>string</type-name>
  <default></default>
  <validate-options></validate-options>
  <position type="integer">0</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>
<field>
  <id>ddUHDhCgzeW6HkW4NdG3vE</id>
  <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
  <name>test2</name>
  <desc nil="true"></desc>
  <type-name>select</type-name>
  <default>1slct2slct3slct4slct5</default>
  <validate-options></validate-options>
  <position type="integer">1</position>
  <visible type="boolean">true</visible>
  <size type="integer">50</size>
  <cols type="integer">43</cols>
  <rows type="integer">10</rows>
</field>
</fields>

Luo kenttä

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

name

Uuden lomakekentän nimi

type_name

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/apps/APP_ID/entities/ENTITY_ID/properties.json

Pyynnön elin

{"rest_api_key":"API_KEY", name: "Field name 1", type_name: "string"}

Vastaus: palauttaa lomaketiedot

    
{"field": 
{"id"               : "aOWO_dVXHdHie1WeGFE8k2",
 "entity_id"        : "aOWO3eVXHdHie1WeGFE8k2",
 "name"             : "Field Name 1",
 "desc"             : "Field description",
 "type_name"        : "string",
 "default"          : "default value",
 "validate_options" : "",
 "position"         : 0,
 "visible"          : true,
 "size": 50,
 "cols": 43,
 "rows": 10
 }
}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/apps/APP_ID/entities/ENTITY_ID/properties.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<name>Form field 1</name>
<type-name>string</type-name>
</api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
  <field>
    <id>clrSoltHDdQyozW5NcLrGd</id>
    <entity-id>dcOSk2W6bdJOoPsCo8jmoE</entity-id>
    <name>test</name>
    <desc nil="true"></desc>
    <type-name>string</type-name>
    <default></default>
    <validate-options></validate-options>
    <position type="integer">0</position>
    <visible type="boolean">true</visible>
    <size type="integer">50</size>
    <cols type="integer">43</cols>
    <rows type="integer">10</rows>
  </field>
</field>

Hae summa sarakkeittain

Parametrit

rest_api_key

API-avain

ENTITY_ID

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/search/sum/ENTITY_ID/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY",
view: "ImWO3eVXHdHie1WeGFE8k2"}

Vastaus

    
{total: 3}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/search/sum/ENTITY_ID/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<view>ImWO3eVXHdHie1WeGFE8k2</view>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<total>
 3
</total>

Tallenna

Tällaisiin tietueominaisuuksiin pääsee REST-sovellusliittymän kautta.

Ainutlaatuinen tietueen tunniste. Tarvitset tätä päästäksesi tähän tietueeseen.

app_id

Sovelluksen tunnus

entity_id

Tietueen lomaketunniste.

values

Tallenna arvojen tiiviste. Missä avain on kentän tunnus ja arvo on tämän kentän arvo.

json_values

Tallenna arvot hash. Jossa avain on field id ja arvo on tämä kentän arvo. Analogi values_hash, mutta JSON-muodossa

rel_values

Tallenna suhteiden arvojen tiiviste. Missä avain on kentän tunnus ja arvo on linkitetyn tietueen tunnus.

Hae kaikki tietueet

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

page

Tallentaa sivunumeron. 1 - taulukon tietueet laskevat/ sivua kohden .

name_value

Käytä parametria saadaksesi tietoja tyypistä: "field name": "value", "field id": "field name"

fetch_all

Maksullisten tilien omistajille on saatavilla seuraava parametri: fetch_all=true.
Saat tietyn määrän viestejä käyttämällä per_page-parametria.
Rajoitukset eri suunnitelmien enimmäismäärälle per_page:
FREE - 200
STANDARD - 500
PROFESSIONAL - 1000
ENTERPRISE - 2000
STANDARD EXPRESS - 4000
PROFESSIONAL EXPRESS - 8000
ENTERPRISE EXPRESS - 15000

Pyynnön runko
{"rest_api_key":"API_KEY", "page": 1, "name_value": 1, "view": 'EaWQZdIXfahOqWvcvwrGTP', "fetch_all": true, "per_page": 2000}

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/dtypes/entity/ENTITY_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "page": 1, "name_value": 1, "view": 'EaWQZdIXfahOqWvcvwrGTP'}

Vastaus

    
{"records":[
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"value name 1":"2",
"aNW4nkW5bdUjldO8oKuSku":"value name 1",
"value name 2":"aaa",
"aMW4HKWR9bnOoGWQbpWQS4":"value name 2",
"value name 3":"ddd",
"cMW6pcTSjbWOFdTCkBtmkN":"value name 3"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
},
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"value name 1":"2",
"aNW4nkW5bdUjldO8oKuSku":"value name 1",
"value name 2":"aaa",
"aMW4HKWR9bnOoGWQbpWQS4":"value name 2",
"value name 3":"ddd",
"cMW6pcTSjbWOFdTCkBtmkN":"value name 3"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
]
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/dtypes/entity/ENTITY_ID.json

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
<view>EaWQZdIXfahOqWvcvwrGTP</view>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<records type="array">
<record>
<id>bYWQnuBajdBOkAW4BdMmki</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<values>
  <aNW4nkW5bdUjldO8oKuSku>2</aNW4nkW5bdUjldO8oKuSku>
  <aMW4HKWR9bnOoGWQbpWQS4>aaa</aMW4HKWR9bnOoGWQbpWQS4>
  <cMW6pcTSjbWOFdTCkBtmkN>ddd</cMW6pcTSjbWOFdTCkBtmkN>
</values>
<approved type="boolean">false</approved>
<created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
<updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>
<record>
<id>dcQSkdWO1odA5HAmkYWOix</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<values>
  <aNW4nkW5bdUjldO8oKuSku>1</aNW4nkW5bdUjldO8oKuSku>
  <aMW4HKWR9bnOoGWQbpWQS4>test</aMW4HKWR9bnOoGWQbpWQS4>
  <cMW6pcTSjbWOFdTCkBtmkN>test2</cMW6pcTSjbWOFdTCkBtmkN>
</values>
<approved type="boolean">false</approved>
<created-at type="datetime">2011-09-17T04:28:10-05:00</created-at>
<updated-at type="datetime">2011-09-17T04:28:10-05:00</updated-at>
</record>
</records>

Hanki ennätys

Parametrit

rest_api_key

API-avain

APP_ID

Sinun on tiedettävä tietueesi tunniste. Löydät tunnuksen Hae kaikki tietueet -puhelulla. Kun tiedät sen, sinun on lisättävä tämä tunnus URL-osoitteeseen alla oleva linkki, ts. othera /apps/APP_ID/dtypes/ID.json muotoon /apps/aOWO_dVXHdHie1WeGFE8k2/dtypes/asd987asdasd97asd.json

name_value

Käytä parametria saadaksesi tietoja tyypistä: "field name": "value", "field id": "field name"

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/dtypes/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "name_value": 1}

Vastaus

    
{"record":
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"value name 1":"2",
"aNW4nkW5bdUjldO8oKuSku":"value name 1",
"value name 2":"aaa",
"aMW4HKWR9bnOoGWQbpWQS4":"value name 2",
"value name 3":"ddd",
"cMW6pcTSjbWOFdTCkBtmkN":"value name 3"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/dtypes/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<record>
<id>bYWQnuBajdBOkAW4BdMmki</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<values>
  <aNW4nkW5bdUjldO8oKuSku>2</aNW4nkW5bdUjldO8oKuSku>
  <aMW4HKWR9bnOoGWQbpWQS4>aaa</aMW4HKWR9bnOoGWQbpWQS4>
  <cMW6pcTSjbWOFdTCkBtmkN>ddd</cMW6pcTSjbWOFdTCkBtmkN>
</values>
<approved type="boolean">false</approved>
<created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
<updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>

Päivitä tietue

Parametrit

rest_api_key

API-avain

APP_ID

values

Tallenna arvojen tiiviste, jossa avain on lomakekentän tunnus.

json_values

Jos käytät jQueryä, Rubyä tai othera ohjelmointikieliä, lähetä koodausparametrit parametrilla 'values'. Jos kehyksesi ei salli tätä, voit lähettää tietueiden arvoja JSON-merkkijonona, mutta tässä tapauksessa määritä parametrisi nimeksi 'json_values'. Ja JSON-arvojonosi näyttää tältä: "{" aNW4nkW5bdUjldO8oKuSku ": " 2 ", "aMW4HKWR9bnOoGWQbpWQS4 ": "aaa "} "

subforms_values / subforms_json_values

Voit luoda tai päivittää alilomakkeita samalla tavalla käyttämällä 'subforms_values' tai 'json_subforms_values'.
Alla olevassa muodossa:
"{property1_id: {entity_id: subform1_id, subform1_record1_id: {subform1_field1_id: "2 ", subform1_field2_id: "aaa "}, subform1_record2_id: {subform1_field1_id: "3 ", subform1_field2_id: "bb "}}, ominaisuus2_id: {yhteisö_tunnus: alamuoto2_id, alamuoto2_rekisteri1_id: {alamuoto2_kenttä1_id: "4 ", subform2_field2_id: "bb "}, subform2_record2_id: {subform2_field1_id: "5 ", subform2_field2_id: "dd "}}} ".

Jossa property1_id ja property2_id - tämä on kenttätunnus, jonka päätaulukossa on Subform-tyyppi.
subform1_id, subform2_id - Lomaketunnukset, jotka asetettiin property1_id ja property2_id -asetuksissa.
subform1_record1_id и subform1_record2_id - tämä on uusi tai olemassa oleva alilomaketietueiden tunnus.
subform1_field1_id, subform1_field2_id - kenttien tunnukset muodossa lomake1_id.
subform2_field1_id, subform2_field2_id - kenttien tunnukset muodossa subform2_id.

Kaikki tunnukset - se on 22 merkkiä sisältävä URL-tallennus base64-koodi, voit hankkia ne muista API-kutsuista tai luoda uusia alilomaketietueita varten.

Making request (JSON)

Muoto

JSON

menetelmä

PUT

URL

/apps/APP_ID/dtypes/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "values": {"aNW4nkW5bdUjldO8oKuSku" : 3, "aMW4HKWR9bnOoGWQbpWQS4" : "b", "cMW6pcTSjbWOFdTCkBtmkN" : "c"}}

Vastaus

    
{"record":
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"aNW4nkW5bdUjldO8oKuSku":"3",
"aMW4HKWR9bnOoGWQbpWQS4":"b",
"cMW6pcTSjbWOFdTCkBtmkN":"c"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
}

Making request (XML)

Muoto

XML

menetelmä

PUT

URL

/apps/APP_ID/dtypes/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?> <api_call_params>
<values>{"aNW4nkW5bdUjldO8oKuSku"=>3, "aMW4HKWR9bnOoGWQbpWQS4"=>"b", "cMW6pcTSjbWOFdTCkBtmkN"=>"c"}</values> <rest_api_key>API_KEY</rest_api_key> </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<record>
<id>bYWQnuBajdBOkAW4BdMmki</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<values>
  <aNW4nkW5bdUjldO8oKuSku>3</aNW4nkW5bdUjldO8oKuSku>
  <aMW4HKWR9bnOoGWQbpWQS4>b</aMW4HKWR9bnOoGWQbpWQS4>
  <cMW6pcTSjbWOFdTCkBtmkN>c</cMW6pcTSjbWOFdTCkBtmkN>
</values>
<approved type="boolean">false</approved>
<created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
<updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>

Päivitä useita tietueita

Parametrit

rest_api_key

API-avain

confirm_action

Seuraava parametri vaaditaan päivityksen suorittamiseksi taulukossa tai raportissa: confirm_action: update.

ENTITY_ID

Sinun on tiedettävä kenttäsi lomaketunniste, jotta voit päivittää kenttäasetuksia. Löydät ENTITY_ID:n käyttämällä Hae kaikki lomakkeet -kutsua.

APP_ID

Sinun on tiedettävä tietokantasi tunniste, jotta voit noutaa tietokantatietoja. Löydät tunnuksen Hae kaikki tietokannat -kutsulla.

dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

json_dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

update_id

Sinun on tiedettävä kentän tunniste. Löydät tunnuksen Hae kaikki lomakekentät -kutsulla.

update_term

Uusi arvo tietueille

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.json

Pyynnön elin

{rest_api_key: "YOUR_KEY",
confirm_action: "update",
entity_id: "ENTITY_ID",
app_id: "APP_ID",
json_dtype_ids: "[\"ID1\",\"ID2\"...]",
update_id: "UPDATE_ID",
update_term: "UPDATE_TERM"}

{rest_api_key: "YOUR_KEY",
confirm_action: "update",
entity_id: "ENTITY_ID",
app_id: "APP_ID",
dtype_ids: ["ID1","ID2"...],
update_id: "UPDATE_ID",
update_term: "UPDATE_TERM"}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.xml

Pyynnön elin


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <confirm_action>update</confirm_action>
    <entity_id>ENTITY_ID</entity_id>
    <app_id>APP_ID</app_id>
    <dtype_ids>"ID1","ID2"...</dtype_ids>
    <update_id>UPDATE_ID</update_id>
    <update_term>UPDATE_TERM</update_term>
  </api_call_params>


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <confirm_action>update</confirm_action>
    <entity_id>ENTITY_ID</entity_id>
    <app_id>APP_ID</app_id>
    <json_dtype_ids>"[\"ID1\",\"ID2\"...]"</json_dtype_ids>
    <update_id>UPDATE_ID</update_id>
    <update_term>UPDATE_TERM</update_term>
  </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Päivitä kaikki tietueet

Parametrit

rest_api_key

API-avain

confirm_action

Seuraava parametri tarvitaan kaikkien taulukon tai raportin tietueiden päivittämiseen: confirm_action: update_all.

ENTITY_ID

Sinun on tiedettävä kenttäsi lomaketunniste, jotta voit päivittää kenttäasetuksia. Löydät ENTITY_ID:n käyttämällä Hae kaikki lomakkeet -kutsua.

APP_ID

Sinun on tiedettävä tietokantasi tunniste, jotta voit noutaa tietokantatietoja. Löydät tunnuksen Hae kaikki tietokannat -kutsulla.

update_id

Sinun on tiedettävä kentän tunniste. Löydät tunnuksen Hae kaikki lomakekentät -kutsulla.

update_term

Uusi arvo tietueille

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.json

Pyynnön elin

{rest_api_key: "YOUR_KEY",
confirm_action: "update_all",
entity_id: "ENTITY_ID",
app_id: "APP_ID",
update_id: "UPDATE_ID",
update_term: "UPDATE_TERM"}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.xml

Pyynnön elin


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <confirm_action>update_all</confirm_action>
    <entity_id>ENTITY_ID</entity_id>
    <app_id>APP_ID</app_id>
    <update_id>UPDATE_ID</update_id>
    <update_term>UPDATE_TERM</update_term>
  </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Päivitä tietosolu

Parametrit

rest_api_key

API-avain

PROPERTY_ID

DTYPE_ID

val

Uusi solun arvo

Making request (JSON)

Muoto

JSON

menetelmä

PATCH/PUT/POST

URL

/cell_values/DTYPE_ID/update_cell_value/PROPERTY_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "property_id": "aNW4nkW5bdUjldO8oKuSku", "dtype_id": "cMW6pcTSjbWOFdTCkBtmkN", "val": "John Smith"}

Vastaus

    
{"new_value": "John Smith"}

Making request (XML)

Muoto

XML

menetelmä

PATCH/PUT/POST

URL

/cell_values/DTYPE_ID/update_cell_value/PROPERTY_ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?> <api_call_params>
<val>John Smith</val> <rest_api_key>API_KEY</rest_api_key> <dtype-id>cMW6pcTSjbWOFdTCkBtmkN</dtype-id> <property-id>aNW4nkW5bdUjldO8oKuSku</property-id> </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<new_value>
John Smith
</new_value>

Poista tietue

Parametrit

rest_api_key

API-avain

APP_ID

Making request (JSON)

Muoto

JSON

menetelmä

DELETE

URL

/apps/APP_ID/dtypes/ID.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus

    
{"record":
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"aNW4nkW5bdUjldO8oKuSku":"3",
"aMW4HKWR9bnOoGWQbpWQS4":"b",
"cMW6pcTSjbWOFdTCkBtmkN":"c"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
}

Making request (XML)

Muoto

XML

menetelmä

DELETE

URL

/apps/APP_ID/dtypes/ID.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<record>
  <id>bYWQnuBajdBOkAW4BdMmki</id>
  <app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
  <entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
  <values>
    <aNW4nkW5bdUjldO8oKuSku>3</aNW4nkW5bdUjldO8oKuSku>
    <aMW4HKWR9bnOoGWQbpWQS4>b</aMW4HKWR9bnOoGWQbpWQS4>
    <cMW6pcTSjbWOFdTCkBtmkN>c</cMW6pcTSjbWOFdTCkBtmkN>
  </values>
  <approved type="boolean">false</approved>
  <created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
  <updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>

Poista useita

Parametrit

rest_api_key

API-avain

ENTITY_ID

Sinun on tiedettävä kenttäsi lomaketunniste, jotta voit päivittää kenttäasetuksia. Löydät ENTITY_ID:n käyttämällä Hae kaikki lomakkeet -kutsua.

APP_ID

Sinun on tiedettävä tietokantasi tunniste, jotta voit noutaa tietokantatietoja. Löydät tunnuksen Hae kaikki tietokannat -kutsulla.

dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla.

json_dtype_ids

Sinun on tiedettävä tietueiden tunnisteet. Löydät tunnuksen Hae kaikki tietueet -kutsulla. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/apps/APP_ID/dtypes/delete_multiple.json

Pyynnön elin

{rest_api_key: "YOUR_KEY",
entity_id: "ENTITY_ID",
app_id: "APP_ID",
json_dtype_ids: "[\"ID1\",\"ID2\"...]"}

{rest_api_key: "YOUR_KEY",
entity_id: "ENTITY_ID",
app_id: "APP_ID",
dtype_ids: ["ID1","ID2"...]}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/apps/APP_ID/dtypes/delete_multiple.xml

Pyynnön elin


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <entity_id>ENTITY_ID</entity_id>
    <app_id>APP_ID</app_id>
    <json_dtype_ids>"[\"ID1\",\"ID2\"...]"</json_dtype_ids>
  </api_call_params>


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <entity_id>ENTITY_ID</entity_id>
    <app_id>APP_ID</app_id>
    <dtype_ids>"ID1","ID2"...</dtype_ids>
  </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Poista kaikki

Parametrit

rest_api_key

API-avain

APP_ID

Sinun on tiedettävä tietokantasi tunniste, jotta voit noutaa tietokantatietoja. Löydät tunnuksen Hae kaikki tietokannat -kutsulla.

ENTITY_ID

Sinun on tiedettävä kenttäsi lomaketunniste, jotta voit päivittää kenttäasetuksia. Löydät ENTITY_ID:n käyttämällä Hae kaikki lomakkeet -kutsua.

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

Making request (JSON)

Muoto

JSON

menetelmä

DELETE

URL

/dtypes/APP_ID/delete_all/ENTITY_ID.json

Pyynnön elin

{rest_api_key: "YOUR_KEY", entity_id: "ENTITY_ID"}

Vastaus

    
{\"success\":\"Done\"}

Making request (XML)

Muoto

XML

menetelmä

DELETE

URL

/dtypes/APP_ID/delete_all/ENTITY_ID.xml

Pyynnön elin


  <?xml version="1.0" encoding="UTF-8"?>
  <api_call_params>
    <rest_api_key>API_KEY</rest_api_key>
    <entity_id>ENTITY_ID</entity_id>
  </api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
  <success>Done</success>

Luo tietue

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

Jos sinun on käytettävä henkilökohtaista henkilötodistustasi, voit luoda UUID (onelöllinen tunniste) 22 merkkiä pitkä URL-suojattu pohja64 Esimerkiksi Rubiinissa . Seuraavaksi sinun on siirrettävä se arvojen hashille, esimerkiksi: values => {'id' => ID}, othera kohteeseen: arvot => {'id' => '22adadVXHdHie1WeGFE8k2'}, otheren järjestelmä luo sinulle onelöllisen tunnisteen.

values / json_values

subforms_values / subforms_json_values

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/apps/APP_ID/dtypes.json

Pyynnön elin

{"rest_api_key":"API_KEY", "values": {"entity_id" : ENTITY_ID, "id" : ID, "aNW4nkW5bdUjldO8oKuSku":"3", "aMW4HKWR9bnOoGWQbpWQS4":"b","cMW6pcTSjbWOFdTCkBtmkN":"c"}}

Vastaus: palauttaa lomaketiedot

    
{"record":
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"aNW4nkW5bdUjldO8oKuSku":"3",
"aMW4HKWR9bnOoGWQbpWQS4":"b",
"cMW6pcTSjbWOFdTCkBtmkN":"c"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
}

Making request (XML)

Muoto

XML

menetelmä

POST

URL

/apps/APP_ID/dtypes.xml

Pyynnön elin

<?xml version="1.0" encoding="UTF-8"?> <api_call_params>
<values>{"aNW4nkW5bdUjldO8oKuSku"=>3,"entity_id"=>ENTITY_ID, "id"=>ID,"aMW4HKWR9bnOoGWQbpWQS4"=>"b", "cMW6pcTSjbWOFdTCkBtmkN"=>"c"}</values>< <rest_api_key>API_KEY</rest_api_key> </api_call_params>

Vastaus: palauttaa lomaketiedot

    
<?xml version="1.0" encoding="UTF-8"?>
<record>
  <id>bYWQnuBajdBOkAW4BdMmki</id>
  <app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
  <entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
  <values>
    <aNW4nkW5bdUjldO8oKuSku>3</aNW4nkW5bdUjldO8oKuSku>
    <aMW4HKWR9bnOoGWQbpWQS4>b</aMW4HKWR9bnOoGWQbpWQS4>
    <cMW6pcTSjbWOFdTCkBtmkN>c</cMW6pcTSjbWOFdTCkBtmkN>
  </values>
  <approved type="boolean">false</approved>
  <created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
  <updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>

Haku

Parametrit

rest_api_key

API-avain

APP_ID

ENTITY_ID

view

Sinun on tiedettävä raporttitunnuksesi tietueiden noutamiseksi. (valinnainen)

search

Haluatko pyyhkäisyn pöydälle? "SEARCH_TERM", "o" => "SEARCH_CRITERIA"}]].
OMAISUUS_ID - kenttätunniste, jota etsimme ( -ALL - - etsimään kaikkia sarakkeita),
SEARCH_TERM - etsimämme arvo,
SEARCH_CRITERIA - kriteeri viestille, ehkä yksi niistä:
is, is_not, is_empty, is_not_empty, alkaa_with, end_with, kuten, sisältää, not_contains.

Tavallisille numeroille ja päivämäärille : vähemmän kuin suurempi, suurempi kuin pienempi tai pienempi tai pienempi, suurempi kuin tavallinen tai tasa-arvoinen.

Noin tunnin ajan : ennen, jälkeen, this_day_and_before, this_day_and_after, eilen, tänään, huomenna, today_or_later, last_7_days, last_30_days,
last_60_days, last_90_days, last_120_days, next_7_days, next_30_days, next_60_days, next_90_days, next_120_days, next_n_days, last_n_days,
viimeinen viikko, tämä_viikko, seuraava_viikko, nykyinen ja viimeinen viikko, nykyinen ja seuraava_viikko, seuraava_viikko, viimeinen_viikko, viimeinen kuukausi, tämä kuukausi, seuraava kuukausi,
current_and_prev_month, current_and_next_month, next_n_months, last_n_months, last_year, this_year, last_2_years, next_2_years, current_and_prev_year,
nykyinen ja seuraava vuosi, seuraava_vuosi, viimeinen_vuosi.

Järjestelmäsarakkeet : added_by, created_at, updated_at, ip.

Jos haluat etsiä useista sarakkeista yhdistävän "JA" -ehdon avulla, nämä ehdot tulee sijoittaa yhteen taulukkoon, jos "OR", sitten erilliseksi, esimerkiksi:
[[{"a" => "OMAISUUS_ID_1", "b" => "A", "o" => "on"}, {"a" => "OMAISUUS_ID_2", "b" => "A", "o" => "on"}],
[{"a" => "OMAISUUS_ID_3", "b" => "B", "o" => "SEARCH_CRITERIA"}]]

hakukaava on: "Etsi kaikki tietueet, joissa OMAISUUS_ID_1 ja OMAISUUS_ID_2 ovat yhtä suuri kuin A TAI OMAISUUS_ID_3 on yhtä suuri kuin B"

limit

Hakutulosten tietueiden määrä on enintään 200.

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/search/APP_ID.json

Pyynnön elin

{"rest_api_key":"API_KEY", "entity_id" => "ENTITY_ID", "search": [[{"a"=>"aNW4nkW5bdUjldO8oKuSku", "b"=>"value name 1", "o"=>"is"}]]}

Vastaus

    
{"records":[
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"value name 1":"2",
"aNW4nkW5bdUjldO8oKuSku":"value name 1",
"value name 2":"aaa",
"aMW4HKWR9bnOoGWQbpWQS4":"value name 2",
"value name 3":"ddd",
"cMW6pcTSjbWOFdTCkBtmkN":"value name 3"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
},
{
"id":"bYWQnuBajdBOkAW4BdMmki",
"app_id":"ddIbpcNSncW5xcHxpdHCoW",
"entity_id":"aEWQZdIXfahOqWvcvwrGTP",
"values":{"value name 1":"2",
"aNW4nkW5bdUjldO8oKuSku":"value name 1",
"value name 2":"aaa",
"aMW4HKWR9bnOoGWQbpWQS4":"value name 2",
"value name 3":"ddd",
"cMW6pcTSjbWOFdTCkBtmkN":"value name 3"},
"approved":false,
"created_at":"2011-09-17T10:40:40-05:00",
"updated_at":"2011-09-17T10:40:40-05:00"
}
]
}

Ihmissuhteet

Kuinka linkittää tietueet:

Tietueiden välisen linkin päivittämiseksi sinun on siirrettävä erillinen tiiviste CREATE- tai UPDATE-tietuekutsuun.

curl -H 'Content-Type: application/json' -X PUT -d '{ "rel ": {REL_ID: RECORD_ID}} '"https: //quintadb.com/apps/APP_ID/dtypes/CURRENT_RECORD_ID.json? rest_api_key=API_KEY "

Tämän hash-arvon tulee olla kuten 'rel' => {rel_id => RECORD_ID} tai 'rel' => {rel_id => [RECORD_ID, RECORD_ID2]}, jos sinulla on useita moniin-suhde. Missä RECORD_ID on tietueen tunnus, johon haluat linkittää nykyinen ennätys. Ole hyvä ja katso alla, kuinka saada rel_id.

Parametrit

rest_api_key

API-avain

PROPERTY_ID

ENTITY_ID

Sinun on tiedettävä kentän lomaketunniste, jotta kenttäasetukset voidaan päivittää. Löydät ENTITY_ID: n Hae kaikki lomakkeet -puhelulla. Kun tiedät sen, tarvitset lisätäksesi tämän ENTITY_ID-osoitteen alla olevan linkin URL-osoitteeseen, ts. othertamalla /apps/APP_ID/entities/ENTITY_ID/properties.json tiedostoksi /apps/qweWO_dVXHdHie1WeGFE8k2/entities/aOWO_dVXHdHie1WeGFE8k2/properties.json

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/entities/ENTITY_ID/get_rel_id/PROPERTY_ID.json?rest_api_key=API_KEY

Pyynnön elin

{"rest_api_key":"API_KEY", {"entity_id" : ENTITY_ID, "property_id" : PROPERTY_ID}}

Vastaus

Raportit

Tällaiset raportin määritteet ovat käytettävissä REST-sovellusliittymän kautta.

name

nimi

Hae raportit

Parametrit

rest_api_key

API-avain

APP_ID

Sovelluksen tunnus

ENTITY_ID

Taulukon (lomakkeen) tunnus

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/views/index.json

Pyynnön elin

{"rest_api_key":"API_KEY"}

Vastaus: palauttaa kaikki taulukoraportit.

    
{"reports":[
{"id"              : "aOWO_dVXHdHie1WeGFE8k2"
 "name"            : "Report Name 1",
 "created_at"      : "2011-08-16T05:42:40-05:00",
 "updated_at"      : "2011-08-16T05:42:40-05:00",
 "entity_id"    : 'aEWQZdIXfahOqWvcvwrGTP',
 "app_id"  : 'ddIbpcNSncW5xcHxpdHCoW'
 },
{"id"              : "aOWO3eVXHdHie1WeGFE8k2"
 "name"            : "Report Name 2",
 "created_at"      : "2011-04-29T01:26:22-05:00",
 "updated_at"      : "2011-08-16T00:47:56-05:00",
 "entity_id"       : 'RtWQZdIXfahOqWvcvwrGTP',
 "app_id"          : 'ddIbpcNSncW5xcHxpdHCoW'
} ]}

Making request (XML)

Muoto

XML

menetelmä

GET

URL

/apps/APP_ID/entities/ENTITY_ID/views/index.xml

Pyynnön elin: palauttaa kaikki taulukoraportit.

<?xml version="1.0" encoding="UTF-8"?>
<api_call_params>
<rest_api_key>API_KEY</rest_api_key>
</api_call_params>

Vastaus

    
<?xml version="1.0" encoding="UTF-8"?>
<reports type="array">
<report>
<id>bYWQnuBajdBOkAW4BdMmki</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<created-at type="datetime">2011-09-17T10:40:40-05:00</created-at>
<updated-at type="datetime">2011-09-17T10:40:40-05:00</updated-at>
</record>
<record>
<id>dcQSkdWO1odA5HAmkYWOix</id>
<app-id>ddIbpcNSncW5xcHxpdHCoW</app-id>
<entity-id>aEWQZdIXfahOqWvcvwrGTP</entity-id>
<created-at type="datetime">2011-09-17T04:28:10-05:00</created-at>
<updated-at type="datetime">2011-09-17T04:28:10-05:00</updated-at>
</report>
</reports>

Tiedostot

Hae tiedoston URL-osoite

Lataustiedostojen lataamiseksi sinun on ensin haettava tietueiden arvot ja sitten voit ladata tiedoston tämänkaltaisen linkin avulla: https://quintadb.com/images/data/PROPERTY_ID/RECORD_ID/FILE_NAME, missä FILE_NAME - tiedostonimi, jonka saat tietueen arvojen tiivisteestä, joka näyttää tältä: PROPERTY_ID => VALUE, RECORD_ID - tietueen tunnus, PROPERTY_ID - kentän tunnus.

Lähetä tiedostoja

Tiedoston lataamiseksi tietueeseen sinun on tehtävä POST-pyyntö upload_file API -menetelmälle, jossa on multipart/form-data content type -otsikko ja vasta sen jälkeen sinun on luotava tai päivitettävä tietueesi. Joten tietueen tunnus tulisi luoda ennen puheluita. Ja sinun on luotava myös Multipart-otsikko, seuraa Ruby-esimerkkiä MultipartPost-luokan kanssa. Esimerkiksi opit myös lataamaan tiedoston alilomakkeeseen.

Rubiiniesimerkki

  
    require 'open-uri'
    require 'openssl'

    require 'net/http'
    require 'json'
    require 'securerandom'

    #MultipartPost
    class MultipartPost
      BOUNDARY = "-----------RubyMultipartPost"
      EOL = "\r\n"

      def initialize uri, &block
        @params = Array.new
        @uri = URI.parse uri
        instance_eval &block if block
      end

      def params_part key, value
        @params << multipart_text(key, value)
      end

      def files_part key, filename, mime_type, content
        @params << multipart_file(key, filename, mime_type, content)
      end

      def request_body
        body = @params.map{|p| "--#{BOUNDARY}#{EOL}" << p}.join ""
        body << "#{EOL}--#{BOUNDARY}--#{EOL}"
      end

      def run
        https = Net::HTTP.new @uri.host, @uri.port
        https.use_ssl = true
        https.verify_mode = (OpenSSL::SSL::VERIFY_PEER)
        request = Net::HTTP::Post.new @uri.request_uri
        request.body = request_body
        request.set_content_type "multipart/form-data", {"boundary" => BOUNDARY}
        res = https.request request
        res.body
      end

      private
      def multipart_text key, value
        content = "Content-Disposition: form-data; name=\"#{key}\"" <<
          EOL <<
          EOL <<
          "#{value}" << EOL
      end

      def multipart_file key, filename, mime_type, content
        content = "Content-Disposition: form-data; name=\"#{key}\"; filename=\"#{filename}\"#{EOL}" <<
          "Content-Type: #{mime_type}\r\n" <<
          EOL <<
          "#{content}" << EOL
      end
    end #MultipartPost

    def call_quinta(url, format, method, params={})
      uri = URI.parse(url)

      req = case method
              when "get"
                Net::HTTP::Get.new(uri.path) 
              when "post" 
                Net::HTTP::Post.new(uri.path)
              when "put"
                Net::HTTP::Put.new(uri.path)
              when "delete"
                Net::HTTP::Delete.new(uri.path)
            end

      req.body = case format
                  when "json"
                    JSON.generate(params)
                  else
                    "no"
                end
      
      req["Content-Type"] = "application/#{format}"

      https = Net::HTTP.new(uri.host, uri.port)

      https.use_ssl = (uri.scheme == 'https')
      https.verify_mode = (OpenSSL::SSL::VERIFY_PEER)

      https.start do |htt| 
        htt.request(req)
      end
    end

    dtype_id = SecureRandom.urlsafe_base64

    app_id   = "bsx8kgWR9jWOBdUftcRXf9"
    entity_id = "arjadcLJzeWOi1WPddL8ol"
    property_id = "bwW68wWP1cSikQqSkhl04I"

    post_url = "https://localhost:3001/entities/#{app_id}/upload_file/#{property_id}.json?dtype_id=#{dtype_id}"

    # Path to your file
    file_path = "/home/igor/Pictures/Selection_001.png"
    file = File.open file_path
    # getting file's content type, i.e. 'image/png'
    file_content_type =  `file --b --mime-type '#{file_path}'`.strip


    multi_part = MultipartPost.new post_url do
      params_part "rest_api_key", rest_api_key
      files_part "dtype[#{property_id}]", "Selection_001.png",
        file_content_type, file.read
    end
    p multi_part.run

    # And below is the example of how to upload the file to Subform
    rest_api_key          = "API_KEY"
    subform_field_id      = "dcL8kXB8npd5pdRmk7BCoR"
    subform_file_field_id = "aVWR3cNtvdUikQn8o3yCo1"
    subform_form_id       = "cCcxjdWRXpWPTLWOjvWPfO"
    subform_dtype_id      = SecureRandom.urlsafe_base64

    file_path = "/home/igor/Pictures/Selection_002.png"
    file = File.open file_path
    # getting file's content type, i.e. 'image/png'
    file_content_type =  `file --b --mime-type '#{file_path}'`.strip

    post_url = "https://quintadb.com/entities/#{app_id}/upload_file/#{subform_file_field_id}.json?dtype_id=#{subform_dtype_id}"

    # upload file into subform record
    multi_part = MultipartPost.new post_url do
      params_part "rest_api_key", rest_api_key
      params_part "subform_field", subform_field_id
      params_part "property_id", subform_file_field_id
      params_part "subform_dtype_id", subform_dtype_id
      files_part "subforms[#{subform_field_id}][#{subform_dtype_id}][#{subform_file_field_id}]", "Selection_002.png",
        file_content_type, file.read
    end
    p multi_part.run

    text_field_on_a_form = "agW6rGWQHiWPvdWPL0oCoj"
    text_field_on_a_subform = "dcV8k6y8nhWP4JF0r6W5LI"
    params = { 
      :page => 1,
      :rest_api_key => rest_api_key,  
      values: {entity_id: entity_id, id: dtype_id, text_field_on_a_form =>  "Test"},
      subforms: {subform_field_id => {entity_id: subform_form_id, subform_dtype_id => { text_field_on_a_subform => "Test2"}}}
    }
    response = call_quinta "https://quintadb.com/apps/#{app_id}/dtypes.json", "json", "post", params

    puts response.body

Parametrit

rest_api_key

API-avain

APP_ID

property_id

dtype_id

Making request (JSON)

Muoto

JSON

menetelmä

POST

URL

/entities/APP_ID/upload_file/PROPERTY_ID.json?dtype_id=DTYPE_ID

Pyynnön elin

{"rest_api_key"=>API_KEY, "filedata"="your_file_here", "dtype_id"=>"fRLA83jrnAUOi5TEQLyuGw", "app_id"=>"bsx8kgWR9jWOBdUftcRXf9"}

Vastaus

    Uploaded

Poista tiedostot

Parametrit

rest_api_key

API-avain

APP_ID

property_id

DTYPE_ID

SINGLE_FILE_NAME

Tiedoston nimi

Making request (JSON)

Muoto

JSON

menetelmä

GET

URL

/dtypes/delete_dtype_file/APP_ID/DTYPE_ID/PROPERTY_ID.json

Pyynnön elin

{"rest_api_key"=>API_KEY, "single_file_name"=>"Selection_002.png", "app_id"=>"bsx8kgWR9jWOBdUftcRXf9", "dtype_id"=>"wlS5MeyMqQiCv16FdG3ztQ", "property_id"=>"bwW68wWP1cSikQqSkhl04I"}

Vastaus

    File removed

Esimerkkejä

Ruby ~ Javascript (jQuery)

    	
require 'open-uri'
require 'openssl'

require 'net/http'
require 'json'

def call_mth(url, format, method, params={})
  uri = URI.parse(url)

	# Creating proper call with Method: GET/POST/PUT/DELETE
  req = case method
          when "get"
            Net::HTTP::Get.new(uri.path) 
          when "post" 
            Net::HTTP::Post.new(uri.path)
          when "put"
            Net::HTTP::Put.new(uri.path)
          when "delete"
            Net::HTTP::Delete.new(uri.path)
        end

   # Muunna parametrit JSON/XML-muotoon ja aseta sisältötyypiksi application/json tai application/xml   Huomaa parametrien XML-muoto, juurielementti on api_call_params  
  req.body = case format
              when "xml"
                "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
                  <api_call_params>
                    #{params.collect{|key, value| "<#{key}>#{value}"}.join("")}
                  </api_call_params>"
              when "json"
                JSON.generate(params)
              else
                "no"
            end
	# Sisältötyypin asettaminen
  req["Content-Type"] = "application/#{format}"

  https = Net::HTTP.new(uri.host, uri.port)

  # Kaikki puhelut HTTPS n kautta ja SSL-varmenteiden tarkistaminen

  https.use_ssl = (uri.scheme == 'https')
  https.verify_mode = (OpenSSL::SSL::VERIFY_PEER)
	# Making request
  https.start do |htt| 
    htt.request(req)
  end
end


# Muista asettaa oma API_KEY tähän
params = { 
  :page => 1,
  :rest_api_key => "API_KEY"
}

response = call_mth "https://quintadb.ru/apps.json", "json", "get", params
# Vastaus tulee olemaan response.body
puts response.body

Tiedetään hyvin, että ohjelmistokehitys on erittäin tärkeää näinä päivinä. REST-sovellusliittymän käyttäminen ohjelmistollesi lisää tuotteidesi suosiota. Tämä on perus-REST-sovellusliittymä, ja sen pitäisi riittää luomaan hienoja asioita. Jos kuitenkin tarvitset jotain othera, lisää menetelmiä jne., ole hyvä ja ota meihin yhteyttä milloin tahansa. Odotamme kuulevamme sinusta!

QuintaDB REST -sovellusliittymä

Yleistä tietoa API-kutsuista

Tietokanta

lomake

Kenttä

Tallenna

Raportit

Tiedostot

QuintaDB.com käyttää evästeitä tarjoamaan tarvittavat sivuston toiminnot ja parantamaan kokemustasi. Käyttämällä verkkosivustoamme hyväksyt evästekäytäntömme.