เว็บเซอร์วิส wsdl และสคีมาอยู่ที่นี่:
https://wsdfn.infoproff.com/v4/
Postman Collection (API v4) — Ready for Use:
https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4
Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.
The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.
Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.
Authentification details
The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.
The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.
The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.
Web service functions:
API ให้บริการหลายอย่าง:
การค้นหาบริษัทประกอบด้วย 2 ตัวเลือก:
The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.
search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".
It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.
ทะเบียนของนอร์เวย์ไม่อนุญาตให้ค้นหาบริษัทที่ถูกยกเลิกแล้วโดยใช้ชื่อ ดังนั้นเราจึงไม่สามารถให้บริการSimpleSearchโดยใช้ชื่อภายในบริษัทที่ถูกยกเลิกในนอร์เวย์ได้
ด้านล่างนี้คุณสามารถดูตัวอย่างได้:
Below you can find the example of how to order and download reports:
To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: วิธีค้นหาบริษัท?
สถานะต่อไปนี้ใช้สำหรับรายงาน:
หากสถานะการดำเนินการคือ{เสร็จสิ้น}หรือ{อัปเดต} คุณสามารถรับคำสั่งซื้อได้
สถานะต่อไปนี้ใช้สำหรับรายงาน:
หากสถานะการดำเนินการคือ{เสร็จสิ้น}หรือ{อัปเดต} คุณสามารถรับคำสั่งซื้อได้
Below you can find the example of how to order and download archived reports:
To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: วิธีค้นหาบริษัท?
Example companies with archived reports:
Just like the online/offline reports.
Just like the online/offline reports.
Just like the online/offline reports.
Just like the online/offline reports.
To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: วิธีค้นหาบริษัท?
ฟังก์ชันนี้จำเป็นเฉพาะเมื่อสั่งซื้อสินค้า:finances(Financial statements) พร้อมdelivery_term = 'o'.
สถานะต่อไปนี้ใช้สำหรับรายงาน:
If the execution status is Finished or Updated, then you can get an order.
คำขอประกอบด้วย 3 ส่วน:
/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
คำขอประกอบด้วย 3 ส่วน:
delivery_term:
ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นในขณะทำการร้องขอไปยังบริการเว็บของเรา.
country_economic_overview — รวมถึงหัวข้อย่อยต่อไปนี้:data_transparency_index,country_development_indicators,economic_forecast.paid_taxes — ข้อมูลเกี่ยวกับภาษีที่ชำระแล้วtenders — ข้อมูลเกี่ยวกับการประกวดราคาsanctions — เพิ่มในส่วนการตั้งค่าขั้นสูง (negative_information ) beneficiaries,shareholders,managers และemployees_data ได้เพิ่มองค์ประกอบต่อไปนี้:source_type — ประเภทของแหล่งข้อมูล (เช่นofficial,mass_media,company_admin, เป็นต้น) relations_of_persons " ได้มีการเพิ่มองค์ประกอบใหม่:match_typecapital " ได้ถูกปรับโครงสร้างใหม่:capital_amount ได้ถูกเปลี่ยนชื่อเป็นissued_capital แล้ว number_of_sharesshare_valueauthorized_capitalemployees_data ":group_figure ระบุว่าข้อมูลประกอบด้วยตัวเลขที่รวมในระดับกลุ่ม (true) หรือไม่ source_type ระบุประเภทของแหล่งข้อมูลis_estimated จะถูกรวมไว้เฉพาะเมื่อค่าของมันเป็นtrue เท่านั้น assets_data — รวมส่วนที่มีอยู่ก่อนหน้านี้:real_estate_data (เดิมชื่อproperty_data),vehicles,machinery_and_equipment (เดิมชื่อassets). patents และbiological_assets. vehicles " ได้เพิ่มฟิลด์ใหม่:valuelitigations " ได้มีการเพิ่มองค์ประกอบต่อไปนี้:content,instance,process,authorityfinancial_statement/positions และsummary/latest_turnovers ได้มีการเพิ่มองค์ประกอบใหม่:value_origin — อธิบายแหล่งที่มาของค่า; ตัวอย่างเช่น ค่าestimated -ค่านี้เป็นการประมาณและคำนวณจากข้อมูลที่มีอยู่โดยใช้ตรรกะหรือปัญญาประดิษฐ์branches_data " ได้เพิ่มฟิลด์ต่อไปนี้:registration_numberdirector_nameหมายเหตุ:อาจมีการปรับปรุงและปรับเปลี่ยนเล็กน้อยเกิดขึ้นในระหว่างขั้นตอนการทำให้เสถียร
เว็บฮุค (Webhook) คือวิธีการที่แอปพลิเคชันหนึ่งสามารถส่งข้อมูลแบบเรียลไทม์ไปยังแอปพลิเคชันอื่น ๆ ได้ ฟีเจอร์เว็บฮุคของเราใช้การเรียกกลับ HTTP (HTTP callbacks) ที่กำหนดค่าด้วย URL โดยจะมีการส่งข้อมูลในรูปแบบ JSON ผ่าน HTTP POST ไปยัง URL ดังกล่าวทุกครั้งที่มีเหตุการณ์ที่กำหนดเกิดขึ้น ในบริบทของโครงการของเรา เราได้ออกแบบฟังก์ชันเว็บฮุคให้สามารถกระตุ้นเหตุการณ์เฉพาะเจาะจงได้
เพื่อตั้งค่าเว็บฮุคสำหรับแอปพลิเคชันของคุณ ให้ไปที่หน้าการตั้งค่าแอปพลิเคชัน และค้นหาส่วน 'การตั้งค่าเว็บฮุค' จากนั้นให้ข้อมูลต่อไปนี้:
หลังจากให้รายละเอียดเหล่านี้แล้ว ให้คลิกที่ 'บันทึก'
เมื่อเกิดเหตุการณ์ขึ้น เราจะส่งคำขอ HTTP POST ไปยัง URL ของ payload พร้อมกับข้อมูลในตัว JSON ที่มีข้อมูลเกี่ยวกับเหตุการณ์นั้น
สิ่งสำคัญคือต้องตรวจสอบว่าคำขอ POST ที่ส่งไปยัง URL ของ payload มาจากแอปพลิเคชันของเรา เพื่อช่วยในเรื่องนี้ คำขอ webhook ทุกครั้งจะมีส่วนหัว X-Signature รวมอยู่ด้วย
สำหรับการลงนาม เราใช้ HMAC ร่วมกับอัลกอริทึม SHA512
Secretคือการเชื่อมต่อของApp IDและSecret Keyจากตั้งค่า webhooks
สามารถเพิ่มพารามิเตอร์ get ของคุณเองที่ส่วนท้ายของเอนด์พอยต์เพื่อระบุผู้ส่งได้หากจำเป็น
เซิร์ฟเวอร์ต้องตอบกลับภายใน 10 วินาทีและส่งคืนรหัส HTTP 2XX มิฉะนั้น การส่งเว็บฮุกจะถือว่าล้มเหลว ในกรณีที่ล้มเหลว ฟีเจอร์จะพยายามส่งคำขอใหม่อีกครั้งตามนโยบายการส่งมอบ