---
title: "تأیید کد و ذخیره‌ی اتصال"
method: POST
path: "/v1/connections/{platform}/verify"
tags: ["connections"]
---

# تأیید کد و ذخیره‌ی اتصال

`POST /v1/connections/{platform}/verify`

## Request

- Base URL: `https://barchin.net/api`
- URL: `https://barchin.net/api/v1/connections/{platform}/verify`
- Auth: HTTP bearer

کد پیامک‌شده را به سایت می‌دهد، توکن ورود را رمزگذاری‌شده ذخیره می‌کند و اتصال را برمی‌گرداند. هر challenge حداکثر ۵ تلاش و ۳ دقیقه اعتبار دارد؛ کد نادرست در details.remaining_attempts می‌گوید چند تلاش مانده. اتصال قبلیِ همان سایت (اگر باشد) جایگزین می‌شود.

## Path parameters

- `platform` string, required: شناسه‌ی سایت: divar (باما بعداً).

## Request body

- ConnectionVerifyIn
  - `challenge_id` string, uuid, required: شناسه‌ای که از پاسخ start گرفته‌اید.
  - `code` string, required: کدی که سایت پیامک کرده است (۴ تا ۸ رقم؛ ارقام فارسی هم پذیرفته می‌شود).

## Response `200`

Successful Response

- ConnectionOut
  - `platform` string, required
  - `platform_title` string, required: نام فارسی سایت («دیوار»).
  - `phone_number` string, required: شماره‌ی ماسک‌شده‌ی حسابِ وصل‌شده.
  - `status` 'active' | 'expired' | 'revoked', required: active: قابل استفاده؛ expired: سایت توکن را رد کرده، دوباره وارد شوید؛ revoked: خودتان قطع کرده‌اید.
  - `verified_at` string, date-time, required
  - `last_used_at` string, date-time, nullable, required
  - `last_error` string, nullable, required: کد کوتاه دلیل انقضا، اگر باشد.
  - `reveals_total` integer, required: شماره‌هایی که تا حالا با این حساب نمایش داده شده‌اند.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/barchin/apis/barchin-scraping-api.md) · [All operations](https://skmtc.dev/barchin/apis/barchin-scraping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/barchin/apis/barchin-scraping-api/revisions/fe97e4690cc3?raw)