mobilişim api nasıl kullanılır

bu döküman www.toplusms.tc tarafından hazırlanmıştır.

kendi geliştirdiğimiz sms paneline mobilişim entegrasyonu yapmamız gerekti. bize bir api verdiler.
xml, json, soap1.1 ve soap1.2 yöntemleriyle api kullanılabiliyor. biz xml kullanmayı tercih ettik.
dökümandaki yönergeleri aynen izledim fakat bir türlü sms gönderimini başaramadım. ekomesajın
sitesinden örnek php kodlarını indirip onları da denedik ama bir türlü başaramadık. mobilişim teknik
desteği aradım. saolsun yardımcı oldular. oradaki dökümanın eski olduğunu, ekomesaj sitesinden indirilen
php örnek kodun da eski olduğunu sms gönderimi için bize yardımcı olacağını söyledi. uzak masaüstü 
bağlantısı yaparak nasıl sms göndereceğimizi gösterdi. şimdi biz de bu bilgileri siz değerli kullanıcılarımızla
paylaşmak amacıyla bu dökümanı hazırlıyoruz. umarım birgün mobilişim kendi dökümanlarını günceller
ve bayilerin entegrasyon süreci kısalır.

sms gönderimi:

yöntem: POST
url: http://gw.mobilisim.com/api/xml/syncreply/Submit

headerlar:
Content-Type: application/xml

payload:
<Submit xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.maradit.net/api/types">
  <Credential>
    <Password>BURAYA ŞİFRE GELECEK. USERNAME YAZMAYIN. NORMALDE USERNAME BAŞTA OLUR AMA MOBİLİŞİMİN DÖKÜMANINI
    HAZIRLAYAN ARKADAŞ PASSWORD BİLGİSİNİ ÜSTE KOYMUŞ. BİZ YANLIŞLIKLA BURAYA USERNAME BİLGİSİNİ YAZDIK.
    BU HATA İNSANIN GÖZÜNDEN KAÇABİLEN BİR HATA. PASSWORD BİLGİSİNİN ÜSTTE YAZILDIĞINI İLK KEZ GÖRÜYORUZ.</Password>
    <Username>BURAYA USERNAME BİLGİSİ GELECEK</Username>
  </Credential>
  <DataCoding>BURAYA Default VEYA TurkishSingleShift YAZILACAK. MOBİLİŞİM İNGİLİZCE, TÜRKÇE SİNGLE SHİFT
  VEYA UCS2 KARAKTER SETİNİ KULLANARAK SMS GÖNDERMEKTEDİR. Default YAZIP MESAJ KISMINA TÜRKÇE KARAKTER VEYA
  ÖZEL KARAKTER YAZARSANIZ ONLAR TEK DEĞİL İKİ KARAKTER OLARAK SAYILIR.</DataCoding>
  <Header>
    <From>BURAYA BAŞLIK VEYA 850 NUMARA YAZILIR</From>
    <Route>0</Route>
    <ScheduledDeliveryTime i:nil="true"></ScheduledDeliveryTime>
    <ValidityPeriod>1440</ValidityPeriod>
  </Header>
  <Message>bu örnek bir mesajdır</Message>
  <To xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>905551112233</d2p1:string>
    <d2p1:string>905321112233</d2p1:string>
  </To>
</Submit>

dönen sonuç:
<?xml version="1.0" encoding="utf-8" ?>
<SubmitResponsexmlns:i="http://www.w3.org/2001/XMLSchema-instance"xmlns="http://schemas.maradit.net/api/types">
  <Response>
    <MessageId>buraya en az 10 haneli bir sayı gelir. iletim raporlarını sorgulamak için bu numara gerekli</MessageId>
    <Status>
      <Code>200</Code>
      <Description>OK</Description>
    </Status>
  </Response>
</SubmitResponse>

-----------------------------------------------------------
RAPOR SORGULAMA
yöntem: POST
url: http://gw.mobilisim.com/api/xml/reply/Query

headerlar:
Content-Type: application/xml

payload:
<Query xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.maradit.net/api/types">
  <Credential>
    <Password>ŞİFRE BURAYA</Password>
    <Username>USERNAME BURAYA</Username>
  </Credential>
  <MessageId>1089250608</MessageId>
</Query>

result:
<?xml version="1.0" encoding="utf-8"?>
<QueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.maradit.net/api/types">
<Response>
    <ReportDetail>
        <List>
            <ReportDetailItem>
                <Payload>bu örnek bir mesajdir B050</Payload>
                <Xser/>
                <Cost>1.0000</Cost>
                <ErrorCode>0</ErrorCode>
                <Id>25452421170</Id>
                <LastUpdated>0001-01-01T00:00:00</LastUpdated>
                <MSISDN>905374937766</MSISDN>
                <MessageId>1089250608</MessageId>
                <Network>1086</Network>
                <Sequence>0</Sequence>
                <State>Scheduled veya Delivered olarak gelir burası</State>
                <Submitted>2019-08-23T22:06:56.573Z</Submitted>
            </ReportDetailItem>
        </List>
    </ReportDetail>
    <Status>
        <Code>200</Code>
        <Description>OK</Description>
    </Status>
</Response>
</QueryResponse>

buradaki her etiket hangi tür veriye işaret ettiğini belli ediyor. sadece şu konuya dikkatinizi çekmek isteriz.
Network etiketine gelen değerler şu şekildedir: 1085 avea, 1086 turkcell, 1087 vodafone.

State etiketine de Scheduled gelirse gönderim için hazırlandı, Delivered iletildi anlamındadır. diğer
tüm veriler mesajın iletilmediğine işaret eder.

örnek kod paylaşımı yapmıyoruz. işinde uzman bir programcı bu yönergeleri izleyerek entegrasyonu kolayca yapabilir.
biz sadece mobilişimin hatalı dökümanıyla vakit kaybedilmesinin önüne geçmek için doğru olan yöntemi yazdık.
hatalarımız olduysa affola. herkese iyi günler dileriz.

www.toplusms.tc
www.nixarsoft.com