Genel Bakış
NosyAPI İsimler Sözlüğü API dökümantasyonuna hoşgeldiniz.
Bu dökümantasyonda isimlerin anlamını, kökenini, cinsiyetini, kuranda geçip geçmediği gibi bilgilere ulaşabileceksiniz.
İçindekiler
- API Token Bilgileri
- İsim Detayları Listeleme - İstek
- İsim Detayları Listeleme Örnek Kodlar
- İsim Detayları Listeleme - Yanıt
- İsimleri Listeleme - İstek
- İsimleri Listeleme Örnek Kodlar
- İsimleri Listeleme - Yanıt
API Token Bilgileri
İlgili API kullanımı için token bilgisine gerekmektedir. Bu token bilgisi ile istediğiniz bilgileri çekebilirsiniz. Her üyemize otomatik olarak tanımlamalar gerçekleşir. Token bilginizi menüde yer alan API Bilgilerim bölümünden alabilirsiniz.
İsim Detayını Öğrenme
İsimler Sözlüğü API kullanımı için slug değerine ihtiyaç duymaktayız. Bu değere yukarı API'yı kullanarak erişebilirsiniz.
İstek |
---|
GET - https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer |
Alan | Veri Tipi | Zorunluluk | Açıklama |
---|---|---|---|
name | İsmin slug bilgisini içerir. (Örn Şeyda ismi için seyda bilgisi gerekmektedir. Bu bilgiler yukarıdaki api endpoint adresinde bildirilir.) | string |
Zorunlu |
Örnek Kodlar |
---|
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"Content-Type: application/json",
"Authorization: Bearer API_KEY"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --request GET 'https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY'
var data = new FormData();
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Authorization", "Bearer API_KEY");
xhr.send(data);
var client = new RestClient("https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer API_KEY");
request.AlwaysMultipartFormData = true;
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer")
.header("Content-Type", "application/json")
.header("Authorization", "Bearer API_KEY")
.multiPartContent() .asString();
import http.client
import mimetypes
conn = http.client.HTTPSConnection("www.nosyapi.com")
boundary = ''
payload = ''
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer API_KEY',
'Content-type': 'multipart/form-data; boundary={}'.format(boundary)
}
conn.request("GET", "/apiv2/names/getNameMeaning?name=cafer", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
import Foundation
var semaphore = DispatchSemaphore (value: 0)
let parameters = [
] as [[String : Any]]
let boundary = "Boundary-\(UUID().uuidString)"
var body = ""
var error: Error? = nil
for param in parameters {
if param["disabled"] == nil {
let paramName = param["key"]!
body += "--\(boundary)\r\n"
body += "Content-Disposition:form-data; name=\"\(paramName)\""
let paramType = param["type"] as! String
if paramType == "text" {
let paramValue = param["value"] as! String
body += "\r\n\r\n\(paramValue)\r\n"
} else {
let paramSrc = param["src"] as! String
let fileData = try NSData(contentsOfFile:paramSrc, options:[]) as Data
let fileContent = String(data: fileData, encoding: .utf8)!
body += "; filename=\"\(paramSrc)\"\r\n"
+ "Content-Type: \"content-type header\"\r\n\r\n\(fileContent)\r\n"
}
}
}
body += "--\(boundary)--\r\n";
let postData = body.data(using: .utf8)
var request = URLRequest(url: URL(string: "https://www.nosyapi.com/apiv2/names/getNameMeaning?name=cafer")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("Bearer API_KEY", forHTTPHeaderField: "Authorization")
request.addValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
request.httpMethod = "GET"
request.httpBody = postData
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
return
}
print(String(data: data, encoding: .utf8)!)
semaphore.signal()
}
task.resume()
semaphore.wait()
Diğer programlama dilleri için lütfen info@nosyapi.com adresine mail atınız.
Not: API_TOKEN yazan yerleri kendi token bilginizle değiştirmeyi unutmayınız.
Yanıt |
---|
{
"status": "success",
"message": "ok",
"rowCount": 1,
"data": [
{
"firstLetter": "C",
"name": "Cafer",
"slug": "cafer",
"meaning": "Küçük akarsı. Çay. Cafer b. Muhammed: Lakabı es-Sadık olup 12 imamın 6.'ncısıdır. Muhammed b. el-Bakır'ın yerine imamete geçmiştir. Cafer-i Tayyar: Hz. Alinin kardeşi olup, Mute savaşında bayrak tutarken iki elini de kaybederek şehid olmuştur. Bugün Mute civarında kabri bulunmaktadır",
"gender": "Male",
"origin": "Arapça",
"kuran": false,
"q1": null,
"q2": null,
"q3": null
}
]
}
Alan | Açıklama | Veri Tipi |
---|---|---|
status | İşlem sonucu olarak geri dönmektedir. ok ve failure olarak döner | string |
message | Hata durumunda hata sebebini döndürür. | string |
rowCount | İşlem sonucunda gelen verilerin sayısını bildirmektedir. | int |
systemTime | İşlem sırasında bulunulan tarih saati unix timestamp tipinde verir. | long |
firstLetter | Gelen ismin baş harfini bildirir. | string |
name | İsim bilgisini bildirir. | string |
slug | Detayını öğrenmek için kullanacağımız istekte göndermek üzere slug bilgisini verir. | string |
meaning | İsmin anlamını bildirir. | string |
gender | İsmin hangi cinsiyete ait olduğunu bildirir. | string |
origin | İsmin kökenini bildirir. | string |
kuran | İsmin kuranda geçip/geçmediğini bildirir. True/false şeklinde değer döndürür. | boolean |
İsimleri Listeleme
İstek |
---|
GET - https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a |
Alan | Açıklama | Veri Tipi | Zorunluluk |
---|---|---|---|
firstletter | İsim listesini görmek istediğiniz harf bilgisi. (Örn: a) | string |
Örnek Kodlar |
---|
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"Content-Type: application/json",
"Authorization: Bearer API_TOKEN"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --request GET 'https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_TOKEN'
var data = new FormData();
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Authorization", "Bearer API_TOKEN");
xhr.send(data);
var client = new RestClient("https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer API_TOKEN");
request.AlwaysMultipartFormData = true;
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a")
.header("Content-Type", "application/json")
.header("Authorization", "Bearer API_TOKEN")
.multiPartContent() .asString();
import http.client
import mimetypes
conn = http.client.HTTPSConnection("www.nosyapi.com")
boundary = ''
payload = ''
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer API_TOKEN',
'Content-type': 'multipart/form-data; boundary={}'.format(boundary)
}
conn.request("GET", "/apiv2/names/getNameList?firstletter=a", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
import Foundation
var semaphore = DispatchSemaphore (value: 0)
let parameters = [
] as [[String : Any]]
let boundary = "Boundary-\(UUID().uuidString)"
var body = ""
var error: Error? = nil
for param in parameters {
if param["disabled"] == nil {
let paramName = param["key"]!
body += "--\(boundary)\r\n"
body += "Content-Disposition:form-data; name=\"\(paramName)\""
let paramType = param["type"] as! String
if paramType == "text" {
let paramValue = param["value"] as! String
body += "\r\n\r\n\(paramValue)\r\n"
} else {
let paramSrc = param["src"] as! String
let fileData = try NSData(contentsOfFile:paramSrc, options:[]) as Data
let fileContent = String(data: fileData, encoding: .utf8)!
body += "; filename=\"\(paramSrc)\"\r\n"
+ "Content-Type: \"content-type header\"\r\n\r\n\(fileContent)\r\n"
}
}
}
body += "--\(boundary)--\r\n";
let postData = body.data(using: .utf8)
var request = URLRequest(url: URL(string: "https://www.nosyapi.com/apiv2/names/getNameList?firstletter=a")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("Bearer API_KEY", forHTTPHeaderField: "Authorization")
request.addValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
request.httpMethod = "GET"
request.httpBody = postData
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
return
}
print(String(data: data, encoding: .utf8)!)
semaphore.signal()
}
task.resume()
semaphore.wait()
Diğer programlama dilleri için lütfen info@nosyapi.com adresine mail atınız.
Not: API_TOKEN yazan yerleri kendi token bilginizle değiştirmeyi unutmayınız.
Yanıt ve Tipleri |
---|
{
"status": "success",
"message": "ok",
"rowCount": 760,
"data": [
{
"firstLetter": "A",
"name": "Alperen",
"slug": "alperen"
},
{
"firstLetter": "A",
"name": "Ayşe",
"slug": "ayse"
}
Alan | Açıklama | Veri Tipi |
---|---|---|
status | İşlem sonucu olarak geri dönmektedir. ok ve failure olarak döner | string |
message | Hata durumunda hata sebebini döndürür. | string |
rowCount | İşlem sonucunda gelen verilerin sayısını bildirmektedir. | int |
systemTime | İşlem sırasında bulunulan tarih saati unix timestamp tipinde verir. | long |
firstLetter | Gelen ismin baş harfini bildirir. | string |
name | İsim bilgisini bildirir. | string |
slug | Detayını öğrenmek için kullanacağımız istekte göndermek üzere slug bilgisini verir. | string |
Etiketler: isimler sözlüğü api,isim anlami api,isim ve anlamları,kuranda geçiyor mu isim
Önemli Not: Lise ve üniversite öğrencileri ticari amaç dışında kullanımlarında öğrenci belgelerini göndermek şartıyla ücretsiz, yüksek kredi ve geniş zaman tanımlaması yapılacaktır.
İsimler Sözlüğü API PHP & Postman Dosyası
NosyAPI İsimler Sözlüğü API postman dosyasını aşağıdan indirebilirsiniz.
İlgili postman dosyasını import ettikten sonra API_TOKEN yazan yeri kendi API Token değeriniz ile değiştirmeyi unutmayınız.