1ms.tools
APIs

Domain Connect Link API

Submit Domain Connect configuration, parameters and signing material to validate a flow and generate a signed apply link.

Beta1 credit per successful task10 external calls / minute / account
Get an API keyTry the online toolAPI docs

Integration use cases

Use it when your application already has a Domain Connect service configuration. Provide your service identifiers, parameters and signing material; handle private keys only in trusted server environments.

Request example

Replace the example key with one created in your console. The input demonstrates integration; consult the API documentation for all fields and validation rules.

POST /openapi/tools/domain-connect-link/execute
curl 'https://1ms.tools/openapi/tools/domain-connect-link/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"domain":"example.com","host":"@","providerId":"provider","serviceId":"website","syncUxUrl":"https://provider.example.com","keyName":"my-key","privateKey":"YOUR_PRIVATE_KEY_PEM","redirectUri":"https://example.com","params":[{"key":"ip","value":"192.0.2.1"}]}'
Asynchronous response and result retrieval

An accepted request returns HTTP 202 and job metadata. The job has not completed yet; this example shows commonly used fields.

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "queued",
    "result": null,
    "creditCost": 1,
    "pollAfterMs": 6000,
    "statusUrl": "/openapi/jobs/JOB_ID"
  }
}

Wait at least six seconds before polling with the same key. Read result on succeeded, or error on failed or canceled.

curl 'https://1ms.tools/openapi/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Generating a link does not change DNS. The user must complete authorization and apply the configuration with a supported provider. This API is currently in beta.

API integration questions

Use Authorization: Bearer YOUR_API_KEY or X-API-Key. External endpoints require a valid key; browser cookies cannot replace it. Keep keys on a server or in a trusted application environment.

Creating a job reserves 1 credit, finalized on success. Invalid input or insufficient credits creates no job; failure, timeout or cancellation of a queued job refunds the reservation. Polling costs no credits but counts toward the rate limit.

This endpoint uses asynchronous jobs, returning HTTP 202 and a job ID first. Poll the returned statusUrl and read result on success. Use Idempotency-Key for submission retries.

Each account can make 10 external business requests per calendar minute, shared by all keys and counted separately from web requests. Polling, uploads and execution all count; respect Retry-After on HTTP 429.