HitHorizons
HitHorizons, doğrudan Microsoft ürünlerinizde 60 ülkeden 75M+ Avrupalı şirketin verileriyle çalışmanızı sağlar. Size pazarın, bireysel şirketlerin ve zaman içindeki evrimlerinin daha eksiksiz ve karmaşık bir resmini sunmak için çeşitli kaynaklardan alınan şirket verileriyle yazılımınızı zenginleştirin.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | HitHorizons desteği |
| URL | https://www.hithorizons.com/services/api |
| E-posta | support@hithorizons.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | FinStat, s. r. o. |
| Web sitesi | https://www.hithorizons.com/ |
| Gizlilik ilkesi | https://www.hithorizons.com/legal/privacy-policy |
| Kategoriler | İş Zekası; Satış ve CRM |
HitHorizons bağlayıcısı, Avrupa şirketlerinin HitHorizons veritabanını Microsoft ürünlerinizle tümleştirmenize olanak tanır. 60 ülkede 75 milyondan fazla şirketten oluşan bir veritabanında arama yapmanızı ve şirket verilerini çözümünüzde kullanmanızı sağlar.
Önkoşullar
Devam etmek için aşağıdakilere ihtiyacınız olacaktır:
- HitHorizons aboneliği.
- HitHorizons API anahtarı.
Kimlik bilgilerini alma
HitHorizons tarafından sağlanan hizmet aralığını görüntülemek ve HitHorizons aboneliği satın almak için lütfen ziyaret edin https://www.hithorizons.com/services .
Bağlayıcınızı kullanmaya başlama
- Bir şirketi ada ve konuma göre aramak için eylem Company-Search kullanın.
- Temel kayıt verileri, analizli satış bilgileri ve analiz ile çalışan numarası bilgileri dahil olmak üzere şirket bilgilerini almak için eylem Company-Get kullanın.
Bilinen sorunlar ve sınırlamalar
API istekleri için bir hız sınırı vardır. Dakikada en fazla 30 istek oranına izin verilir. Bu sınır aşıldıktan sonra 429 Çok Fazla İstek yanıtı döndürülür.
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| API Anahtarı | securestring | Bu API için API Anahtarı | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Yapılandırılmamış sorgu kullanan şirketleri arama |
Yapılandırılmamış sorgu kullanan şirketleri arayın. |
| Yapılandırılmış sorgu kullanarak şirket arama |
Yapılandırılmış sorgu kullanarak şirketleri arayın. |
| Şirket ayrıntı verilerini kimlik bilgilerine göre alma |
HitHorizonsId tarafından belirtilen şirketin verilerini alın. |
Yapılandırılmamış sorgu kullanan şirketleri arama
Yapılandırılmamış sorgu kullanan şirketleri arayın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Şirket kimliklerinde aranacak değer: HitHorizonsId, DUNSNumber ve NationalId
|
Ids | string |
Bu alandaki tüm kullanılabilir kimlikler aranacak: HitHorizons Kimliği, DUNS Numarası ve Ulusal Kimlik. Boşlukla ayrılmış olarak birden çok değer sağlanabilir. |
|
|
Şirket adlarında ve şirket kimliklerinde aranacak değer
|
Name | string |
Şirket adı ve ikincil ad bu değer için aranacak. Ayrıca, NationalId aranacaktır. Biçim HitHorizonsId'ye karşılık geliyorsa (H-ile başlar), HitHorizonsId aranacaktır. Bu alan, kullanıcı kolaylığı için adları ve kimlikleri kullanarak geniş kapsamlı arama için kullanılabilir. |
|
|
Şirket adresinde aranacak değer
|
Address | string |
Şirket adresi bu değer için aranacak. Tüm adres alanları aranacak (sokak adresi, posta kodu, şehir, eyalet/il). Bu alanda ülke adı bulunduğunda, sonuçlar yalnızca belirli bir ülkeyle sınırlıdır. |
|
|
Sonuçlara dal kayıtlarının eklenip eklenmeyeceği
|
ShowBranches | boolean |
False (varsayılan) olduğunda, yalnızca ana ofisler ve tek konumlu şirketler alınır. Doğru olduğunda, şube ofisi olarak işaretlenmiş kayıtlar da sonuçlara eklenir. |
|
|
Sonuçlara dahil edilecek şirket türleri
|
CompanyTypes | string |
Aranacak şirket türleri dizisi. Bu değer, bir değer dizisi yerine virgülle ayrılmış bir değer listesi olarak sağlanabilir (CompanyTypes=3&CompanyTypes=13 yerine CompanyTypes=3,13) Kullanılabilir değerler için aşağıdaki kod listesine bakın: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Sağlanmadığında, varsayılan olarak şu değerler kullanılır: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Döndürülecek en fazla sonuç sayısı
|
MaxResults | integer |
Döndürülecek en fazla sonuç sayısı. Varsayılan değer 20'dir. Olası maksimum değer 100'dür. |
Döndürülenler
Yapılandırılmış sorgu kullanarak şirket arama
Yapılandırılmış sorgu kullanarak şirketleri arayın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bululacak DUNS Numarası
|
DUNSNumber | string |
Sağlanan DUNS Numarasına sahip şirket döndürülür. |
|
|
Şirket adlarında aranacak değer
|
CompanyName | string |
Şirket adı ve ikincil ad bu değer için aranacak. |
|
|
Şirket Ulusal Kimliği'nde aranacak değer
|
NationalId | string |
Bu değer için ulusal kimlik aranacak. |
|
|
Şirket adresinde aranacak değer
|
AddressUnstructured | string |
Şirket adresi bu değer için aranacak. Tüm adres alanları aranacak (sokak adresi, posta kodu, şehir, eyalet/il). Bu alanda ülke adı bulunduğunda, sonuçlar yalnızca belirli bir ülkeyle sınırlıdır. Terimlerden herhangi biri herhangi bir adres alanında bulunabilir. |
|
|
Şirket sokak adresinde aranacak değer
|
AddressStreet | string |
Şirket sokak adresi bu değer için aranacak. Tüm terimler, sokak adres satırlarından birinde bulunmalıdır. |
|
|
Şirket şehrinde aranacak değer
|
City | string |
Şirket şehri bu değer için aranacak. Tüm terimler şehir adında bulunmalıdır. |
|
|
Şirket durumunda/ilinde aranacak değer
|
StateProvince | string |
Şirket durumu/ili bu değer için aranacak. Tüm terimler eyalet/il adında bulunmalıdır. |
|
|
Aramanın sınırlandırılması için ülke
|
Country | string |
Yalnızca belirli bir ülkedeki şirketler aranacaktır. |
|
|
Sonuçlara dal kayıtlarının eklenip eklenmeyeceği
|
ShowBranches | boolean |
False (varsayılan) olduğunda, yalnızca ana ofisler ve tek konumlu şirketler alınır. Doğru olduğunda, şube ofisi olarak işaretlenmiş kayıtlar da sonuçlara eklenir. |
|
|
Sonuçlara dahil edilecek şirket türleri
|
CompanyTypes | string |
Aranacak şirket türleri dizisi. Bu değer, bir değer dizisi yerine virgülle ayrılmış bir değer listesi olarak sağlanabilir (CompanyTypes=3&CompanyTypes=13 yerine CompanyTypes=3,13) Kullanılabilir değerler için aşağıdaki kod listesine bakın: https://hithorizonsapim.portal.azure-api.net/api-docs/code-lists#companyType . Sağlanmadığında, varsayılan olarak şu değerler kullanılır: 0, 3, 10, 11, 12, 13, 14, 100, 102, 107, 120, 151, 154, 160, 167 |
|
|
Döndürülecek en fazla sonuç sayısı
|
MaxResults | integer |
Döndürülecek en fazla sonuç sayısı. Varsayılan değer 20'dir. Olası maksimum değer 100'dür. |
Döndürülenler
Şirket ayrıntı verilerini kimlik bilgilerine göre alma
HitHorizonsId tarafından belirtilen şirketin verilerini alın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Alınacak şirketin kimliği
|
HitHorizonsId | True | string |
Alınacak şirketin HitHorizons kimliği. HitHorizonsId, Company-Search veya Company-SearchUnstructured işlemleri kullanılarak şirket aranarak alınabilir. |
Döndürülenler
Tanımlar
CompanyDetailResult
| Name | Yol | Tür | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Şirket Adı
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Posta Kodu
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
NationalIdType
|
NationalIdType | string | |
|
SICText
|
SICText | string | |
|
SICCode
|
SICCode | string | |
|
Endüstri
|
Industry | string | |
|
LocalActivityCode
|
LocalActivityCode | string | |
|
LocalActivityCodeType
|
LocalActivityCodeType | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesLocal
|
SalesLocal | double | |
|
LocalCurrency
|
LocalCurrency | string | |
|
SalesAccuracyIndicator
|
SalesAccuracyIndicator | string | |
|
SalesUSD
|
SalesUSD | double | |
|
SalesEUR
|
SalesEUR | double | |
|
HitHorizonsSalesAnalysis
|
HitHorizonsSalesAnalysis | object | |
|
ÇalışanlarSayısı
|
EmployeesNumber | integer | |
|
EmployeesNumberAccuracyIndicator
|
EmployeesNumberAccuracyIndicator | string | |
|
EmployeesNumberTotal
|
EmployeesNumberTotal | integer | |
|
EmployeesNumberTotalAccuracyIndicator
|
EmployeesNumberTotalAccuracyIndicator | string | |
|
HitHorizonsEmployeesAnalysis
|
HitHorizonsEmployeesAnalysis | object | |
|
Şirket Türü
|
CompanyType | integer | |
|
LocationType
|
LocationType | integer | |
|
HitHorizonsCompanyProfileURL
|
HitHorizonsCompanyProfileURL | string |
CompanyDetailResultApiResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Hata
|
Error | string | |
|
Result
|
Result | CompanyDetailResult |
ŞirketSearchResult
| Name | Yol | Tür | Description |
|---|---|---|---|
|
HitHorizonsId
|
HitHorizonsId | string | |
|
DUNSNumber
|
DUNSNumber | string | |
|
Şirket Adı
|
CompanyName | string | |
|
CompanySecondaryName
|
CompanySecondaryName | string | |
|
AddressStreetLine1
|
AddressStreetLine1 | string | |
|
AddressStreetLine2
|
AddressStreetLine2 | string | |
|
Posta Kodu
|
PostalCode | string | |
|
City
|
City | string | |
|
StateProvince
|
StateProvince | string | |
|
Country
|
Country | string | |
|
NationalId
|
NationalId | string | |
|
Endüstri
|
Industry | string | |
|
EstablishmentOfOwnership
|
EstablishmentOfOwnership | integer | |
|
SalesEUR
|
SalesEUR | double | |
|
ÇalışanlarSayısı
|
EmployeesNumber | integer | |
|
CompanyProfileURL
|
CompanyProfileURL | string |
ŞirketSearchResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Results
|
Results | array of CompanySearchResult | |
|
ResultsCount
|
ResultsCount | integer | |
|
TotalCount
|
TotalCount | integer |
CompanySearchResponseApiResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Success
|
Success | boolean | |
|
Hata
|
Error | string | |
|
Result
|
Result | CompanySearchResponse |