QuintaDB REST API

Interfejs API REST QuintaDB Zaaplikacjaowany, abyś mógł w pełni wykorzystać potencjał danych przechowywanych w bazie danych QuintaDB. Korzystając z tego interfejsu API, możesz osiągnąć więcej niż obecnie oferuje interfejs QuintaDB. W rzeczywistości dajemy Ci możliwość robienia wszystkiego, czego potrzebujesz z danymi. Na przykład możesz tworzyć własne skrypty, aplikacje komputerowe i aplikacje mobilne na różne platformy, takie jak iPhone / Android i inne. A QuintaDB pozostanie tam, gdzie przechowujesz, zarządzasz i wykorzystujesz swoje dane razem z innymi.

Ogólne informacje o wywołaniach API

Wszystkie wywołania muszą zawierać klucz API REST, który można znaleźć, klikając przycisk „Klucze API” na początku strony.
Odpowiedź serwera może zostać odebrana w formacie JSON lub XML , w zależności od żądania.
Poniżej przedstawiamy tabele z odpowiedziami serwera dla każdego żądania. Adresy URL będą wyświetlane jako /apps.json , co oznacza, że musisz wywołać metodę z linkiem https://QuintaDB.ru /apps.json w swoim programie. Pamiętaj, że wszystkie wywołania muszą używać protokołu https i musisz sprawdzić certyfikat SSL serwera pod kątem ważności.

Baza danych

Takie atrybuty bazy danych mogą być uzyskane przy użyciu REST API.

Unikalny identyfikator bazy danych

name

Nazwa

created_at

Czas, gdy baza danych została utworzona

updated_at

Czas, gdy baza danych została zaktualizowana

Zobacz wszystkie bazy danych

Parametry

rest_api_key

twój klucz API

page

Bazy danych są wyświetlane po 20 na stronę, czyli page może być 1..5

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps.json

Treść żądania

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

Odpowiedź: wraca wszystkie bazy danych

    
{"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
} ]}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps.xml

Treść żądania

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

Odpowiedź: wraca wszystkie bazy danych

    
<?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>

Uzyskać bazy danych za ID

Parametry

rest_api_key

twój klucz API

APP_ID

Musisz znać identyfikator bazy, którą chcesz usunąć. Możesz znaleźć ID po otrzymaniu wszystkich baz danych. Znając identyfikator bazy, trzeba wymienić ID w URL, na przykład: /apps/ID.json na /apps/aOWO_dVXHdHie1WeGFE8k2.json

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/APP_ID.json

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź: wraca informacje o bazie danych

    
{"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
 }
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/APP_ID.xml

Treść żądania

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

Odpowiedź: wraca informacje o bazie danych

    
<?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>

Uzyskać bazę danych według nazwy

Parametry

rest_api_key

twój klucz API

Nazwa

Musisz znać nazwę bazy danych. Nazwę można uzyskać, wykonując zapytanie Uzyskaj wszystkie bazy danych ..

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/search.json

Treść żądania

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

Odpowiedź: wraca informacje o bazie danych

    
{"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
 }
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/search.xml

Treść żądania

<?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>

Odpowiedź: wraca informacje o bazie danych

    
<?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>

Zaktualizować bazę danych

Parametry

rest_api_key

twój klucz API

APP_ID

name

Nowa nazwa bazy danych

Składamy zapytanie (JSON)

Format

JSON

Metoda

PUT

URL

/apps/APP_ID.json

Treść żądania

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

Odpowiedź: wraca informacje o bazie danych

    
{"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
 }
}

Składamy zapytanie (XML)

Format

XML

Metoda

PUT

URL

/apps/APP_ID.xml

Treść żądania

<?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>

Odpowiedź: wraca informacje o bazie danych

    
<?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>

Usuń bazę danych

Parametry

rest_api_key

twój klucz API

APP_ID

Składamy zapytanie (JSON)

Format

JSON

Metoda

DELETE

URL

/apps/APP_ID.json

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź

    
{"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
} ]}

Składamy zapytanie (XML)

Format

XML

Metoda

DELETE

URL

/apps/APP_ID.xml

Treść żądania

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

Odpowiedź

    
<?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>

Po usunięciu bazy ten metod wraca wszystkie bazy danych, które pozostały.

Utworzyć aplikacja

Parametry

rest_api_key

twój klucz API

database_name

Nazwa bazy danych

form_name

Nazwa formularza. Nie można utworzyć bazy danych bez formularza, ponieważ nie ma sensu w bazie danych bez formularza.

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/apps.json

Treść żądania

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

Odpowiedź: wraca informacje o bazie danych

    
{"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
    }
}

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/apps.xml

Treść żądania

<?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>

Odpowiedź: wraca informacje o bazie danych

    
  <?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>

W przypadku błędu. Zostanie wyświetlony komunikat o błędzie, np. 'Taka nazwa aplikacji już istnieje'.

Formularz

Takie atrybuty kształtu mogą być uzyskane przez REST API.

Unikalny identyfikator formularza

name

Nazwa

desc

Opis

post_action

Wykaz odbiorców e-mail wiadomości

Uzyskaj wszelkie formularzy

Parametry

rest_api_key

twój klucz API

APP_ID

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/APP_ID/entities.json

Treść żądania

{rest_api_key":"API_KEY"}

Odpowiedź: Uzyskać wszystkie formularzy bazy danych

    
{"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
      } ]}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/APP_ID/entities.xml

Treść żądania

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

Odpowiedź: Uzyskać wszystkie formularzy bazy danych

    
<?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>

Pobierz formularz w ID

Parametry

rest_api_key

twój klucz API

APP_ID

Musisz znać identyfikator formularza. Możesz znaleźć ENTITY_ID po otrzymaniu wszystkie formularze. Znając identyfikator formularza, trzeba wymienić ENTITY_ID w adresie URL, na przykład: /apps/APP_ID/entities.json na /apps/aOWO_dVXHdHie1WeGFE8k2/entities.json

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/APP_ID/entities/ID.json

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź: zwraca informacje o formularzach

    
{"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
      }
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/APP_ID/entities/ID.xml

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Pobierz formularz według Nazwy

Parametry

rest_api_key

twój klucz API

database_name

Musisz znać nazwę bazy danych. Nazwę można uzyskać, wykonując zapytanie Uzyskaj wszystkie bazy danych ..

form_name

Musisz znać nazwę formularza. Można ją uzyskać za pomocą połączenia Uzyskaj wszystkie formularze .

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/search/entities/search.json

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
{"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
      }
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/search/entities/search.xml

Treść żądania

<?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>

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Zaktualizować formularz

Parametry

rest_api_key

twój klucz API

APP_ID

name

Nowa nazwa formularza. Zobacz wszystkie dostępne opcje tutaj

Składamy zapytanie (JSON)

Format

JSON

Metoda

PUT

URL

/apps/APP_ID/entities/ID.json

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
{"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
     }
}

Składamy zapytanie (XML)

Format

XML

Metoda

PUT

URL

/apps/APP_ID/entities/ID.xml

Treść żądania

<?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>

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Usunąć formularz

Parametry

rest_api_key

twój klucz API

APP_ID

Musisz znać identyfikator formularza, który chcesz usunąć. Możesz znaleźć ID po otrzymaniu wszystkich formularzów. Znając identyfikator formularze, trzeba wymienić ID w URL, na przykład: /apps/APP_ID/entities/ID.json na /apps/qweWO_dVXHdHie1WeGFE8k2/entities/aOWO_dVXHdHie1WeGFE8k2.json

Składamy zapytanie (JSON)

Format

JSON

Metoda

DELETE

URL

/apps/APP_ID/entities/ID.json

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź

    
{"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
      } ]}

Składamy zapytanie (XML)

Format

XML

Metoda

DELETE

URL

/apps/APP_ID/entities/ID.xml

Treść żądania

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

Odpowiedź

    
<?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>

Stworzyć formularz

Parametry

rest_api_key

twój klucz API

APP_ID

name

Nazwa formularza

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/apps/APP_ID/entities.json

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
{"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
      }
}

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/apps/APP_ID/entities.xml

Treść żądania

<?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>

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Pole

Takie atrybuty pola mogą być uzyskane przez REST API.

Unikalny identyfikator pola

entity_id

Identyfikator pola formularza

name

Nazwa

type_name

Typ pola. Może być: 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

Otrzymaj pola formularza

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

{rest_api_key":"API_KEY"}

Odpowiedź: Otrzymaj wszystkie pola formularza

    
{"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
 }
  ]}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź: Otrzymaj wszystkie pola formularza

    
<?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>

Uzyskaj pole

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

Musisz znać identyfikator pola. Możesz znaleźć ID po otrzymaniu wszystkie pola formularza. Znając identyfikator pola, trzeba wymienić ID w URL, na przykład: /apps/APP_ID/entities/ENTITY_ID/properties/ID.json na /apps/qweWO_dVXHdHie1WeGFE8k2/entities/aOWO_dVXHdHie1WeGFE8k2/properties/asdasddVXHdHie1WeGFE8k2.json

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź

    
{"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
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

    
<?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>

Uzyskaj pole z Nazwą

Parametry

rest_api_key

twój klucz API

database_name

Musisz znać nazwę bazy danych. Nazwę można uzyskać, wykonując zapytanie Uzyskaj wszystkie bazy danych ..

form_name

Musisz znać nazwę formularza. Można ją uzyskać za pomocą połączenia Uzyskaj wszystkie formularze .

field_name

Musisz znać nazwę pola. Można ją uzyskać za pomocą połączenia Uzyskaj wszystkie pola formularza .

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

    
{"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
 }
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

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

Treść żądania

<?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>

Odpowiedź

    
<?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>

Uruchom akcję

Parametry

rest_api_key

twój klucz API

DTYPE_ID

Musisz znać swój identyfikator rekordu. Możesz go znaleźć za pomocą wywołania Pobierz wszystkie rekordy.

ACTION_PROPERTY_ID

Musisz znać identyfikator swojego pola. Identyfikator możesz znaleźć za pomocą wywołania Pobierz wszystkie pola formularza.

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/actions/ACTION_PROPERTY_ID.json

Treść żądania

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

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/actions/ACTION_PROPERTY_ID.xml

Treść żądania

<?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>

Odpowiedź

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

Uruchom akcje

Parametry

rest_api_key

twój klucz API

ACTION_PROPERTY_ID

Musisz znać identyfikator swojego pola. Identyfikator możesz znaleźć za pomocą wywołania Pobierz wszystkie pola formularza.

dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy.

json_dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy.

run_by_all_table_or_report

Następujący parametr jest dostępny do uruchamiania wszystkich działań w tabeli lub raporcie: run_by_all_table_or_report=true.

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/actions/ACTION_PROPERTY_ID.json

Treść żądania

{"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}

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/actions/ACTION_PROPERTY_ID.xml

Treść żądania

<?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>

Odpowiedź

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

Zaktualizować pole

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

name

Nowa nazwa pola. Wszystkie dostępne atrybuty można znaleźć tutaj

Składamy zapytanie (JSON)

Format

JSON

Metoda

PUT

URL

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

Treść żądania

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

Odpowiedź

    
{"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
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

PUT

URL

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

Treść żądania

<?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>

Odpowiedź

    
<?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>

Usuń pole

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

Składamy zapytanie (JSON)

Format

JSON

Metoda

DELETE

URL

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

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź

    
{"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
 }
  ]}

Składamy zapytanie (XML)

Format

XML

Metoda

DELETE

URL

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

Treść żądania

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

Odpowiedź

    
<?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>

Stworzyć pole

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

name

Nazwa pola

type_name

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

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

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
{"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
 }
}

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

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

Treść żądania

<?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>

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Uzyskaj sumy w kolumnie

Parametry

rest_api_key

twój klucz API

ENTITY_ID

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/search/sum/ENTITY_ID/ID.json

Treść żądania

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

Odpowiedź

    
{total: 3}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/search/sum/ENTITY_ID/ID.xml

Treść żądania

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

Odpowiedź

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

Rekord

Takie atrybuty nagrywania mogą być uzyskane przez REST API.

Unikalny identyfikator rekordu.

app_id

ID aplikacjau

entity_id

Identyfikator formularza rekord.

values

Hash wartości zapisu. Gdzie kluczem jest identyfikator pola, a wartością - wartość pola.

json_values

Zapisz hash wartości. Gdzie klucz to identyfikator pola, a wartość to ta wartość pola. Analog z values_hash, ale w formacie JSON

rel_values

Hash wartości związku zapisu. Gdzie kluczem jest identyfikator pola, a wartością - identyfikator powiązanego rekordu.

Uzyskaj rekordy

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

page

Numer strony z rekordami. Od 1 do liczby rekordów/per_page.

name_value

Użyj parametru, aby uzyskać rekordy w postaci: "nazwa pola": "wartość", "id pola": "nazwa pola"

fetch_all

Dla właścicieli płatnych kont dostępny jest następujący parametr: fetch_all=true.
Aby uzyskać określoną liczbę postów, użyj parametru per_page.
Ograniczenia maksymalnej liczby wpisów per_page dla różnych planów:
FREE - 200
STANDARD - 500
PROFESSIONAL - 1000
ENTERPRISE - 2000
STANDARD EXPRESS - 4000
PROFESSIONAL EXPRESS - 8000
ENTERPRISE EXPRESS - 15000

Poproś o treść
{"rest_api_key":"API_KEY", "page": 1, "name_value": 1, "view": 'EaWQZdIXfahOqWvcvwrGTP', "fetch_all": true, "per_page": 2000}

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

    
{"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"
}
]
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

    
<?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>

Uzyskaj rekord

Parametry

rest_api_key

twój klucz API

APP_ID

Musisz znać identyfikator rekordu. ID można znaleźć po otrzymaniu wszystkich rekordów. Znając identyfikator, trzeba wymienić ID w URL, na przykład: /apps/APP_ID/dtypes/ID.json na /apps/aOWO_dVXHdHie1WeGFE8k2/dtypes/asd987asdasd97asd.json

name_value

Użyj parametru, aby uzyskać rekordy w postaci: "nazwa pola": "wartość", "id pola": "nazwa pola"

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

/apps/APP_ID/dtypes/ID.json

Treść żądania

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

Odpowiedź

    
{"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"
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

/apps/APP_ID/dtypes/ID.xml

Treść żądania

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

Odpowiedź

    
<?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>

Zaktualizować rekord

Parametry

rest_api_key

twój klucz API

APP_ID

values

Hash wartości rekordów, gdzie kluczem jest identyfikator pola formularza

json_values

Jeśli używasz jQuery, Ruby lub inny język programowania, więc prosimy podać wartości rekordu jak zakodowany skrót w parametrze 'values'. Ale jeśli twój framework ci na to nie pozwala, to możesz wysłać wartości rekordu, JSON, na przykład: "{"aNW4nkW5bdUjldO8oKuSku":"2", "aMW4HKWR9bnOoGWQbpWQS4":"aaa"}". Ale wtedy użyj nazwa parametru 'json_values'.

subforms_values / subforms_json_values

Dla tworzenia lub aktualizacji podformularzy, podobnie, użyj opcji 'subforms_values' lub 'json_subforms_values'.
następujący Format:
"{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"}}, property2_id: {entity_id: subform2_id, subform2_record1_id: {subform2_field1_id: "4", subform2_field2_id: "bb"}, subform2_record2_id: {subform2_field1_id: "5", subform2_field2_id: "dd"}}}" .

Gdzie property1_id i property2_id - to ID pól typu Podformularz w głównej tabeli.
subform1_id, subform2_id - ID formularz, na które wskazują pola property1_id i property2_id.
subform1_record1_id i subform1_record2_id - to ID nowych lub istniejących rekordów podformularz.
subform1_field1_id, subform1_field2_id - ID pól w formularzu subform1_id.
subform2_field1_id, subform2_field2_id - ID pól w formularzu subform2_id.

Wszystkie ID to 22 znakowe URL bezpieczne base64 kody, można je wziąć z innych API połączeń lub tworzyć własne dla ID nowych rekordów.

Składamy zapytanie (JSON)

Format

JSON

Metoda

PUT

URL

/apps/APP_ID/dtypes/ID.json

Treść żądania

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

Odpowiedź

    
{"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"
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

PUT

URL

/apps/APP_ID/dtypes/ID.xml

Treść żądania

<?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>

Odpowiedź

    
<?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>

Zaktualizować kilka rekordów

Parametry

rest_api_key

twój klucz API

confirm_action

Poniższy parametr jest wymagany do uruchomienia aktualizacji w tabeli lub raporcie: confirm_action: update.

ENTITY_ID

Musisz znać identyfikator formularza pola, aby zaktualizować ustawienia pola. Możesz znaleźć ENTITY_ID za pomocą wywołania Pobierz wszystkie formularze.

APP_ID

Musisz znać identyfikator swojej bazy danych, aby pobrać informacje o bazie danych. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie bazy danych.

dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy.

json_dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy.

update_id

Musisz znać identyfikator swojego pola. Identyfikator możesz znaleźć za pomocą wywołania Pobierz wszystkie pola formularza.

update_term

Nowa wartość dla rekordów

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.json

Treść żądania

{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"}

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.xml

Treść żądania


  <?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>

Odpowiedź

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

Zaktualizuj wszystkie rekordy

Parametry

rest_api_key

twój klucz API

confirm_action

Następujący parametr jest wymagany do uruchomienia aktualizacji wszystkich rekordów w tabeli lub raporcie: confirm_action: update_all.

ENTITY_ID

Musisz znać identyfikator formularza pola, aby zaktualizować ustawienia pola. Możesz znaleźć ENTITY_ID za pomocą wywołania Pobierz wszystkie formularze.

APP_ID

Musisz znać identyfikator swojej bazy danych, aby pobrać informacje o bazie danych. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie bazy danych.

update_id

Musisz znać identyfikator swojego pola. Identyfikator możesz znaleźć za pomocą wywołania Pobierz wszystkie pola formularza.

update_term

Nowa wartość dla rekordów

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.json

Treść żądania

{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"}

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/dtypes/confirm_action/APP_ID/ENTITY_ID.xml

Treść żądania


  <?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>

Odpowiedź

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

Zaktualizować dane komórek

Parametry

rest_api_key

twój klucz API

PROPERTY_ID

DTYPE_ID

val

Nową wartość komórki z danymi

Składamy zapytanie (JSON)

Format

JSON

Metoda

PATCH/PUT/POST

URL

/cell_values/DTYPE_ID/update_cell_value/PROPERTY_ID.json

Treść żądania

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

Odpowiedź

    
{"new_value": "John Smith"}

Składamy zapytanie (XML)

Format

XML

Metoda

PATCH/PUT/POST

URL

/cell_values/DTYPE_ID/update_cell_value/PROPERTY_ID.xml

Treść żądania

<?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>

Odpowiedź

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

Usuń rekord

Parametry

rest_api_key

twój klucz API

APP_ID

Składamy zapytanie (JSON)

Format

JSON

Metoda

DELETE

URL

/apps/APP_ID/dtypes/ID.json

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź

    
{"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"
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

DELETE

URL

/apps/APP_ID/dtypes/ID.xml

Treść żądania

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

Odpowiedź

    
<?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>

Usunąć kilka rekordów

Parametry

rest_api_key

twój klucz API

ENTITY_ID

Musisz znać identyfikator formularza pola, aby zaktualizować ustawienia pola. Możesz znaleźć ENTITY_ID za pomocą wywołania Pobierz wszystkie formularze.

APP_ID

Musisz znać identyfikator swojej bazy danych, aby pobrać informacje o bazie danych. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie bazy danych.

dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy.

json_dtype_ids

Musisz znać identyfikatory swoich rekordów. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie rekordy. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/apps/APP_ID/dtypes/delete_multiple.json

Treść żądania

{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"...]}

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/apps/APP_ID/dtypes/delete_multiple.xml

Treść żądania


  <?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>

Odpowiedź

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

Usuń wszystkie

Parametry

rest_api_key

twój klucz API

APP_ID

Musisz znać identyfikator swojej bazy danych, aby pobrać informacje o bazie danych. Możesz znaleźć identyfikator za pomocą wywołania Pobierz wszystkie bazy danych.

ENTITY_ID

Musisz znać identyfikator formularza pola, aby zaktualizować ustawienia pola. Możesz znaleźć ENTITY_ID za pomocą wywołania Pobierz wszystkie formularze.

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

Składamy zapytanie (JSON)

Format

JSON

Metoda

DELETE

URL

/dtypes/APP_ID/delete_all/ENTITY_ID.json

Treść żądania

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

Odpowiedź

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

Składamy zapytanie (XML)

Format

XML

Metoda

DELETE

URL

/dtypes/APP_ID/delete_all/ENTITY_ID.xml

Treść żądania


  <?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>

Odpowiedź

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

Nowy rekord

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

Jeśli potrzebujesz swojego osobistego identyfikatora, możesz wygenerować UUID (unikalny identyfikator) 22 znaki, bezpieczny dla adresu URL, base64 Na przykład w Rubim . Następnie musisz przekazać go do hasha 'values', na przykład: values => {'id' => ID}, zmień na: values => {'id' => '22adadVXHdHie1WeGFE8k2'}, w przeciwnym razie system wygeneruje dla Ciebie unikalny identyfikator.

values / json_values

subforms_values / subforms_json_values

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/apps/APP_ID/dtypes.json

Treść żądania

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

Odpowiedź: zwraca informacje o formularzach

    
{"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"
}
}

Składamy zapytanie (XML)

Format

XML

Metoda

POST

URL

/apps/APP_ID/dtypes.xml

Treść żądania

<?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>

Odpowiedź: zwraca informacje o formularzach

    
<?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>

Szukaj

Parametry

rest_api_key

twój klucz API

APP_ID

ENTITY_ID

view

Aby uzyskać rekordy, należy wiedzieć ID raportu. ( Niekoniecznie)

search

Chciałbyś machnąć ręką na stole? "SEARCH_TERM", "o" => "SEARCH_CRITERIA"}]].
PROPERTY_ID - identyfikator pola, po którym szukamy ( -ALL - - aby przeszukać wszystkie kolumny),
SEARCH_TERM - wartość, której szukamy,
SEARCH_CRITERIA - kryterium wiadomości, może jedno z nich:
is, is_not, is_empty, is_not_empty, starts_with, ends_with, like, contains, not_contains.

Dla zwykłych numerów i dat : less_than, greater_than, less_than_or_equal_to, greater_than_or_equal_to.

Na randkę przez około godzinę : before, after, this_day_and_before, this_day_and_after, yesterday, today, tomorrow, 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,
last_week, this_week, next_week, current_and_prev_week, current_and_next_week, next_n_weeks, last_n_weeks, last_month, this_month, next_month,
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,
current_and_next_year, next_n_years, last_n_years.

Kolumny systemowe : added_by, created_at, updated_at, ip.

Jeśli chcesz wyszukiwać w kilku kolumnach za pomocą ujednolicającego kryterium „I”, kryteria te należy umieścić w jednej tablicy, jeśli „LUB”, to w osobnym, na przykład:
[[{"a" => "PROPERTY_ID_1", "b" => "A", "o" => "is"}, {"a" => "PROPERTY_ID_2", "b" => "A", "o" => "is"}],
[{"a" => "PROPERTY_ID_3", "b" => "B", "o" => "SEARCH_CRITERIA"}]]

formuła wyszukiwania będzie: "Find all records where PROPERTY_ID_1 AND PROPERTY_ID_2 are equal to A OR PROPERTY_ID_3 is equal to B"

limit

Liczba rekordów w wynikach wyszukiwania, maksymalna to 200.

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

/search/APP_ID.json

Treść żądania

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

Odpowiedź

    
{"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"
}
]
}

Związek

Jak powiązać rekordy:

Do tego, aby nawiązać związek pomiędzy rekordami trzeba wysłać osobny hash w zapytaniu na TWORZENIA lub AKTUALIZACJI rekordu.

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"

Hash musi być w postaci 'rel' => {rel_id => RECORD_ID} lub 'rel' => {rel_id => [RECORD_ID, RECORD_ID2]} jeśli masz związek Wiele-do-wielu. Gdzie RECORD_ID - to identyfikator rekordu w którym chcesz połączyć bieżący rekord. Poniżej pokazano jak uzyskać rel_id.

Parametry

rest_api_key

twój klucz API

PROPERTY_ID

ENTITY_ID

Musisz wiedzieć identyfikator formularza. Możesz znaleźć ENTITY_ID po otrzymaniu wszystkich formularzy. Znając identyfikator formularza trzeba wymienić ENTITY_ID w adresie URL, na przykład /apps/APP_ID/entities/ENTITY_ID/properties.json na /apps/qweWO_dVXHdHie1WeGFE8k2/entities/aOWO_dVXHdHie1WeGFE8k2/properties.json

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

Raporty

Takie atrybuty raportu mogą być dostępne za pośrednictwem REST API.

name

Nazwa

Pobierz raporty

Parametry

rest_api_key

twój klucz API

APP_ID

ID aplikacjau

ENTITY_ID

Identyfikator tabeli (formularza)

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

{"rest_api_key":"API_KEY"}

Odpowiedź: zwraca wszystkie raporty tabeli.

    
{"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'
} ]}

Składamy zapytanie (XML)

Format

XML

Metoda

GET

URL

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

Treść żądania: zwraca wszystkie raporty tabeli.

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

Odpowiedź

    
<?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>

Pliki

Zobacz link do pliku

aby uzyskać link do pliku, na początek uzyskaj wartości pól rekordu i możesz pobrać plik z linku https://quintadb.com/images/data/PROPERTY_ID/RECORD_ID/FILE_NAME, gdzie FILE_NAME - nazwa pobranego pliku, otrzymaną w hashe wartości rodzaju PROPERTY_ID => VALUE, RECORD_ID - ID rekordu, PROPERTY_ID - ID pola.

Pobierz pliki

Aby załadować plik do rekordu, musisz wysłać żądanie POST do metody API upload_file z nagłówkiem typu treści multipart / form-data, a dopiero potem musisz utworzyć lub zaktualizować swój rekord. Więc identyfikator rekordu powinien zostać wygenerowany przed wywołaniami. Musisz także wygenerować nagłówek Multipart, postępuj zgodnie z przykładem Ruby z klasą MultipartPost poniżej. W przykładzie nauczysz się również, jak załadować plik do podformularza.

Przykład na Ruby

  
    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

Parametry

rest_api_key

twój klucz API

APP_ID

property_id

dtype_id

Składamy zapytanie (JSON)

Format

JSON

Metoda

POST

URL

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

Treść żądania

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

Odpowiedź

    Uploaded

Usuń pliki

Parametry

rest_api_key

twój klucz API

APP_ID

property_id

DTYPE_ID

SINGLE_FILE_NAME

Nazwa pliku

Składamy zapytanie (JSON)

Format

JSON

Metoda

GET

URL

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

Treść żądania

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

Odpowiedź

    File removed

Przykłady

Ruby ~ Javascript (jQuery)

    	
require 'open-uri'
require 'openssl'

require 'net/http'
require 'json'

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

	# Utwórz wywołanie do wymaganej metody: 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

   # Konwertuj parametry na JSON / XML i ustaw typ zawartości jako application / json lub application / xml   Zwróć uwagę na format parametru XML, w którym elementem głównym jest 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
	# Ustaw typ zawartości
  req["Content-Type"] = "application/#{format}"

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

  # Wszystkie połączenia HTTPS i certyfikaty SSL są sprawdzane

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


# Pamiętaj, aby ustawić klucz API_KEY
params = { 
  :page => 1,
  :rest_api_key => "API_KEY"
}

response = call_mth "https://quintadb.ru/apps.json", "json", "get", params
# Odpowiedź będzie dostępna response.body
puts response.body

To jest podstawowy REST API i jego musi być na tyle, aby stworzyć fajne i przydatne rzeczy. Jednak, jeśli chcesz coś jeszcze, na przykład, więcej metod, itp. Prosimy skontaktować się z nami w każdej chwili. Zawsze jesteśmy podekscytowani, aby usłyszeć od ciebie!

QuintaDB REST API

Ogólne informacje o wywołaniach API

Baza danych

Formularz

Pole

Rekord

Raporty

Pliki

Wykorzystujemy pliki cookie, aby zapewnić niezbędną funkcjonalność serwisu. Klikając "Akceptuj", wyrażasz zgodę na korzystanie z plików cookie na naszej stronie internetowej.