connections

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

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

post/v1/connections/{platform}/verify

Request

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

Path parameters

platformstring required

شناسه‌ی سایت: divar (باما بعداً).

Example:divar

Request body

challenge_idstring uuid required

شناسه‌ای که از پاسخ start گرفته‌اید.

codestring required

کدی که سایت پیامک کرده است (۴ تا ۸ رقم؛ ارقام فارسی هم پذیرفته می‌شود).

Example request

{
  "code": "482913"
}

Response

Successful Response

platformstring required
platform_titlestring required

نام فارسی سایت («دیوار»).

phone_numberstring required

شماره‌ی ماسک‌شده‌ی حسابِ وصل‌شده.

status'active' | 'expired' | 'revoked' required

active: قابل استفاده؛ expired: سایت توکن را رد کرده، دوباره وارد شوید؛ revoked: خودتان قطع کرده‌اید.

verified_atstring date-time required
last_used_atstring date-time nullable required
last_errorstring nullable required

کد کوتاه دلیل انقضا، اگر باشد.

reveals_totalinteger required

شماره‌هایی که تا حالا با این حساب نمایش داده شده‌اند.

Changes

No recorded changes to this operation across all 1 revision of this API.