Query file information using GetFile-Drive and Photo Service-Alibaba Cloud

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/file/get HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Badan permintaan.
drive_id	string	No	ID drive.	1
file_id	string	Yes	ID file.	9520943DC264
url_expire_sec	integer	No	Waktu kedaluwarsa file. Satuan: detik. Nilai yang valid: 10 hingga 14400.	100
fields	string	No	Bidang yang akan dikembalikan. Jika parameter ini diatur ke *, semua bidang file kecuali bidang yang harus ditentukan secara eksplisit akan dikembalikan. Jika hanya bidang tertentu yang diperlukan, Anda dapat menentukan bidang berikut: url, thumbnail, exif, cropping_suggestion, characteristic_hash, video_metadata, dan video_preview_metadata. Jika beberapa bidang diperlukan, pisahkan dengan koma (,). Contoh: url,thumbnail. Bidang investigation_info hanya dikembalikan jika ditentukan secara eksplisit. Secara default, semua bidang kecuali bidang yang harus ditentukan secara eksplisit akan dikembalikan.	url,thumbnail
thumbnail_processes	object	No	Konfigurasi Gambar mini. Maksimal lima Gambar mini dapat dikembalikan sekaligus. Nilainya berisi pasangan kunci-nilai. Anda dapat menyesuaikan kuncinya. URL Gambar mini dikembalikan berdasarkan kunci tersebut.
	ImageProcess	No	Aturan yang digunakan untuk menghasilkan Gambar mini dari gambar, video, dan dokumen.
share_id	string	No	ID share. Jika Anda ingin berbagi file, sertakan header `x-share-token` untuk otentikasi dalam permintaan dan tentukan share_id. Dalam kasus ini, `drive_id` tidak berlaku. Jika tidak, gunakan `Pasangan Kunci Akses` atau `token akses` untuk otentikasi dan tentukan `drive_id`. Anda harus menentukan salah satu dari `share_id` atau `drive_id`.	7JQX1FswpQ8

Elemen respons

Element	Type	Description	Example
	File	Parameter respons.

Contoh

Respons sukses

JSONformat

{
  "domain_id": "",
  "drive_id": "",
  "file_id": "",
  "name": "",
  "type": "",
  "content_type": "",
  "created_at": "",
  "updated_at": "",
  "description": "",
  "trashed_at": "",
  "file_extension": "",
  "mime_type": "",
  "mime_extension": "",
  "hidden": true,
  "size": 0,
  "starred": true,
  "status": "",
  "user_meta": "",
  "labels": [
    ""
  ],
  "upload_id": "",
  "parent_file_id": "",
  "crc64_hash": "",
  "content_hash": "",
  "content_hash_name": "",
  "download_url": "",
  "thumbnail": "",
  "category": "",
  "local_created_at": "",
  "local_modified_at": "",
  "revision_id": "",
  "investigation_info": {
    "status": 0,
    "suggestion": ""
  },
  "thumbnail_urls": {
    "key": ""
  },
  "image_media_metadata": {
    "time": "2006-01-02T15:04:05.000Z07:00",
    "width": 1920,
    "height": 1080,
    "location": "30.185453,120.218522",
    "country": "中国",
    "province": "浙江省",
    "city": "杭州市",
    "district": "滨江区",
    "township": "西兴街道",
    "address_line": "浙江省杭州市滨江区西兴街道江陵路",
    "image_tags": [
      {
        "confidence": 0.98,
        "parent_name": "运动",
        "name": "篮球",
        "tag_level": 3,
        "source": "一起打篮球",
        "centric_score": 0.877
      }
    ],
    "faces": "[{\"FaceId\":\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\",\"GroupId\":\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\",\"FaceConfidence\":0.999,\"Age\":13,\"AgeConfidence\":4,\"Gender\":\"female\",\"GenderConfidence\":1,\"Emotion\":\"none\",\"EmotionConfidence\":0.672,\"FaceAttributes\":{\"Mask\":\"none\",\"MaskConfidence\":0.894,\"Beard\":\"none\",\"BeardConfidence\":0.997,\"Glasses\":\"none\",\"GlassesConfidence\":0.999,\"Mouth\":\"close\",\"MouthConfidence\":0.937,\"Hat\":\"none\",\"HatConfidence\":0.998,\"HeadPose\":{\"Pitch\":10.684,\"Roll\":-10.707,\"Yaw\":-20.094},\"FaceBoundary\":{\"Width\":457,\"Height\":687,\"Top\":1324,\"Left\":1356}}}]",
    "faces_thumbnail": [
      {
        "face_id": "a9a66a86-73dd-4c95-8b79-1d8a49db5226",
        "face_group_id": "Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0",
        "face_thumbnail": "https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2"
      }
    ],
    "exif": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
    "image_quality": {
      "overall_score": 0.736
    }
  },
  "ex_fields_info": {
    "key": ""
  },
  "content_uri": "",
  "streams_info": {
    "key": {
      "crc64_hash": "",
      "size": 0,
      "content_hash": "",
      "content_hash_name": "",
      "download_url": "",
      "url": "",
      "thumbnail": ""
    }
  },
  "user_tags": {
    "key": ""
  },
  "revision_version": 0,
  "video_media_metadata": {
    "time": "2006-01-02T15:04:05.000Z07:00",
    "width": 1920,
    "height": 1080,
    "location": "30.185453,120.218522",
    "country": "中国",
    "province": "浙江省",
    "city": "杭州市",
    "district": "滨江区",
    "township": "西兴街道",
    "address_line": "浙江省杭州市滨江区西兴街道江陵路",
    "video_media_video_stream": [
      {
        "duration": "22.88",
        "bitrate": "108420",
        "code_name": "h264",
        "frame_count": "90"
      }
    ],
    "video_media_audio_stream": [
      {
        "duration": "7704.573000",
        "bit_rate": "129280",
        "code_name": "aac"
      }
    ]
  },
  "punish_flag": 0,
  "id_path": "",
  "name_path": "",
  "creator_type": "",
  "creator_id": "",
  "creator_name": "",
  "last_modifier_type": "",
  "last_modifier_id": "",
  "last_modifier_name": "",
  "dir_size_info": {
    "dir_count": 0,
    "file_count": 0
  },
  "trashed": true,
  "action_list": [
    ""
  ],
  "location": "",
  "semantic_result": {
    "semantic_similarity": 0.879,
    "document_contents": [
      {
        "element_contents": [
          {
            "type": "text",
            "content": "文本片段",
            "url": "http://aliyun.com",
            "time_range": [
              0
            ]
          }
        ]
      }
    ],
    "scene_contents": [
      {
        "time_range": [
          0
        ],
        "key_frames": [
          {
            "frame_time": 1000,
            "thumbnail_url": "http://aliyun.com"
          }
        ],
        "thumbnail_url": "http://aliyun.com"
      }
    ]
  },
  "sync_flag": true,
  "sync_device_flag": true,
  "origin_parent_file_id": "",
  "url": "",
  "custom_field_1": "",
  "custom_field_2": "",
  "auto_delete_left_sec": 0
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.