Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

--- et:api_direct [2026/04/01 14:58] – [📦 API Resources & Endpoints] toomas
+++ et:api_direct [2026/09/01 15:41] (Hetkel kehtiv) – [Getting Your API Key] toomas
@@ Rida 10: / Rida 10: @@
   * API key (obtain from your Directo administrator)
   * Basic understanding of REST APIs and HTTP methods
-  * API Resources and Endpint can be found in Postman collection. Response field list managed in Directo ERP. Postman collection can be downloaded here: {{:et:toomas20260401-145732.json|POSTMAN}}
+  * API Resources and Endpint can be found in Postman collection. Response field list managed in Directo ERP. Postman collection can be downloaded here: [[:et:api_direct:postman|POSTMAN]]
 ==== Quick Start Guide ====
@@ Rida 27: / Rida 27: @@
 **Current Configuration:**
-  * **baseUrl**: [https://login.directo.ee/apidirect](https://login.directo.ee/apidirect)
+  * **baseUrl**: <code>https://login.directo.ee/apidirect</code>
-  * **version**: 1 (current API version)
+  * **version**: <code>1</code> (current API version)
 **Example Full URL:**
 <code>
-[https://login.directo.ee/apidirect/v1/items](https://login.directo.ee/apidirect/v1/items)
+https://login.directo.ee/apidirect/v1/items
 </code>
@@ Rida 48: / Rida 48: @@
 ==== Getting Your API Key ====
-Contact your Directo system administrator to obtain an API key. Each key is associated with specific permissions and access levels.
+If your company doesn't have an API key yet, contact your Directo project manager — they will generate it.
+If a key has already been created, there's no need to request it again: any user with SUPER rights can view it on the employee card under Settings → Integration.
 ==== Security Best Practices ====
@@ Rida 172: / Rida 174: @@
 </code>
 **Key Principle:** Use the exact field name as it appears in the API response (or as you see it in the ERP system).
+====Contains Filtering ====
+This filtering allows you to search for values containing a specific substring.
+This works like SQL LIKE'' '%text%' ''logic.
+Use it when you need flexible filtering for names, codes, descriptions, or any other text fields
+<code>
+GET {{baseUrl}}/v{{version}}/customers?name=%john%
+</code>
 ==== Comparison Operators ====
@@ Rida 230: / Rida 243: @@
 If you have custom fields defined in your ERP system (visible in the datafields array), you can filter by them:
 <code>
-GET {{baseUrl}}/v{{version}}/items?IS_WEIGHT=1
+GET {{baseUrl}}/v{{version}}/items?data_row_code=ART_PROJ
-GET {{baseUrl}}/v{{version}}/items?VISUAL_VERIFICATION=1
+GET {{baseUrl}}/v{{version}}/items?data_row_code=ART_PROJ,BRAND
 </code>
 **How to Find Custom Field Names:** Make a request without filters and examine the datafields array in the response.
@@ Rida 321: / Rida 334: @@
 GET {{baseUrl}}/v{{version}}/sales_contracts
 GET {{baseUrl}}/v{{version}}/replacementlogs
+GET {{baseUrl}}/v{{version}}/users
+GET {{baseUrl}}/v{{version}}/recipes
+GET {{baseUrl}}/v{{version}}/nettings
+GET {{baseUrl}}/v{{version}}/usagelogs
+GET {{baseUrl}}/v{{version}}/expenses
+GET {{baseUrl}}/v{{version}}/approvals
 </code>
-Postman collection can be downloaded here: e: {{:et:toomas20260401-145732.json|Directo API postman collection}}
+Postman collection can be downloaded here: e: [[:et:api_direct:postman|POSTMAN]]
@@ Rida 636: / Rida 654: @@
 </code>
+==== Issue: `usagelogs` missing older entries ====
+**Possible Cause:** Log retention is capped by Administrator settings
+("Log age in days" / "Log age in transactions" — see
+[Administraatori seadistused](https://wiki.directo.ee/et/administrator_settings)),
+not by the API itself.
+**Solution:** Ask your administrator to check/raise these two settings, or
+start pulling and archiving `/usagelogs` regularly to keep your own history.
 ===== 📞 Support & Resources =====