PUT veya DELETE den farklı olarak yapılan bir kaynağa gönderilen POST isteğinin sonucu, herhangi bir istek URI deki kaynağa yapılan değişiklikler sunucuda yeni bir kaynak oluşturabilir. Yanıt kodu 201 veya sonucu farklı bir URI ile tanımlanayabilirsiniz. Yanıt kodu 303. Bu durumda müşterinin bir temsili olmayacak ve şartlı yerel olarak depolanan üstbilgiler dahil. Bu tür POST isteklerini yapmak için bağlantıların nasıl kullanılacağını gösterir. POST istekleri koşullu veya yanıtsız hale getirmek için bu tarifi uygulayabiliriz.
Müşteri tarafından sunulması için POST u sunucunun yinelemeleri algılayabileceği ve önleyebileceği şekilde uygulamak istiyoruz.
İstemcilerin her POST isteği için bir bağlantı aracılığıyla sunucu tarafından sağlanan tek seferlik bir URI oluşturmak için bir jeton içerir. POST isteğinin yalnızca bir kullanım için geçerli olan sunucu. Kullanılan tüm jetonları bir sunucu işlem günlüğünde saklanır.
İstemci bir POST isteği gönderdiğinde jetonun işlemde mevcut olup olmadığını doğrulayın. Varsa yanıt kodu 403 döndürün. Neden bodyde olduğunu açıklayın. Eğer mevcut değilse dönme isteğine 201 oluşturun yada 303 ile bağlı olarak işlemi sonuçlandırın. Ayrıca belirteci işlem günlüğünde saklayın.
Sunucunun belirli bir miktar transfer etmesi gereken banka havalesi uygulaması olduğunu düşünelim. Bir hesaptan diğer bir hesaba para aktarımı. Sunucu bir denetleyici kaynağı kullanarak bu transferi uygulayın.
# Request
POST /transfers> İki banka hesabının kaynağına müşteri mevcut durum olduğunu düşündüğü şeye dayanarak bir POST isteği gönderir.
Host: example.org
Content-Type: application/xml;charset=UTF-8
<transfer>
<source>urn:example:org:account:1</source>
<target>urn:example:org:account:2</target>
<currency>USD</currency>
<amount>100.00</amount>
<note>Testing transfer</note>
</transfer>
# Response
HTTP/1.1 201 Created> Sunucu istemcinin isteğini şuanki duruma dayanıp dayanmadığını hesap kaynalarına göre doğurlayamıyor.
Content-Type: application/xml;charset=UTF-8
Location: http://www.example.org/transactions/1
Content-Location: http://www.example.org/transactions/1
<transfer xmlns:atom="http://www.w3.org/2005/Atom">
<source>urn:example:org:account:1</source>
<target>urn:example:org:account:2</target>
<atom:link href="http://www.example.org/transactions/1" rel="self"/>
<currency>USD</currency>
<amount>100.00</amount>
<note>Testing transfer</note>
</transfer>
Bu örnekte; http://www.example.org/trans tarafından tanımlanan kaynak ters bir denetçi kaynağıdır. Bu örnekteki POST isteğinin sonucu şu şekildedir. iki hesap kaynağının değiştirilmesi ve yeni bir kaynağın oluşturulaması. Bunu yapmak için istek koşulu olarak; sunucu değerin bir işlev olarak belirteç kullanması gerekir. iki hesap kaynağının mevcut durumu bulabilmek için. Sunucu aşağıdaki yaratılan URI kullanabilir.
http://www.example.org/transfers;t=e6e3c89d4dfe7f3a818734a6237ccfc5
Değiştirilmesi istenen iki kaynaktan; http://www.example.org/transfers aksine bu URI bir işlev olarak bir belirteç içerir. İstemci bir aktarım talebinde bulunmak için URI kullanabilir. Sunucu, URI deki belirtecin hala şuanki duruma karşılıl geldiğini doğrulayabilir. Bir hesap aktarımı oluşturmaya devam etmeden önce hesap kaynaklarını doğrulamak gerekir.
# Request
POST /transfer;t=e6e3c89d4dfe7f3a818734a6237ccfc5 HTTP/1.1 > İstemci geçerli veriyi temel alan bir URI ile koşullu bir POST isteği gönderir. Ancak bu gönderim sadece iki banka hesabı kaynağı olduğu sürece.
Host: example.org
Content-Type: application/xml;charset=UTF-8
<transfer>
<source>urn:example:org:account:1</source>
<target>urn:example:org:account:2</target>
<currency>USD</currency>
<amount>100.00</amount>
<note>Testing transfer</note>
</transfer>
# Response
HTTP/1.1 201 Created > Sunucu, istemcinin isteğinin şuanki durumuna dayanıp dayanmadığının kontrolünü yapması ve hesap kaynaklarınında kontrolünün yapması sonrasında.
Content-Type: application/xml;charset=UTF-8
Location: http://www.example.org/transactions/1
Content-Location: http://www.example.org/transactions/1
<transfer xmlns:atom="http://www.w3.org/2005/Atom">
<source>urn:example:org:account:1</source>
<target>urn:example:org:account:2</target>
<atom:link href="http://www.example.org/transactions/1" rel="self"/>
<currency>USD</currency>
<amount>100.00</amount>
<note>Testing transfer</note>
</transfer>
Sunucudaki, jetonun sunucunun işlem günlüğü.
# Request
POST /transfer;t=e6e3c89d4dfe7f3a818734a6237ccfc5 HTTP/1.1 > İstemci koşullu bir POST isteği gönderir.
Host: example.org
Content-Type: application/xml;charset=UTF-8
<transfer>
<source>urn:example:org:account:1</source>
<target>urn:example:org:account:2</target>
<currency>USD</currency>
<amount>100.00</amount>
<note>Testing transfer</note>
</transfer>
# Response
HTTP/1.1 403 Forbidden > Sunucu bir çakışma algıdı.
Content-Type: application/xml;charset=UTF-8
Date: Sat, 17 Oct 2019 20:16:18 GMT
<error xmlns:atom="http://www.w3.org/2005/Atom">
<message xml:lang="en">Transfer already created.</message>
</error>
Bu sefer, sunucu, belirtecin önceden kaydedilmiş olup olmadığını görmek için işlem günlüğünü kontrol eder. Kullanılmış kopya oluşturmak yerine 403 döndürür. Bu teknikte POST tam olarak bir kez çağrıldı.
Hiç yorum yok:
Yorum Gönder