1dex

Command-line client for the public and professional 1dex connector.

The CLI covers the public address overview, subscriber address details and unlocks, account usage, autocomplete, commune search, score endpoints, public previews, address-page state, and verified public map-layer / viewport / focus routes on 1dex.fr. Use overview when you want the address cards flow; details / unlock for subscriber address flows; autocomplete, communes, or score suggest for search; score for scoring and compare flows; state / preview for public page metadata; and the map commands when you need parcelles, DVF, works, IRIS, context, labels, focus, or multi-layer viewports. The bare form 1dex <address> remains the compatibility shortcut for the public address overview.

Install

npm i -g @1dex-fr/1dex
1dex overview "10 rue des cordeliers aix" --dvf-radius-m 300

Or install it in a project and run it with npx:

npm i @1dex-fr/1dex
npx 1dex overview "10 rue des cordeliers aix" --dvf-radius-m 300
npx 1dex address details "10 rue des cordeliers aix" --fields summary,rail --idempotency-key "$ONEDEX_DETAILS_REQUEST_ID" --api-key "$ONEDEX_API_KEY"
npx 1dex autocomplete "10 rue des cordeliers aix"
npx 1dex score address "10 rue des cordeliers aix" -f summary
npx 1dex parcelles "50 rue des tanneurs aix" -f summary

Usage

1dex overview "10 rue des cordeliers aix" --dvf-radius-m 300
1dex overview --city-code 13001 --parcel-record-key parcel_123 --dvf-year 2024 --url
1dex address details "10 rue des cordeliers aix" --fields summary,rail,tabs --idempotency-key "$ONEDEX_DETAILS_REQUEST_ID" --api-key "$ONEDEX_API_KEY" --max-attempts 3
1dex address unlock "10 rue des cordeliers aix" --idempotency-key "$ONEDEX_UNLOCK_REQUEST_ID" --api-key "$ONEDEX_API_KEY" --max-attempts 3
1dex address unlock --input '{"address":"10 rue des cordeliers aix","city_code":"13001"}' --idempotency-key "$ONEDEX_UNLOCK_REQUEST_ID" --api-key "$ONEDEX_API_KEY"
1dex account usage --api-key "$ONEDEX_API_KEY" -f summary
1dex autocomplete "10 rue des cordeliers aix" --limit 5
1dex communes aix --limit 5
1dex preview /ville/aix-en-provence-13001 --url
1dex score address "10 rue des cordeliers aix" -f summary
1dex score compare --input '{"items":[{"address":"10 rue des cordeliers aix"},{"address":"50 rue des tanneurs aix"}],"sortBy":"global"}'
1dex viewport "10 rue des cordeliers aix" --layers context,iris -f summary
1dex focus public-location --lon 5.446766 --lat 43.529667 -f summary
1dex parcelles "50 rue des tanneurs aix" --format summary

Auth, purchase, and detailed reads

Public commands such as overview, autocomplete, score, preview, communes, and map do not require an API key within public quotas. Complete address details and unlock flows require a 1dex API key. Free demo keys are pinned to the configured demo address; live keys use the account's subscription and activation rights. Manage keys at https://1dex.fr/compte/api and pass one with --api-key or ONEDEX_API_KEY.

Recommended subscriber flow:

1. Check live/demo usage with 1dex account usage --api-key "$ONEDEX_API_KEY" -f summary.
2. Try 1dex address details "<address>" --fields summary,rail --idempotency-key "$ONEDEX_DETAILS_REQUEST_ID" --api-key "$ONEDEX_API_KEY".
3. If the API returns address_unlock_required, run 1dex address unlock --normalized-address-key <key> --idempotency-key "$ONEDEX_UNLOCK_REQUEST_ID", or pass the returned unlock_request JSON.
4. Follow the returned URL with 1dex address details --details-url '<details_url>' --idempotency-key '<new-key>'.

Reuse a key only for retries of the exact same intention. --max-attempts retries 202, 429, and 503 with that key and respects Retry-After; 409 is terminal.

Common professional API errors:

• invalid_api_key: the API key is missing, invalid, or revoked.
• api_subscription_required: the account needs an active subscription.
• api_professional_required: the endpoint requires a professional plan.
• address_unlock_required: the detailed address must be unlocked before reading.
• insufficient_credits: the account has no remaining address credits for the requested unlock.

1dex overview calls https://1dex.fr/api/v1/address-overview and prints the public address overview payload. It accepts the live public location parameters (address, city_code, lon/lat, parcel_record_key, dvf_radius_m, dvf_year); the bare 1dex <address> form keeps the same overview route for backwards compatibility. details, unlock, and usage remain aliases of the canonical address details, address unlock, and account usage commands. They use API keys from --api-key or ONEDEX_API_KEY. When using --normalized-address-key, pass it alone; do not combine it with address text, --parcel-record-key, or --lon/--lat. usage understands V1 and account-usage-v2. autocomplete, communes, preview, state, viewport, focus, and score * target the canonical /api/v1 routes. The map-layer commands call https://1dex.fr/api/v1/map-layer/{layer} and print JSON, CSV, or a short summary.

1dex overview "10 rue des cordeliers aix" --dvf-radius-m 300
1dex "10 rue des cordeliers aix"
1dex address details "10 rue des cordeliers aix" --fields summary,rail --idempotency-key "$ONEDEX_DETAILS_REQUEST_ID"
1dex autocomplete "10 rue des cordeliers aix" --url
1dex communes aix --url
1dex state "10-rue-de-la-paix-paris-75002"
1dex score grid --bbox 5.4457,43.5274,5.4468,43.5282 --zoom 15 --category global
1dex parcelles "50 rue des tanneurs aix" --format csv
1dex parcelles "50 rue des tanneurs aix" --url

Run 1dex examples for copy-paste commands and 1dex doctor to verify that the public endpoint answers from your machine.

Options

1dex <address> [options]
1dex overview <address|--city-code|--lon/--lat|--parcel-record-key> [options]
1dex address details <address|--normalized-address-key|--parcel-record-key|--lon/--lat|--details-url> --idempotency-key <key> [options]
1dex address unlock <address|--normalized-address-key|--parcel-record-key|--lon/--lat|--input> --idempotency-key <key> [options]
1dex account usage [options]
1dex autocomplete <query> [options]
1dex communes <query> [options]
1dex preview <path> [options]
1dex state <slug>
1dex parcelles <address> [options]
1dex dvf <address> [options]
1dex travaux <address> [options]
1dex iris <address> [options]
1dex labels <address> [options]
1dex layer <layer> <address|--lon/--lat> [options]
1dex viewport <address|--lon/--lat> [options]
1dex focus parcelle <record-key> [options]
1dex focus parcelles <record-keys> [options]
1dex focus address <address> [options]
1dex focus public-location --lon <number> --lat <number> [options]
1dex focus feature --layer-key <layer> --feature-key <key> [options]
1dex score address <address> [options]
1dex score compare [--input <json-or-@file>] [options]
1dex score grid --bbox <bbox> --zoom <number> [options]
1dex score suggest <query> [options]
1dex examples
1dex doctor [--address <address>] [options]

Set ONEDEX_BASE_URL only if you need to target another compatible environment. Set ONEDEX_API_KEY for subscriber endpoints when you do not pass --api-key. Set ONEDEX_IDEMPOTENCY_KEY only for the current logical details or unlock intention when you do not pass --idempotency-key. Set ONEDEX_NO_UPDATE_CHECK=1 to disable the npm update notice in automated environments.