# कॉन्टैक्ट्स

> कॉन्टैक्ट की जानकारी देखें और अपडेट करें

- पेज: https://tbit.app/hi/docs/api/contacts
- Base URL: `https://rest-api.tbit.app/v1`
- ऑथेंटिकेशन: हर request में आपकी key के साथ `X-API-Key` header (उदाहरण इसे `TBIT_API_KEY` environment variable से पढ़ते हैं)

## परिचय

कॉन्टैक्ट्स वे लोग हैं जो WhatsApp, Instagram और ईमेल जैसे चैनलों पर आपके एजेंट से बात करते हैं। हर कॉन्टैक्ट की एक प्रोफ़ाइल होती है जिसमें नाम, चैनल identifiers और वैकल्पिक metadata होता है।

## Endpoints

| Method | Path | विवरण |
| --- | --- | --- |
| `GET` | `/v1/contacts` | List contacts |
| `GET` | `/v1/contacts/:id` | Get contact detail |
| `POST` | `/v1/contacts` | Create a new contact |
| `PATCH` | `/v1/contacts/:id` | Update contact |

## Query parameters

लिस्ट वाला endpoint ये query parameters सपोर्ट करता है:

| Parameter | टाइप | विवरण |
| --- | --- | --- |
| `limit` | `number` | Results per page (default: 20, max: 100) |
| `offset` | `number` | Number of results to skip (default: 0) |

## कॉन्टैक्ट्स की लिस्ट

`GET /v1/contacts`

```bash
curl "https://rest-api.tbit.app/v1/contacts?limit=20&offset=0" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## कॉन्टैक्ट का विवरण पाएँ

`GET /v1/contacts/64f1a2b3c4d5e6f7a8b9c0d1`

```bash
curl "https://rest-api.tbit.app/v1/contacts/64f1a2b3c4d5e6f7a8b9c0d1" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## कॉन्टैक्ट अपडेट करें

`PATCH /v1/contacts/64f1a2b3c4d5e6f7a8b9c0d1`

```bash
curl -X PATCH "https://rest-api.tbit.app/v1/contacts/64f1a2b3c4d5e6f7a8b9c0d1" \
  -H "X-API-Key: $TBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_name": "Jane Doe",
    "email": "jane@example.com",
    "notes": "Preferred language: English"
  }'
```

## कॉन्टैक्ट बनाएँ

`POST /v1/contacts`

```bash
curl -X POST "https://rest-api.tbit.app/v1/contacts" \
  -H "X-API-Key: $TBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "573009876543",
    "channel_type": "whatsapp",
    "profile_name": "Jane Doe",
    "custom_attributes": {
      "city": "Bogota",
      "plan": "premium"
    }
  }'
```

## Response फ़ॉर्मेट

लिस्ट वाले endpoints पेज-दर-पेज (paginated) नतीजे लौटाते हैं:

```json
{
  "data": [
    {
      "id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "profile_name": "Jane Doe",
      "email": "jane@example.com",
      "notes": "Preferred language: English",
      "channels": [
        {
          "channel_id": "573001234567",
          "channel_type": "whatsapp"
        }
      ],
      "custom_attributes": {
        "city": "Bogota",
        "plan": "premium"
      },
      "created_at": "2024-09-01T12:00:00Z",
      "updated_at": "2024-09-01T14:30:00Z"
    }
  ],
  "pagination": {
    "total": 50,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}
```