API
REST API kullanarak Shipink'i kendi sisteminize entegre edin.
REST API ile kendi uygulamanızdan sipariş ve gönderi oluşturabilir, kargo durumunu sorgulayabilir ve depolarınızı yönetebilirsiniz.
Postman koleksiyonu örnek API isteklerini içerir.
İndirdiğiniz .json dosyasını Postman'a aktararak istekleri deneyebilirsiniz.
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ıdaki Craftgate test kartlarını kullanın.
Ana Akış
Token aldıktan sonra şu sırayla ilerleyin:
- Sipariş oluştur — müşteri ve ürün bilgilerini kaydedin
- Gönderi oluştur — sipariş için kargo etiketi oluşturun
- Gönderiyi takip et — teslimat durumunu izleyin
Yardımcı endpoint'ler:
- Kargo ücretleri — gönderi oluşturmadan önce kargo ücretini hesaplayın
- Depolar — gönderici adreslerini yönetin
- Adres Defteri — kayıtlı alıcı adreslerini yönetin
- Kargo Firmaları — kargo firmalarını listeleyin
Kimlik Doğrulama
POST /token dışındaki endpoint'ler kimlik doğrulama gerektirir. Shipink kullanıcı bilgilerinizle POST /token isteği gönderin. Aldığınız token'ı diğer isteklerde Authorization başlığına ekleyin:
Authorization: Bearer YOUR_ACCESS_TOKENToken oluşturma ve yenileme için Token sayfasına bakın.
Bu sayfa işinize yaradı mı?