# Рефералы
# Параметры <span id="parameters" />

| HTTP- метод | Права доступа                                                                                                 | URL                                    | Параметры         | Примечание                                                 |
| ----------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ----------------- | ---------------------------------------------------------- |
| GET         | [referrals](/article/ru/308#referrals)    | https://api.admitad.com/referrals/     | offset\*\*        | Возвращает список рефералов\*                              |
|             |                                                                                                               |                                        | limit\*\*         |                                                            |
|             |                                                                                                               |                                        | date\_start\*\*\* |                                                            |
|             |                                                                                                               |                                        | date\_end\*\*\*   |                                                            |
| GET         | [referrals](/article/ru/308#referrals) | https://api.admitad.com/referrals/{id} |                   | Возвращает реферала, где id — это идентификатор реферала\* |

\* Возвращает результат в формате JSON.

\*\* Задаёт пропуск и количество возвращаемых записей. Например [limit\=5\&offset\=2](/article/ru/310).

\*\*\* Фильтр по датам. Например: date\_start\=01.01.2011\&date\_end\=01.01.2012. Значения для дат должны быть в формате '%d.%m.%Y' - '01.05.2012'.

# Пример использования <span id="example-of-use" />

Пример запроса с использованием утилиты curl:

```
curl -L -H 'Authorization: Bearer access_token' -X GET  
https://api.admitad.com/referrals/  

curl -L -H 'Authorization: Bearer access_token' -X GET  
https://api.admitad.com/referrals/8/
```

Пример ответа API-сервера в формате JSON:

```
{  
    "results": [  
        {  
            "username": "qweasdqwe",  
            "id": 8,  
            "payment": null  
        },  
        {  
            "username": "webmaster1_ref1",  
            "id": 6,  
            "payment": null  
        }  
    ],  

    "_meta": {  
        "count": 2,  
        "limit": 20,  
        "offset": 0  
    }  
}
```

# Описание полей ответа API-сервера <span id="description-of-api-server-response-fields" />

| Название | Описание               |
| -------- | ---------------------- |
| id       | Идентификатор реферала |
| username | Логин реферала         |
| payment  | Сумма                  |