Kan Ver Hayat Ver API hizmetini kullanabilmek için Api-Secret-Key header bilgisinin her API çağrısında gönderilmesi gerekir.
curl --location --request GET 'https://api.kanverhayatver.org/check_device/1' \
--header 'Api-Secret-Key: 1111'
Kullanıcı uygulamayı indirdiğinde /check_device/{device_id} bağlantısına device_id
gönderilerek eğer daha önce kayıt olmuşsa kullanıcıya ilişkin detaylı bilgiler json formatında cevap olarak döndürülür.
{
"status": 1,
"data": [
{
"id": "1",
"user_id": "1",
"device_id": "1",
"province": "1",
"district": "1",
"neighborhood": "1",
"latitude": "1",
"longitude": "1"
}
]
}Yeni kullanıcı kaydı oluşturmak için /register/{device_id} bağlantısına kullanıcının doldurduğu bilgileri göndermeniz gerekir.
| blood_type | Kan Grubu | blood_type | Kan Grubu |
|---|---|---|---|
| 1 | A Rh+ | 2 | A Rh- |
| 3 | B Rh+ | 4 | B Rh- |
| 5 | AB Rh+ | 6 | AB Rh- |
| 7 | O Rh+ | 8 | O Rh- |
curl --location --request POST 'https://api.kanverhayatver.org/register/3' \
--header 'Api-Secret-Key: 1111' \
--form 'identity_number=12427827548' \
--form 'name=sercan' \
--form 'surname=arga' \
--form 'blood_type=2' \
--form 'phone_number=5071773757' \
--form 'device_agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.135 Safari/537.36' \
{
"status": 1,
"msg": "User created"
}{
"status": 0,
"msg": "User already exists"
}{
"errorInfo": [
"23000",
1048,
"Column 'identity_number' cannot be null"
]
}Yeni kullanıcı kaydı oluşturulduktan sonra kullanıcının konum bilgileri /register_details/{device_id} bağlantısına gönderilmelidir.
curl --location --request POST 'https://api.kanverhayatver.org/register_details/15' \
--header 'Api-Secret-Key: 1111' \
--form 'province=İstanbul' \
--form 'district=Şişli' \
--form 'neighborhood=Yayla Sok.' \
--form 'latitude=41.0550272' \
--form 'longitude=28.9538047999999997'
{
"status": 1,
"msg": "Update sucessful"
}{
"status": 0,
"msg": "User not exists"
}Kullanıcının profil resmini güncellemek isterseniz update_photo/{user_id} bağlantısını kullanmalısınız.
Kabul edilen formatlar: PNG, JPG, JPEG
curl --location --request POST 'https://api.kanverhayatver.org/update_photo/1' \
--header 'Api-Secret-Key: 1111' \
--form 'photo=@/C:/Users/PC/Desktop/dosya_adi.jpg'
{
"status": 1,
"data": "https://kanverhayatver.org/api/user_photos/a887d751730d43ce948a42306fe0af1d4cf616f24b607d06a435fa27819b5203.jpg"
}{
"status": 0,
"msg": "User not exists"
}Kullanıcının profil resmini çekmek için get_photo/{user_id} bağlantısını kullanmalısınız.
curl --location --request GET 'https://api.kanverhayatver.org/get_photo/1' \
--header 'Api-Secret-Key: 1111' \
{
"status": 1,
"data": "https://kanverhayatver.org/api/user_photos/a887d751730d43ce948a42306fe0af1d4cf616f24b607d06a435fa27819b5203.jpg"
}{
"status": 0,
"msg": "User not exists"
}Kullanıcı bağış yaptığında bunu kaydetmek için /donate_register/{user_id} bağlantısı kullanılmalıdır.
curl --location --request POST 'https://api.kanverhayatver.org/donate_register/3' \
--header 'Api-Secret-Key: 1111' \
--form 'donation_value=20' \
--form 'invoice_number=1111'
{
"status": 1,
"msg": "Donation created"
}{
"status": 0,
"msg": "User not exists"
}Son 50 bağışın listelenmesi için /last_donations bağlantısına istek göndermelisiniz.
curl --location --request GET 'http://api.kanverhayatver.org/last_donations' \
--header 'Api-Secret-Key: 1111'
{
"status": 1,
"data": [
{
"user_id": "1",
"donation_value": "120.00",
"date": "2020-09-05 18:55:32",
"user_data": {
"name": "asdasdas",
"surname": "asdasdas",
"blood_type": "0",
"phone_number": "111111",
"device_agent": "",
"status": "1"
}
},
{
"user_id": "3",
"donation_value": "80.00",
"date": "2020-09-05 18:55:21",
"user_data": {
"name": "sercann",
"surname": "argaaa",
"blood_type": "0",
"phone_number": "2147483647",
"device_agent": "",
"status": "1"
}
},
{
"user_id": "3",
"donation_value": "40.00",
"date": "2020-09-05 18:55:16",
"user_data": {
"name": "sercann",
"surname": "argaaa",
"blood_type": "0",
"phone_number": "2147483647",
"device_agent": "",
"status": "1"
}
},
{
"user_id": "2",
"donation_value": "40.00",
"date": "2020-09-05 18:55:11",
"user_data": {
"name": "sercann",
"surname": "argaaa",
"blood_type": "0",
"phone_number": "2147483647",
"device_agent": "",
"status": "1"
}
},
{
"user_id": "1",
"donation_value": "20.00",
"date": "2020-09-05 13:53:34",
"user_data": {
"name": "asdasdas",
"surname": "asdasdas",
"blood_type": "0",
"phone_number": "111111",
"device_agent": "",
"status": "1"
}
}
]
}Kullanıcı kan talebi oluşturmak isterse bunu /donation_request/{user_id} bağlantısı kullanarak yapmalısınız.
curl --location --request POST 'https://api.kanverhayatver.org/donation_request/1' \
--header 'Api-Secret-Key: 1111' \
--form 'blood_type=2' \
--form 'location=Konum' \
--form 'hospital=Hastane Adı'
{
"status": 1,
"msg": "Donation request created"
}{
"status": 0,
"msg": "User not exists"
}En fazla bağış yapan ve en fazla kan bağışı yapan kişileri listelemek için /donation_request/{list}/{count} bağlantısını kullanmanız gerekir.
{list} değeri blood veya money olabilir. {count} için en büyük değer 200 olabilir.
curl --location --request GET 'https://api.kanverhayatver.org/top/blood/25' \
--header 'Api-Secret-Key: 1111' \
{
"status": 1,
"data": [
{
"user_id": "1",
"request_count": "3",
"date": "2020-09-14 19:40:00",
"user_data": {
"name": "asdasdas",
"surname": "asdasdas",
"blood_type": "0",
"phone_number": "111111",
"device_agent": "",
"status": "1"
}
},
{
"user_id": "2",
"request_count": "1",
"date": "2020-09-14 19:41:27",
"user_data": {
"name": "sercann",
"surname": "argaaa",
"blood_type": "0",
"phone_number": "2147483647",
"device_agent": "",
"status": "1"
}
}
]
}