API
REST API kullanarak Shipink'i kendi sisteminize entegre edin.
Shipink, sipariş, gönderi, kargo firması ve depo yönetimini Shipink panelini kullanmadan programatik olarak gerçekleştirmenizi sağlayan bir REST API sunar.
Postman Collection ile hemen başlayın — tüm endpoint'ler örnek isteklerle hazır.
.json dosyasını Postman'a import ederek API'yi keşfedebilir ve test edebilirsiniz.
Ortamlar
| API | Kayıt | |
|---|---|---|
| Production | https://api.shipink.io | app.shipink.io/signup |
| Test | https://api.dev.shipink.io | app.dev.shipink.io/signup |
Test Ortamına Başlangıç
- Kayıt olun — app.dev.shipink.io/signup adresinden üye olun
- Test kredi kartı ekleyin — test ortamı Craftgate test kartlarını kullanır. Listedeki başarılı test kart numaralarından herhangi birini kullanabilirsiniz.
- Token alın — test hesap bilgilerinizle
https://api.dev.shipink.ioüzerindePOST /tokenisteği gönderin
Örnek başarılı test kartları:
| Kart numarası | Banka | Kart markası |
|---|---|---|
4029400000000001 | T. Vakıflar Bankası | Visa |
5200170000000008 | T. Vakıflar Bankası | Mastercard |
6501700000000006 | T. Vakıflar Bankası | Troy |
5102210000000001 | Türk Ekonomi Bankası | Mastercard |
5230340000000001 | Yapı Kredi Bankası | Mastercard |
Test ortamında gerçek kredi kartları kullanılamaz. Yukarıda belirtilen Craftgate test kartlarını kullanmanız gerekmektedir.
Ana Akış
Tipik entegrasyon şu üç adımı izler:
- Sipariş oluştur — müşteri bilgilerini ve sepet kalemlerini kaydet
- Gönderi oluştur — o sipariş için kargo etiketi oluştur
- Gönderimi takip et — teslimat durumunu izle
Yardımcı endpoint'ler:
- Rates — gönderi oluşturmadan önce kargo ücretini hesapla
- Depolar — gönderici adreslerini yönet
- Adres Defteri — kayıtlı alıcı adreslerini yönet
- Kargo Firmaları — kargo firmaları, servisleri ve bağlı hesapları listele
Kimlik Doğrulama
Tüm endpoint'ler Authorization header'ında Bearer token gerektirir. Token almak için Shipink kullanıcı bilgilerinizle POST /token endpoint'ine istek gönderin.
Authorization: Bearer ACCESS_TOKEN'INIZToken oluşturma ve yenileme için Token sayfasına bakın.
Bu içerik nasıl?