Skip to content

Customers

PUT/api/v1/musteriler

Writes customer records by dis_id. The phone is stored encrypted. Records are deleted when the retention period in company settings expires.

  • Authentication: Authorization: Bearer rz_live_…
  • Scope: ingest:customers
  • Plan feature: Data API + Carts — if off, the endpoint answers 404 not_found
  • Idempotency-Key: optional (recommended for retries)

Fields marked * are required. Unknown fields are rejected with 422.

CustomerBatch

FieldTypeLimitsMeaning
items *ApiCustomer[]min items 1, max items 10001–1000 records.

ApiCustomer

FieldTypeLimitsMeaning
dis_id *stringmin 1, max 200Customer id.
adstring | nullmax 200Name.
epostastring | nullmax 200Email.
telefonstring | nullmax 32Phone.
metaobjectdefault {}Free-form extra data.
Terminal window
curl -s -X PUT "$RZ_API/api/v1/musteriler" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
-d '{"items": [{"dis_id": "87", "ad": "Ayşe Yılmaz", "eposta": "[email protected]", "telefon": "05321234567",
"meta": {"segment": "kurumsal"}}]}'
{
"inserted": 1,
"updated": 0
}

Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.


DELETE/api/v1/musteriler/{dis_id}

Deletes the customer record. 404 not_found if it does not exist.

  • Authentication: Authorization: Bearer rz_live_…
  • Scope: ingest:customers
  • Plan feature: Data API + Carts — if off, the endpoint answers 404 not_found
  • Idempotency-Key: optional (recommended for retries)
NameInTypeLimitsMeaning
dis_id *pathstringThe id in your system.
Terminal window
curl -s -X DELETE "$RZ_API/api/v1/musteriler/87" -H "Authorization: Bearer $RZ_KEY"
{
"deleted": 1
}

Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.