Turkcell Servis Geliştirme Yeteneklerini kullanmak isteyen tüm uygulamalar öncelikle kimlik doğrulaması yapmalıdır. Kimlik doğrulamada servis sağlayıc

Turkcell Servis Geliştirme Yeteneklerini kullanmak isteyen tüm uygulamalar öncelikle kimlik doğrulaması yapmalıdır. Kimlik doğrulamada servis sağlayıcının kullanıcı ismi, parolası ve uygulama kimliği kullanılır. Başarılı kimlik doğrulama yapılırsa createSession servisi uygulamaya bir oturum numarası (sessionId) verir. Diğer servisleri (SMS gönderme, MMS gönderme, sorgulama, vb.) kullanmak için bu oturum numarası kullanılmalıdır. Oturum numarası (sessionId) belirli bir sürenin sonunda geçerliliğini yitirecektir. Yeni bir servis çağırılacağı zaman oturum numarası gönderilmezse veya geçerli olmayan bir oturum numarası gönderilirse "Client.Authentication" SOAP hata mesajı dönülür. Bu hata alındığı zaman uygulama yeniden createSession ile bir oturum oluşturmalı ve bundan sonra yapacağı servis çağrılarında bu yeni oturum numarasını kullanmalıdır.

Turkcell Test Platformundaki servisleri çağırmak için kullanılması gereken URL'leri aşağıdaki tabloda bulabilirsiniz.

İstek

Parametre Veri Tipi Zorunlu mu ?(E/H) Açıklama Örnek
spUserName Dize E Kullanıcı adı yazarbozar
password Dize E Parolası S++uJs12
serviceVariantId Tamsayı E Uygulamayı işaret eden uygulama numarası 12345678

Cevap

Parametre Veri Tipi Zorunlu mu ?(E/H) Açıklama Örnek
sessionId Dize E Oturum numarası, kimlik doğrulama başarısız olursa boş(NULL) döner "A1sdf3Lj345"

Hata durumunda, SoapFault dönülür

Örnek SOAP Mesajı

İstek:

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:mrns0="urn:SPGW" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
	<soap:Body>
		<mrns0:createSession>
			<spId>320923879</spId>
			<serviceVariantId>3209238791</serviceVariantId>
			<password>pass1</password>
		</mrns0:createSession>
	</soap:Body>
</soap:Envelope>

Cevap:

Kimlik doğrulama başarılı olduğunda:

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Body>
		<createSessionResponse xmlns="urn:SPGW">
			<sessionId xmlns="">spgw6758939237278746624</sessionId>
		</createSessionResponse>
	</soapenv:Body>
</soapenv:Envelope>

Kimlik doğrulama başarısız olduğunda:

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Body>
		<createSessionResponse xmlns="urn:SPGW">
			<sessionId xmlns="" nil="true"/>
		</createSessionResponse>
	</soapenv:Body>
</soapenv:Envelope>

Bir sonraki makalemiz sırasıyla;Konum belirleme, SMS Gönderme, MMS Gönderme, Mobil Ödeme, Model Sorgusu şeklinde Turkcell in API lerini incelemeye devam edeceğiz.

İyi çalışmalar.

 

İlgili Makaleler

Bu yazıya 0 yorum yapılmış.

Yorum Gönder