REST GET API için önerilen tarih biçimi

Bunun gibi bir REST GET API'si için önerilen zaman damgası biçimi nedir:

http://api.example.com/start_date/{timestamp}

Bence gerçek tarih biçimi, YYYY-MM-DDThh:mm:ssZUTC saati gibi ISO 8601 biçimi olmalıdır .

ISO 8601 sürümünü tire ve iki nokta üst üste olmadan kullanmalı mıyız, örneğin:

http://api.example.com/start_date/YYYYMMDDThhmmssZ

yoksa ISO 8601 formatını, örneğin base64 kodlamasını kullanarak kodlamalı mıyız?

REST, önerilen bir tarih biçimine sahip değil. Gerçekten de son kullanıcınız ve sisteminiz için en iyi olana indirgeniyor. Kişisel olarak, ISO 8601 (url kodlu) için sahip olduğunuz gibi bir standarda bağlı kalmak isterim.

Çirkin URI husustur sahip değilse (örn url kodlanmış sürümü dahil değil :, -, sende URI) ve (insan) adreslenebilirliği önemli olarak, ayrıca dönem süresini (örn düşünebiliriz değil http://example.com/start/1331162374). URL biraz daha temiz görünüyor, ancak okunabilirliği kesinlikle kaybediyorsunuz.

/2012/03/07Eğer çok görmek başka biçimidir. Sanırım bunu genişletebilirsin. Bu rotaya giderseniz, ya her zaman GMT saatinde olduğunuzdan emin olun (ve bunu belgelerinizde netleştirin) ya da bir tür saat dilimi göstergesi eklemek isteyebilirsiniz.

Sonuçta, API'niz ve son kullanıcınız için neyin işe yaradığına bağlıdır. API'niz sizin için değil, sizin için çalışmalıdır ;-).

API tarih ve saatlerinin 5 yasası için bu makaleyi BURADAN kontrol edin :

• Yasa 1: Tarihleriniz için ISO-8601 kullanın
• Kural # 2: Herhangi bir saat dilimini kabul edin
• Yasa # 3: UTC'de saklayın
• Yasa # 4: UTC'de iade edin
• Kanun # 5: İhtiyacınız yoksa zamanı kullanmayın

Dokümanlarda daha fazla bilgi.

RFC6690 - Kısıtlı dinlendirici Ortamları (çekirdek) Bağlantı Biçimi açıkça Ancak ne olması gerektiğini Tarih biçimi halini yok mu bölüm 2. Bağlantı Format yap Bu tarih türü için o öneri ima RFC 3986. işaret RFC 3986 kullanılmalıdır.

Temel olarak RFC 3339 İnternetteki Tarih ve Saat, bakılması gereken bir belgedir ve şunları söyler:

Miladi takvimi kullanarak tarihlerin ve saatlerin gösterimi için ISO 8601 standardının bir profili olan İnternet protokollerinde kullanım için tarih ve saat formatı.

bunun kaynağı: YYYY-AA-ggTHH: mm: ss.ss ± hh: mm

(örneğin, 1937-01-01T12: 00: 27.87 + 00: 20)

En güvenli bahis.

Girdi / çıktıdaki her tarih saat alanının UNIX / epoch biçiminde olması gerekir. Bu, API'nin farklı taraflarındaki geliştiriciler arasındaki karışıklığı önler.

Artıları:

• Epoch formatının bir saat dilimi yoktur.
• Epoch'un tek bir formatı vardır (Unix zamanı tek imzalı bir sayıdır).
• Dönem zamanı, yaz saatinden etkilenmez.
• Arka uç çerçevelerinin çoğu ve tüm yerel ios / android API'ler, çağ dönüşümünü destekler.
• Yerel zaman dönüştürme kısmı, kullanıcının cihazının / tarayıcısının saat dilimi ayarına bağlı olarak tamamen uygulama tarafında yapılabilir.

Eksileri:

• Veritabanında UTC biçiminde depolamak için UTC'ye dönüştürmek için ekstra işlem.
• Giriş / çıkışın okunabilirliği.
• GET URL'lerinin okunabilirliği.

Notlar:

• Zaman dilimleri bir sunum katmanı problemidir! Kodunuzun çoğu saat dilimleriyle veya yerel saatle ilgilenmemeli, Unix zamanından geçiyor olmalıdır.
• İnsan tarafından okunabilir bir zamanı (örneğin, günlükler) saklamak istiyorsanız, bunu Unix zamanı yerine Unix zamanı ile birlikte depolamayı düşünün.

Her zaman UTC'yi kullanın:

Örneğin, DATETIME parametresini alan bir zamanlama bileşenim var. Bunu bir GET fiili kullanarak çağırdığımda, gelen parametre adımın schedDate olduğu aşağıdaki biçimi kullanıyorum.

Örnek:
https: // localhost / api / getScheduleForDate? SchedDate = 2003-11-21T01: 11: 11Z