Hyz API

The tool reference

طلب POST واحد لكل أداة، وكلها مولَّدة من المانيفست نفسه الذي تعمل عليه أدوات التطبيق. وتُشتق هذه الصفحة من الفهرس الحي: فالأسماء والمعاملات والأعلام لا يمكن أن تنحرف عن الخادم.

Calling a tool

عنوان الأساس نفسه، والمصادقة نفسها، والمظروف نفسه — لكل أداة.

كل أداة طلب POST واحد تحت عنوان أساس الواجهة. والمصادقة ومظروف الاستجابة موثَّقان في المرجع؛ وتضيف هذه الصفحة ما يختلف من أداة لأخرى: الحقول والسقوف والاستجابة.

POST https://haiyz.net/api/enterprise/v1/gis/buffer
X-Api-Key: haiyz_pk_live_xxxxxxxxxxxx
X-Api-Secret: haiyz_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
X-Api-User: [email protected]

كل نقطة أداة هي POST. أدوات الملفات تأخذ multipart/form-data؛ وأدوات JSON تأخذ جسم application/json.
مدخلات الملفات المتعددة تكرر حقل النموذج نفسه مرة لكل ملف. والحقول الاختيارية تأخذ قيمتها الافتراضية الموثَّقة عند إغفالها — ولا تُرسل أبدًا السلسلة الحرفية "undefined".
تقبل أدوات المتجهات امتدادات الإدخال أدناه وتنتج أيًّا من: geojson وshp وkml وgml وgpkg وfgb وkmz وparquet (وgpx للإدخال فقط).
في نموذج النقاط يكلف كل تشغيل تكلفة نقاط الأداة (افتراضيًا: نقطة واحدة للتشغيل؛ وأدوات الملفات المتعددة تحاسب لكل ملف). والتشغيلات الفاشلة لا تُحاسَب أبدًا.

.zip .shp .dbf .shx .prj .cpg .csv .tsv .xlsx .xls .geojson .json .kml .gpx .gml .gpkg .fgb .kmz .parquet

What comes back

شكلان: ملف مخزَّن، أو ناتج JSON مباشر.

الأدوات المنتجة للملفات تخزّن الناتج وتجيب بالمظروف القياسي: مفتاح التخزين، واسم ملف الناتج المقترح، ومفتاح مدخلك، وحقول ناتج كل أداة، وكتلة استخدام. وتضمّن أدوات المتجهات عدد المعالم ونظام إحداثيات الناتج ونوع الهندسة:

keyoutputFilenameinputKeyusagefeatureCountcrsgeometryType

تُجلب البايتات على حدة بالمفتاح المعاد (نقطة التنزيل في التطبيق، أو عنوان أثر التشغيل في واجهة نموذج النقاط) — وContent-Disposition يحمل اسم الملف.

أدوات JSON (تحويل الإحداثيات، والقياس، والنقطة في المضلع…) تعيد ناتجها مباشرة في data — دون ملف مخزَّن ما لم تنص الأداة على غير ذلك.

عن X-Output-Filename وX-CRS

يصدر محرك الحساب ترويسات لكل ناتج (X-Output-Filename وX-CRS وX-Feature-Count…) على القفزة الداخلية. وتترجمها الواجهة العامة إلى حقول JSON الموثَّقة هنا — فالعملاء يقرؤون الحقول لا الترويسات. أما التنزيلات الثنائية فتحمل Content-Type/Content-Disposition/Content-Length القياسية.

Engine-wide ceilings

حواجز أمان تسبق أي حد خاص بالأداة.

الرفع: 50 م.ب للملف في طبقة HTTP، على كل مسارات الأدوات (وقد تكون حدود الأداة أدناه أضيق).
مدخلات المتجهات: حتى 500,000 معلمًا في الملف؛ والملف المرفوض يجيب بـ 422 مع السبب.
الصور النقطية: حتى 40,000 بكسل للضلع و64 نطاقات.
سقوف كل أداة (صفحات، ملفات، نقاط، أبعاد) مذكورة عند كل أداة أدناه — وكل قيمة تطابق ثابتًا مسمى في المحرك.

التحويل والتحقق

3 tools

التحقق من الملفات الجغرافية وتحويلها

POST /validate-convertasync-eligible

تحقق من صحة وحوّل ملفات Shapefile وGeoJSON وKML.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:sourceCrsrepairedCountbbox

Limitsmax file 50 MB

محوّل نظام الإحداثيات CRS

POST /transform-crs/json

حوّل الإحداثيات بين أنظمة الإسناد المختلفة.

Field	Type	Required	Details
`source_crs`	string	yes
`target_crs`	string	yes
`points`	array	yes	an array of { x, y } coordinate objects

POST /transform-crs/csvmetered

Field	Type	Required
`file`	file	yes
`source_crs`	string	yes
`target_crs`	string	yes

ReturnstransformedPoints

Limitsmax 1,000 points

مسار JSON غير محتسب؛ ومسار CSV محتسب. ويعرض الفهرس toolKey محتسبًا لأن مسار الملف كذلك.

محوّل الإحداثيات

POST /convert-coordinatesunmetered

حوّل خط الطول/العرض بين الدرجات العشرية (DD) والدرجات-الدقائق-الثواني (DMS) والدرجات-الدقائق العشرية (DDM).

Field	Type	Required	Details
`from_format`	string	yes	dd \| dms \| ddm
`points`	array	yes	مصفوفة كائنات ‎{ lon, lat }‎

ReturnsfromFormatresults

Limitsmax 1,000 points

استخراج البيانات

1 tools

مستخرج EXIF

POST /extract-exifasync-eligible

استخرج بيانات GPS من صور JPEG وأنشئ خريطة GeoJSON.

Field	Type	Required	Details
`files`	file	yes	كرر الحقل مرة لكل ملف

ReturnsimagesinputKeysgeotaggedCounttotalCountgeojsonOutput

Limitsmax 10 imagesmax file 20 MB

الأشكال الهندسية

11 tools

تحويل خط إلى مضلّع

POST /line-to-polygon

حوّل سلسلة إحداثيات إلى مضلّع مغلق واحسب المساحة الجيوديسية والمحيط وإحصائيات الشكل.

Field	Type	Required	Details
`coordinates`	array	yes	مصفوفة أزواج ‎[lon, lat]‎ — ثلاثة على الأقل

POST /line-to-polygon/filemetered

Field	Type	Required	Details
`file`	file	yes

ReturnskeyinputKeystatsusage

Limitsmax 10,000 points

أداة تبسيط الأشكال

POST /simplifyasync-eligible

قلّل عدد رؤوس الملف الجغرافي باستخدام خوارزمية دوغلاس–بيوكر للتبسيط.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`tolerance`التفاوت (بالدرجات)	number	optional	min 0.000001 · default 0.001
`preserve_topology`الحفاظ على الطوبولوجيا (تجنّب التقاطعات الذاتية)	boolean	optional	default true

Returnsاستجابة الملف القياسية، وفوقها:verticesBeforeverticesAfter

Limitsmax file 50 MB

المُغلَّف المحدّب

POST /convex-hullasync-eligible

احسب أصغر مضلّع محدّب يحيط بجميع الأشكال الهندسية في ملف جغرافي.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCounthullVertices

Limitsmax file 50 MB

المراكز

POST /centroidsasync-eligible

استبدل كل معلم بنقطة مركزه — حوّل المضلّعات أو الخطوط إلى طبقة نقاط.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`method`موضع النقطة	string	optional	centroid \| inside · default centroid

Returnsاستجابة الملف القياسية، وفوقها:inputGeometryType

Limitsmax file 50 MB

مولّد النطاق العازل

POST /bufferasync-eligible

أنشئ نطاقات عازلة حول النقاط أو الخطوط أو المضلّعات — بمسافة ثابتة بالأمتار، محسوبة في نطاق UTM المحلي.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`distance_m`مسافة النطاق العازل (بالأمتار)	number	optional	min 1 · default 100
`dissolve`دمج النطاقات المتداخلة في شكل واحد	boolean	optional	default false
`cap_style`شكل أطراف النطاق العازل	string	optional	round \| flat \| square · default round

Returnsاستجابة الملف القياسية، وفوقها:dissolveddistanceM

Limitsmax file 50 MBmax distance 100 km

يجوز أن يكون distance_m سالبًا لتقليص المضلعات؛ والصفر مرفوض.

الدمج حسب الحقل

POST /dissolveasync-eligible

ادمج المعالم التي تشترك في قيمة عمود واحد في شكل هندسي واحد، مع إمكانية حساب العدد أو المجموع أو المتوسط أو الأدنى أو الأعلى لحقل آخر.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`by`التجميع حسب عمود	string	optional	اسم عمود يُقرأ من `file`
`agg`الدالة التجميعية	string	optional	count \| sum \| mean \| min \| max · default count
`agg_field`عمود التجميع	string	optional	اسم عمود يُقرأ من `file`

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountgroupsgroupField

Limitsmax file 50 MB

القص

POST /clipasync-eligible

اقتطع الطبقة وفق طبقة حدود، مع الإبقاء على الأجزاء الواقعة داخلها فقط.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`mask`حدود القص (مضلّعات)	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountdroppedCount

Limitsmax file 50 MB

تفكيك المعالم المركّبة

POST /explodeasync-eligible

فكّك المعالم المركّبة إلى معلم مستقل لكل جزء، بحيث يقع كل مضلّع أو خط في صف خاص به.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountmultipartCountpartsCreated

Limitsmax file 50 MB

إصلاح الأشكال الهندسية

POST /repairasync-eligible

أصلح الأشكال الهندسية غير الصالحة — التقاطعات الذاتية والحلقات غير المغلقة والأشكال الفارغة — ليُفتح الملف دون أخطاء في أي نظام معلومات جغرافية.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountinvalidBeforeinvalidAfterdroppedCount

Limitsmax file 50 MB

المُغلَّف المقعّر

POST /concave-hullasync-eligible

احسب مُغلَّفًا يتبع الشكل الحقيقي لسحابة النقاط بدقة أعلى من المُغلَّف المحدّب، بضبط نسبة الإحكام.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`ratio`درجة الإحكام	number	optional	min 0.05 · max 1 · default 0.3

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountratiohullVertices

Limitsmax file 50 MB

مولّد الشبكة

POST /gridasync-eligible

أنشئ شبكة منتظمة من الخلايا المربّعة تغطي نطاق الطبقة، بحجم خلية تحدّده بالأمتار.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`cell_size_m`حجم الخلية (بالأمتار)	number	optional	min 1 · default 1000
`clip_to_extent`قصّ الشبكة على حدود البيانات	boolean	optional	default false

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountrowscolscellSizeM

Limitsmax file 50 MBحجم خلية حتى 5,000,000 م

القياس

3 tools

المسافة والاتجاه

POST /distance-bearingunmetered

احسب المسافة الجيوديسية والاتجاه الأمامي/الخلفي بين سلسلة من النقاط.

Field	Type	Required	Details
`points`	array	yes	مصفوفة كائنات ‎{ lon, lat }‎ — اثنان على الأقل

Returnssegmentstotal_distance_mtotal_distance_kmstraight_distance_mstraight_distance_kmis_closedpoint_countsegment_count

Limitsmax 1,000 points

فاحص النقاط داخل المضلّع

POST /point-in-polygonunmetered

تحقق مما إذا كانت النقاط تقع داخل المضلّع أو خارجه أو على حدوده، مع المسافة الجيوديسية إلى أقرب حافة.

Field	Type	Required	Details
`polygon`	array	yes	مصفوفة أزواج ‎[lon, lat]‎ — ثلاثة على الأقل
`points`	array	yes	مصفوفة كائنات ‎{ lon, lat }‎

Returnsresultsinside_countoutside_countboundary_countpoint_count

Limitsmax 1,000 points

المساحة والطول

POST /area-lengthasync-eligible

احسب المساحة والمحيط أو الطول لكل معلم حسابًا جيوديسيًا — بدقة على المجسم الأرضي لا بتقريب مستوٍ.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCounttotalAreaM2totalLengthMmeasuredAreasmeasuredLengths

Limitsmax file 50 MB

الدمج

2 tools

أداة دمج الملفات الجغرافية

POST /mergeasync-eligible

ادمج من 2 إلى 5 ملفات جغرافية (shapefile أو GeoJSON أو KML) في طبقة واحدة بنظام إحداثيات موحّد — مع وسم كل معلم بملفه المصدر.

Field	Type	Required	Details
`files`الملفات المراد دمجها (2–5)	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) · 2–5 files
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet

Returnsاستجابة الملف القياسية، وفوقها:fileCount

Limitsmin 2 filesmax 5 filesmax file 50 MB

الربط المكاني

POST /spatial-joinrequires plusasync-eligible

اربط خصائص طبقة بأخرى وفق العلاقة المكانية — التقاطع أو الاحتواء الداخلي أو الاحتواء أو العبور أو التماس أو التداخل.

Field	Type	Required	Details
`file`الملف المُدخَل	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`join`الطبقة المصدر للربط	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`predicate`العلاقة المكانية	string	optional	intersects \| within \| contains \| crosses \| touches \| overlaps · default intersects
`how`الإبقاء على المعالم غير المطابِقة	string	optional	inner \| left · default inner

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountjoinFeatureCountmatchedCountpredicate

Limitsmax file 50 MB

الصور النقطية

3 tools

فاحص وعارض الملفات النقطية (Raster)

POST /raster-inspectasync-eligible

ارفع ملف GeoTIFF/DEM لمعرفة نظام إحداثياته وحدوده ودقته وإحصائيات كل نطاق (band)، مع معاينة سريعة.

Field	Type	Required	Details
`file`	file	yes

ReturnsinputKeypreviewKeypreviewPngB64crswidthheightbandCountresolutionboundsbandsusage

Limitsmax file 50 MB

أداة التحقق من COG وتحسينه

POST /cog-optimizeasync-eligible

ارفع ملف GeoTIFF للتحقق مما إذا كان بصيغة Cloud-Optimized GeoTIFF (مقسّم ومزوّد بمستويات مصغّرة) وتنزيل نسخة محسّنة منه.

Field	Type	Required	Details
`file`الملف الشبكي (GeoTIFF)	file	yes	GeoTIFF (بامتداد ‎.tif أو ‎.tiff أو ‎.geotiff)

Returnsاستجابة الملف القياسية، وفوقها:wasAlreadyCogissueswidthheightbandCountoriginalTiledoriginalOverviewCountoriginalCompressionoptimizedOverviewCountoptimizedCompression

Limitsmax file 50 MB

إحصاءات المناطق

POST /zonal-statsrequires plusasync-eligible

لخّص قيم الراستر داخل كل منطقة مضلّعة — المتوسط والأدنى والأعلى والمجموع والعدد لكل معلم.

Field	Type	Required	Details
`file`مضلّعات المناطق	file	yes	بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه)
`raster`الملف الشبكي (GeoTIFF)	file	yes	GeoTIFF (بامتداد ‎.tif أو ‎.tiff أو ‎.geotiff)
`target_format`صيغة الإخراج	string	yes	geojson \| shp \| kml \| gml \| gpkg \| fgb \| kmz \| parquet
`band`النطاق الشبكي	number	optional	min 1 · default 1
`stats`الإحصاءات	string	yes

Returnsاستجابة الملف القياسية، وفوقها:inputFeatureCountzoneszonesWithDatabandstats

Limitsmax file 50 MBmax 2,000 zones

أدوات الصور

5 tools

إزالة الخلفية

POST /remove-background

أزل خلفية الصورة تلقائيًا، مباشرة من متصفحك.

Field	Type	Required	Details
`file`الصورة	file	yes	PNG وJPEG وWebP وBMP

Returnsاستجابة الملف القياسية، وفوقها:

Limitsmax file 20 MBحتى 6,000 بكسل للجهة

تحسين جودة الصورة

POST /enhance-quality

حسّن الصورة وأعد ترميزها لنتيجة أوضح — أعضاء Plus يحصلون على الدقة الكاملة وجودة أعلى وتكبير اختياري 2×.

Field	Type	Required	Details
`file`الصورة	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF
`upscale`تكبير 2×	boolean	optional	default false

تحويل صيغة الصورة

POST /convert-format

حوّل صورة بين PNG وJPG وWebP وBMP وTIFF وGIF.

Field	Type	Required	Details
`file`الصورة	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF
`target_format`الصيغة المستهدفة	string	optional	png \| jpeg \| webp \| bmp \| tiff \| gif · default png

علامة مائية على صورة

POST /image-watermark

أضف علامة مائية نصية أو شعارًا إلى صورة أو تصميم.

Field	Type	Required	Details
`file`الصورة	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF
`wm_mode`نوع العلامة المائية	string	optional	text \| image · default text
`text`نص العلامة المائية	string	yes
`logo`الصورة المراد ختمها	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF
`position`الموضع	string	optional	diagonal \| center \| top-left \| top-right \| bottom-left \| bottom-right · default bottom-right
`opacity`الشفافية	number	optional	min 0.05 · max 1 · default 0.4

Returnsاستجابة الملف القياسية، وفوقها:

Limitsmax file 20 MBmax logo 5 MBحتى 8,000 بكسل للجهةmax 80 characters

قدّم واحدًا فقط من text أو logo — والمحرك يرفض كليهما معًا أو غيابهما معًا.

دمج الصور

POST /merge-images

اجمع عدة صور في صورة واحدة — عموديًا أو أفقيًا أو كشبكة.

Field	Type	Required	Details
`files`الصور	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF · 2–12 files
`layout`التخطيط	string	optional	vertical \| horizontal \| grid · default vertical

Returnsاستجابة الملف القياسية، وفوقها:fileCountwidthheight

Limitsmin 2 filesmax 12 filesmax file 20 MBحتى 8,000 بكسل للجهة

أدوات المستندات

11 tools

استخراج النص من الصورة (OCR)

POST /ocr

استخرج النص من صورة أو مستند ممسوح ضوئيًا — يدعم العربية والإنجليزية أو كليهما معًا.

Field	Type	Required	Details
`file`	file	yes
`lang`	string	optional	eng \| ara \| eng+ara · default eng

ReturnskeyinputKeytextlangcharCountusage

Limitsmax file 20 MBحتى 8,000 بكسل للجهة

تحويل PDF إلى Word

POST /pdf-to-word

حوّل نص وتنسيق ملف PDF إلى مستند Word قابل للتحرير.

Field	Type	Required	Details
`file`ملف PDF	file	yes	PDF

Returnsاستجابة الملف القياسية، وفوقها:

Limitsmax file 30 MBmax 200 pages

توقيع مستند

POST /document-sign

ضع توقيعك على ملف PDF — ارسمه أو ارفعه أو استخدم توقيعاً محفوظاً.

Field	Type	Required	Details
`file`	file	yes
`signature`	file	yes	PNG only
`placements`	json-string	yes	سلسلة JSON: مصفوفة صناديق ‎{ page, x, y, w, h }‎ بكسور الصفحة (0–1)

Returnsاستجابة الملف القياسية، وفوقها:

Limitsmax file 30 MBmax signature 512 KBmax 200 pagesmax 250 placements

هذه الأداة تطبع صورة توقيع في الصفحات — وليست توقيعًا رقميًا موثَّقًا.

دمج PDF

POST /merge-pdf

ادمج حتى 20 ملف PDF في مستند واحد بالترتيب الذي تختاره.

Field	Type	Required	Details
`files`ملفات PDF (2–20)	file	yes	PDF · 2–20 files

Returnsاستجابة الملف القياسية، وفوقها:fileCountpageCount

Limitsmin 2 filesmax 20 filesmax file 30 MBحتى 500 صفحة في الملفحتى 1,500 صفحة إجمالًا

تقسيم PDF

POST /split-pdf

استخرج صفحات أو نطاقات صفحات من ملف PDF — جزءًا واحدًا أو عدة أجزاء.

Field	Type	Required	Details
`file`ملف PDF	file	yes	PDF
`ranges`الصفحات المطلوب استخراجها	string	yes

Returnsاستجابة الملف القياسية، وفوقها:partCount

Limitsmax file 30 MBmax 1,000 pagesmax 50 ranges

النطاق الواحد يعيد PDF؛ وعدة نطاقات تعيد ZIP (والاسم الحقيقي في outputFilename).

ضغط PDF

POST /compress-pdf

قلّل حجم ملف PDF عبر إعادة ترميز الصور وتنظيف بنية الملف.

Field	Type	Required	Details
`file`ملف PDF	file	yes	PDF
`quality`الجودة	string	optional	screen \| ebook \| print · default ebook

Returnsاستجابة الملف القياسية، وفوقها:pageCountoriginalBytescompressedBytesalreadyOptimized

Limitsmax file 50 MBmax 1,000 pages

تحويل PDF إلى صور

POST /pdf-to-images

حوّل كل صفحة من ملف PDF إلى صورة PNG عالية الجودة.

Field	Type	Required	Details
`file`ملف PDF	file	yes	PDF
`dpi`الدقة (DPI)	string	optional	72 \| 150 \| 300 · default 150

Returnsاستجابة الملف القياسية، وفوقها:pageCount

Limitsmax file 30 MBmax 100 pages

تعيد دائمًا ملف ZIP من صور الصفحات.

علامة مائية على PDF

POST /pdf-watermark

أضف نصًا أو شعارًا على كل صفحة من ملف PDF.

Field	Type	Required	Details
`file`ملف PDF	file	yes	PDF
`wm_mode`نوع العلامة المائية	string	optional	text \| image · default text
`text`نص العلامة المائية	string	yes
`logo`الصورة المراد ختمها	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF
`position`الموضع	string	optional	diagonal \| center \| top-left \| top-right \| bottom-left \| bottom-right · default diagonal
`opacity`الشفافية	number	optional	min 0.05 · max 1 · default 0.15

Returnsاستجابة الملف القياسية، وفوقها:pageCount

Limitsmax file 30 MBmax 500 pagesmax logo 5 MBmax 80 characters

قدّم واحدًا فقط من text أو logo — والمحرك يرفض كليهما معًا أو غيابهما معًا.

تحويل الصور إلى PDF

POST /images-to-pdf

حوّل الصور والمستندات الممسوحة إلى ملف PDF واحد، صورة في كل صفحة.

Field	Type	Required	Details
`files`الصور	file	yes	PNG وJPEG وWebP وBMP وTIFF وGIF · 1–20 files
`page_mode`حجم الصفحة	string	optional	a4 \| fit · default a4

Returnsاستجابة الملف القياسية، وفوقها:pageCountfileCount

Limitsmin 1 filesmax 20 filesmax file 20 MBحتى 8,000 بكسل للجهة

تعبئة نموذج PDF

POST /fill-pdf

اكتب في حقول نموذج PDF نفسها ونزّل المستند المعبّأ.

Field	Type	Required	Details
`file`	file	yes
`values`	json-string	yes	سلسلة JSON: كائن من اسم حقل AcroForm ← القيمة (حتى حد قيم النموذج)
`flatten`	string	optional	true \| false · default false

Returnsاستجابة الملف القياسية، وفوقها:fieldCountfilledCountflattened

Limitsmax file 30 MBmax 500 pagesحتى 500 قيمة نموذج

تدوير الصفحات وحذفها

POST /rotate-pages

صحّح اتجاه الصفحات واحذف غير المرغوب منها مباشرة على المصغّرات.

Field	Type	Required	Details
`file`	file	yes
`operations`	json-string	yes	سلسلة JSON: ‎{ "rotations": { "<page>": 90\|180\|270 }, "delete": [pages] }‎ — الصفحات تبدأ من 0؛ وعملية واحدة على الأقل

Returnsاستجابة الملف القياسية، وفوقها:pageCountrotatedCountdeletedCount

Limitsmax file 30 MBmax 100 pages

أدوات مدمجة (عبر الواجهة فقط)

في المانيفست، لا في الفهرس.

أداتان بلا صفحة مستقلة ولا تظهران في الفهرس المتصفَّح — تُستدعيان من داخل أسطح أخرى، وعبر الواجهة. وهما مقيّدتان ومحتسبتان كسائر الأدوات.

تصدير مساحة العمل

POST /workspace-exportrequires freeembedded

تحويل الطبقات الظاهرة في مساحة العمل إلى Shapefile أو KML أو CSV.

Field	Type	Required	Details
`file`	file	yes	طبقة مساحة العمل بصيغة GeoJSON
`target_format`	string	yes	shp \| kml \| csv \| geojson
`base_name`	string	optional

ReturnsfeatureCounttruncatedFields

Limitsmax file 50 MB

تصدير الخرائط

POST /map-exportenterprise workspaces onlyembedded

إنشاء لوحة خريطة جاهزة للطباعة تتضمن عنواناً ومفتاحاً وسهم الشمال.

Field	Type	Required	Details
`image`	file	yes	كرر الحقل مرة لكل ملفلقطة PNG واحدة لكل كتلة خريطة، مكررة
`logo`	file	optional
`spec`	json-string	yes	سلسلة JSON تصف الورقة: الصفحة (a4\|a3\|letter) والاتجاه والعنوان وعناصر مفتاح الخريطة والإسناد ووسم نظام الإحداثيات وغيرها

Limitsmax capture 25 MBmax logo 2 MBحتى 64 عنصر مفتاح خريطة